Images provided by @astro_uri on Instagram
Download umbra-<version>-windows-x64-setup.exe from the latest release and open it. Because the app is not yet signed, Windows SmartScreen may warn that it "protected your PC"; click More info, then Run anyway.
Keep the default install location. The installer lets you choose where to install Umbra, but keep the default (%LOCALAPPDATA%\Umbra). Automatic updates work by replacing Umbra's own folder, which is only possible where it can write without administrator rights — installing elsewhere (in particular Program Files) will break updates.
Download umbra-<version>-macos-arm64.pkg from the latest release and open it. Because the app is not yet notarized, macOS blocks it on first open with a message that it "could not verify" the package. To allow it:
- Click Done on the warning (not Move to Trash).
- Open System Settings → Privacy & Security.
- Scroll down to the Security section, find the message about
umbra-<version>-macos-arm64.pkg, and click Open Anyway. - Confirm Open Anyway and enter your password when prompted.
Open Umbra from Spotlight (press ⌘ + Space and type "Umbra") or from Launchpad. The installer puts it in the Applications folder inside your Home folder, which is not the Applications shortcut in the Finder sidebar (that one is the system-wide folder). Leave it there: moving it elsewhere, including into the system Applications folder, will break automatic updates.
Have questions, want to discuss solar eclipses, or get help with Umbra? Join our Discord server.
The source code for the algorithms is available if you want to run them without using the GUI. See the documentation for more information.