MIST - macOS Installer Super Tool
A Mac command-line tool that automatically downloads macOS Installers / Firmwares:
Features
- List all available macOS Installers / Firmwares available for download:
- Display names, versions, builds, sizes and release dates
- Optionally export list as CSV, JSON, Property List or YAML
- Download an available macOS Installer / Firmware:
- For Intel based Macs:
- Generate an Application Bundle (.app)
- Generate a Disk Image (.dmg)
- Generate a macOS Installer Package (.pkg)
- Supports macOS Big Sur packages with a massive 12GB+ payload!
- Optionally codesign Disk Images and macOS Installer Packages
- Check for free space before attempting any downloads or installations
- Optionally specify a custom catalog URL, allowing you to list and download macOS Installers from the following:
- Customer Seed - AppleSeed Program
- Developer Seed - Apple Developer Program
- Public Seed - Apple Beta Software Program
- For Apple Silicon Macs:
- Download a Firmware Restore file (.ipsw)
- Validates the SHA-1 checksum upon download
- For Intel based Macs:
Usage
OVERVIEW: macOS Installer Super Tool.
Automatically download macOS Installers / Firmwares.
USAGE: mist <subcommand>
OPTIONS:
-h, --help Show help information.
SUBCOMMANDS:
list List all macOS Installers / Firmwares available to download.
download Download a macOS Installer / Firmware.
version Display the version of mist.
See 'mist help
'
for detailed help.
Examples
# List all available macOS Firmwares for Apple Silicon Macs:
mist list --platform "apple"
# List all available macOS Installers for Intel Macs:
mist list --platform "intel"
# List only macOS Big Sur Installers for Intel Macs:
mist list "macOS Big Sur" --platform "intel"
# List only the latest macOS Big Sur Installer for Intel Macs:
mist list "macOS Big Sur" --platform "intel" --latest
# List + Export macOS Installers to a CSV file:
mist list --export "/path/to/export.csv"
# List + Export macOS Installers to a JSON file:
mist list --export "/path/to/export.json"
# List + Export macOS Installers to a Property List:
mist list --export "/path/to/export.plist"
# List + Export macOS Installers to a YAML file:
mist list --export "/path/to/export.yaml"
# Download the latest macOS Big Sur Firmware for
# Apple Silicon Macs, with a custom name:
mist download "Big Sur" --platform "apple" --firmware-name "Install %NAME %VERSION%-%BUILD%.ipsw"
# Download the latest macOS Big Sur Installer for Intel Macs:
mist download "Big Sur" --platform "intel" --application
# Download a specific macOS Installer version for Intel Macs:
mist download "11.4" --application
# Download a specific macOS Installer version for
# Intel Macs, with a custom name:
mist download "11.4" --application --application-name "Install %NAME %VERSION%-%BUILD%.app"
# Download a specific macOS Installer version
# and generate a Disk Image with a custom name:
mist download "11.4" --image --image-name "Install %NAME %VERSION%-%BUILD%.dmg"
# Download a specific macOS Installer build and generate
# a codesigned Disk Image output to a custom directory:
mist download "19H15" \
--image \
--image-signing-identity "Developer ID Application: Name (Team ID)" \
--output-directory "/path/to/custom/directory"
# Download the latest macOS Big Sur Installer and generate
# an Installer Application bundle, a Disk Image and
# macOS Installer Package, both with custom names, codesigned,
# output to a custom directory:
mist download "Big Sur" \
--application \
--application-name "Install %NAME% %VERSION%-%BUILD%.app" \
--image \
--image-name "Install %NAME% %VERSION%-%BUILD%.dmg" \
--image-signing-identity "Developer ID Application: Name (Team ID)" \
--package \
--package-name "Install %NAME% %VERSION%-%BUILD%.pkg" \
--package-identifier "com.mycompany.pkg.install-%NAME%" \
--package-signing-identity "Developer ID Installer: Name (Team ID)" \
--output-directory "/path/to/custom/directory"
Build Requirements
- Swift 5.4.
- Runs on macOS Yosemite 10.10 and later.
Download
Grab the latest version of Mist from the releases page.
Credits / Thank You
- Project created and maintained by Nindi Gill (ninxsoft).
- Apple (apple) for Swift Argument Parser, used to perform command line argument and flag operations.
- JP Simard (jpsim) for Yams, used to export YAML.
- Callum Jones (cj123) for IPSW Downloads API, used to determine macOS Firmware metadata.
Version History
-
1.5
- Added List search support
mist listto filter on results--latestto filter the latest (first) match found--quietto suppress verbose output--output-typeto specify a custom output type
- Added progress indicators
- Displays current and total download amounts
- Displays overal percentage downloaded
- macOS Firmwares and Installers will fail to download if they already exist
- Use
--forceto overwrite this behaviour
- Use
- Faster macOS Firmwares list retrieval time
- Faster macOS Installers list retrieval time
- Replaced SANITY CHECKS headers with more inclusive INPUT VALIDATION
- Fixed a bug with partial string matching when searching for downloads
- Improved error handling and messaging
- Added List search support
-
1.4
- Support for downloading macOS Firmware (IPSW) files
- Shasum is validated upon download
- Moved list, download and version options to subcommands:
mist --listis nowmist listmist --downloadis nowmist downloadmist --versionis nowmist version- See
mistfor detailed help--help
- Renamed
--list-exportoption to--export - Re-added
--applicationoutput option, back by popular demand! - Removed short flags for output options due to naming collisions:
- Removed
-afor--application - Removed
-ifor--image - Removed
-pfor--package
- Removed
- Lists now display / export total size
- More verbose output for input validation
- Support for downloading macOS Firmware (IPSW) files
-
1.3.1
- Fixed bug where SUCatalog files were not being parsed correctly
-
1.3
- Removed
--name,--mac-os-versionand--buildoptions,--downloadnow supports all three - Removed
--list-formatoption and renamed--list-pathto--list-export, file extension determines export type - Removed
--applicationand--zipoptions - Added
--catalogURL - Added
--temporary-directoryoption - Added
--keychainoption - Added free space check before downloads are initiated
- Support for building hardware specific installers on all Macs
- macOS name is now determined from the distribution files, no longer hardcoded
- CSV cells with spaces now display correctly
- Better input validation before downloads are initiated
- Cleanup of standard output messaging (less verbose)
- Removed download progress output
- General code refactoring
- Removed
-
1.2
- Downloads now show progress: current + total download sizes and % completed
- Mist will now create the
--outputdirectory if it does not exist
-
1.1.1
--applicationand--zipflags are now detected correctly
-
1.1
- Specify custom catalog seeds: Customer, Developer and Public
- This allows downloading macOS Install Betas
- Output the macOS Installer application bundle to a custom directory
- Generate a ZIP archive of the macOS Installer application bundle
- Checks for free space before attempting any downloads and installations
- Cleaned up CLI argument flags, options, and formatting
- Specify custom catalog seeds: Customer, Developer and Public
-
1.0
- Initial release
License
Copyright © 2021 Nindi Gill
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
86 Dec 15, 2022
10 Aug 20, 2022
32 Nov 17, 2022
131 Nov 14, 2022
1.1k Dec 23, 2022
3k Dec 30, 2022
21 Sep 13, 2022
15 Nov 24, 2022
2.3k Jan 9, 2023
36 Dec 23, 2022
523 Dec 29, 2022
14 Jan 8, 2023
3 Jul 15, 2022
7 Apr 27, 2022
3 Dec 16, 2021
0 Jan 25, 2022
10 Feb 17, 2022
107 Dec 10, 2022
36 Nov 25, 2022