CLI tool
ninxsoft/Mist avatar
ninxsoft/Mist

Mist: the macOS installer super tool for admins and archivists

A Mac utility that automatically downloads macOS Firmwares / Installers.

5,256 stars233 forksSwiftMIT

At a glance

What is it?
Mist is Nindi Gill's MIT-licensed Mac utility that automatically downloads macOS firmwares and installers, listing every version Apple makes available and generating .ipsw files for Apple Silicon or .app, .dmg, bootable .iso and .pkg outputs for Intel Macs, with checksum validation, caching, retries and a companion CLI. A privileged helper handles the operations that need root, and AutoPkg recipes ship in the repository.
Who is it for?
Use Mist when you administer Macs and need a reliable pipeline for macOS installers and firmware, whether for imaging, virtualization or archiving versions before Apple retires them, and pair it with mist-cli when the workflow belongs in scripts. Skip it if you only ever install the one macOS version Software Update offers, since that path needs no tooling.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 85 days ago.
What is it written in?
Mainly Swift, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 30, 2026, and from our analysis. They are not legal advice.

Editorial analysis

An installer pipeline, not a download button

Mist, which styles itself the macOS Installer Super Tool, is a Mac utility that automatically downloads macOS firmwares and installers, and the plural matters, it addresses the whole family of artifacts Apple ships, restore firmware for Apple Silicon machines and full installers for Intel, through one interface. The project is created and maintained by Nindi Gill under the ninxsoft banner, is MIT licensed, and comes with a companion command-line tool, mist-cli, for driving the same machinery from scripts, plus a dedicated #mist channel on the Mac Admins Slack where the tool's actual audience congregates. The versioning is unhurried, v0.20.1 in October 2024, v0.30 in September 2025 and v0.40 on 2026-07-07, the same day as the last push, roughly annual releases for software whose subject changes once a year.

List first, export in four formats

Before any download, Mist lists all available macOS firmwares and installers, displaying names, versions, builds, release dates and sizes for each, with two filtering refinements that matter in practice, optionally showing beta versions of macOS, and filtering to the versions compatible with the Mac the app is running on, so a technician on old hardware is not offered bricks. The list itself is a first-class output, exportable as CSV, JSON, Property List or YAML, the YAML support built on the Yams library per the credits, which turns browsing into auditing, a fleet report of what could be installed is one export away. For environments that track installer availability over time, exporting the list on a schedule is a two-minute monitoring solution built from a feature most tools would treat as a menu.

Apple Silicon: ipsw files, verified by SHA-1

For Apple Silicon Macs the artifact is the Firmware Restore file, a .ipsw, and Mist treats it with the care firmware deserves, validating the SHA-1 checksum upon download so a truncated or corrupted restore image fails loudly instead of bricking an erase-and-restore later. The firmware URLs can be copied to the clipboard, a small feature aimed at workflows where the download itself happens elsewhere, such as a management server pulling the file directly. Metadata about available firmware comes from the IPSW Downloads API maintained by Callum Jones, an external dependency the credits acknowledge openly, which means Mist's firmware list is as current as that service's tracking of Apple's catalog.

Intel: app, dmg, bootable iso and a 12GB pkg

Intel Macs, using universal installers for macOS Big Sur and later, get the full production line, an Application Bundle, a Disk Image, a Bootable Disk Image for use with Parallels Desktop, UTM, VMware Fusion and VirtualBox, and a macOS Installer Package, with the package supporting Big Sur and newer at a payload the README punctuates with an exclamation mark, 12GB and up. Disk images and packages can optionally be codesigned, turning Mist into the front half of a distribution pipeline rather than a downloader, downloads are cached to speed up repeated builds, and the Chunklist checksums are validated on download, Apple's own integrity format for installer chunks. Failed downloads retry automatically, the forgiveness a twelve-gigabyte transfer over imperfect connections requires.

Four catalogs, three of them gated

Mist can be pointed at custom Software Update Catalogs, and the four documented sources map onto Apple's real segmentation, the Standard catalog shipping with macOS, the Customer Seed available through the AppleSeed Program, the Developer Seed from the Apple Developer Program, and the Public Seed from the Apple Beta Software Program. The README attaches the correct warning, seed catalogs may contain beta or unreleased versions of macOS, and you should be a member of the program before proceeding, which is both an honesty note and a terms-of-service acknowledgment. For administrators who legitimately need pre-release builds for compatibility testing, having the seed catalogs one toggle away, with beta display itself optional in the list view, removes the manual catalogURL surgery this task used to require.

A privileged helper, Sparkle and AutoPkg recipes

The repository layout tells the operational story, a MistHelperTool directory with its com.ninxsoft.mist.helper.plist launchd definition, the privileged helper built on the Blessed and SecureXPC libraries credited in the README, which is how the app performs root-requiring work without running itself as root. Updates flow through Sparkle, the standard macOS auto-update framework, with an appcast.xml committed for the feed. Most tellingly for the audience, the repository ships AutoPkg recipes, Mist.dmg.recipe.yaml and Mist.pkg.recipe.yaml, so Mac admins can pull Mist itself into their automated software distribution, the tool for getting installers distributed by the tooling that distributes software. The README also notes that Full Disk Access may need to be granted via System Settings depending on what Mist downloads.

Swift 6.3, Xcode 26 and a Homebrew cask

Building from source requires Swift 6.3.1 and Xcode 26.0, and the compiled app runs on macOS Monterey 12.0 and later, a support window reaching back far enough to install the OS the tool itself requires, a bootstrap consideration installer tools must respect. Distribution is the standard pair, the GitHub releases page for direct downloads and a Homebrew cask, brew install --cask mist, for the Mac-standard path, with the credits section completing the picture, JP Simard for Yams, Josh Kaplan for Blessed and SecureXPC, the Sparkle Project, and Callum Jones for the IPSW Downloads API. The license text is MIT in full, copyright 2021 through 2026, and the CHANGELOG tracks each annual release, the posture throughout being that of a maintained utility by an author who uses it himself.

Editorial conclusion

Use Mist when you administer Macs and need a reliable pipeline for macOS installers and firmware, whether for imaging, virtualization or archiving versions before Apple retires them, and pair it with mist-cli when the workflow belongs in scripts. Skip it if you only ever install the one macOS version Software Update offers, since that path needs no tooling. Verify first whether your target Macs need firmware or installer artifacts, grant Full Disk Access when the app requests it, join the relevant seed program before selecting its catalog, and note the .pkg generation requirement of Big Sur or newer.

Frequently asked questions

What is ninxsoft Mist?

Mist is a free Mac utility by Nindi Gill that automatically downloads macOS firmwares and installers. It lists every version available for download with metadata, and produces .ipsw firmware files for Apple Silicon or .app, .dmg, bootable .iso and .pkg outputs for Intel Macs.

How do you download Mist from GitHub?

Open the releases page at github.com/ninxsoft/Mist/releases and grab the latest version, or install it with Homebrew using brew install --cask mist. The companion command-line tool, mist-cli, lives in a separate repository.

Where can I download the macOS High Sierra installer?

Mist lists all macOS firmwares and installers Apple makes available for download, with names, versions, builds and dates, so the list shows what is obtainable for older Intel versions. Its installer generation features are documented as universal builds for macOS Big Sur and later, and the exportable list clarifies availability for anything older.

Official sources

  1. Issues
  2. License: MIT
  3. ninxsoft/Mist on GitHub
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/ninxsoft-mist.svg)](https://hysenlabs.com/projects/ninxsoft-mist)