Install Ferrum Launcher on macOS

What you need

A Mac with Apple Silicon. The launcher downloads builds from the public Amygdal-doo/ferrum-releases repository on GitHub, so it needs to reach GitHub.

Option A: one line in Terminal

curl -fsSL https://raw.githubusercontent.com/Amygdal-doo/ferrum-releases/main/install.sh | bash

The script picks the newest launcher-v* release for your CPU, checks its .sha256, installs into /Applications (or ~/Applications if that isn't writable) and opens it. Files downloaded with curl aren't quarantined, so macOS doesn't ask about them.

Option B: the disk image

Download FerrumLauncher-<version>-aarch64.dmg with Download for macOS, or pick it from the newest launcher-v… release on GitHub.
Open it and drag Ferrum Launcher onto Applications.
Open Ferrum Launcher. There is nothing to sign in to.

Releases are signed with the AMYGDAL d.o.o. Sarajevo Developer ID and notarized by Apple, so macOS opens them without a warning.

Install the apps

Click an app in the launcher's overview, then Install. The launcher downloads the build with a progress bar you can cancel, checks it against the published .sha256 and refuses to install on a mismatch. It then publishes the active version as ~/Applications/Ferrum/<App>.app, so Launchpad and Spotlight find it, and links its executables into ~/.ferrum/bin.

To run those executables from any shell, add the folder to your PATH:

echo 'export PATH="$HOME/.ferrum/bin:$PATH"' >> ~/.zshrc

Turning on a shell command in the launcher does this for you.

Updates and rollback

The launcher checks for new releases on startup and every 6 hours (change it in Settings). Apps with a newer release get an Update to vX button.
The launcher updates itself in place: Update Launcher to vX downloads the new version, replaces the app and restarts it.
To roll back, pick an older version in an app's version list and click Activate.
The last 3 versions of each app are kept (Settings → Versions to keep; 0 keeps all). The active version is never removed.
Every app follows the Alpha channel by default. Switch an app to Beta or Stable on its page.

Uninstall

Remove one version with Remove in its row. Removing an app's last version also deletes its app bundle and command-line links. To remove everything:

rm -rf "/Applications/Ferrum Launcher.app" ~/Applications/Ferrum ~/.ferrum \
       ~/Library/Application\ Support/dev.Ferrum.FerrumLauncher

Where files live

Launcher: /Applications/Ferrum Launcher.app
Active apps: ~/Applications/Ferrum/<App>.app
Installed versions: ~/Library/Application Support/dev.Ferrum.FerrumLauncher/apps/<app>/<version>/
Settings and state: ~/Library/Application Support/dev.Ferrum.FerrumLauncher/state.json
Command-line links: ~/.ferrum/bin/

Windows and Linux installers are listed on the download page once they ship.