IntuneBrew  by ugurkocde

PowerShell tool for automating macOS app deployment to Microsoft Intune

Created 1 year ago
255 stars

Top 98.8% on SourcePulse

GitHubView on GitHub
Project Summary

Summary IntuneBrew is a PowerShell tool automating macOS application deployment in Microsoft Intune. It simplifies the process by leveraging Homebrew's metadata to download, repackage, and upload apps with icons and metadata, significantly reducing manual effort for IT administrators managing macOS fleets.

How It Works The tool queries Homebrew's JSON API for app data, downloads installers, repackages them into .pkg format, and uploads them to Intune. It supports multiple secure authentication methods for Microsoft Graph API, including Managed Identities, Entra ID App Registrations (Client Secret/Certificate), and configuration files for non-interactive use. Features include version checking, automatic updates, retry logic, and progress monitoring.

Quick Start & Requirements Installation is typically via Install-Script IntuneBrew -Force. Prerequisites include PowerShell 7+, Microsoft Intune, and an Azure AD tenant with necessary permissions. Authentication setup varies. Direct download links or detailed quick-start guides are absent; the "Issues" page is the primary support channel.

Highlighted Details

  • Automates macOS app uploads to Intune, supporting .dmg and .pkg formats.
  • Features robust version management, automatic icon integration (via Brandfetch), and secure authentication.
  • Includes duplicate detection, bulk uploads, retry mechanisms, and real-time progress monitoring.
  • Utilizes a GitHub Actions CI/CD pipeline for automated app validation, packaging, icon fetching, version updates, and uninstall script generation.
  • Maintains an extensive, community-driven list of supported applications.

Maintenance & Community Contributions are welcomed via Pull Requests. Active development is indicated by automated CI/CD workflows (CVE checking, app categorization). The "Issues" page serves as the primary support channel for bug reports and feature requests.

Licensing & Compatibility Released under the permissive MIT License, IntuneBrew offers broad compatibility for commercial use and integration into closed-source environments.

Limitations & Caveats Support for missing applications requires issue requests. Secure credential handling is critical; avoid committing secrets and plan for rotation. Azure Automation sandbox memory limits (1GB) may necessitate MaxAppsPerRun configuration for large batches. Some applications are marked with '❌', indicating potential issues or specific handling requirements not detailed in the README.

Health Check
Last Commit

22 hours ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
16
Star History
6 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.