🍺 A Homebrew tap for building and installing the Hatari emulator with the HRDB debugger, packaged with macOS .app bundles and CLI wrappers.

• This tap builds from a fork of Hatari, a versatile Atari ST/STE/TT/Falcon emulator, which includes the HRDB debugger maintained and extended by @tattlemuss.
• The Homebrew tap itself — including macOS integration, wrapper scripts, and application icons — is maintained by @kareandersen.

The hatari binary has been renamed to hatari-hrdb, and the application bundle to Hatari-HRDB.app, to allow coexistence with a standard Hatari installation.

On the command line, hatari-hrdb runs a wrapper script located inside the bundle. This allows arguments to be passed correctly and avoids a known crash related to how SDL handles the invisible mouse cursor on macOS.

The Hatari project builds a native macOS GUI using platform frameworks that depend on the full Xcode.app, not just the Command Line Tools.

If you've installed or updated Xcode recently, or are building for the first time, make sure to initialize it:

sudo xcode-select --switch /Applications/Xcode.app
sudo xcodebuild -runFirstLaunch

Without this step, the build may fail due to missing SDKs or uninitialized permissions.

brew tap kareandersen/homebrew-hatari-hrdb
brew install --HEAD hatari-hrdb

⚠️ Note: This builds from source. You’ll need Xcode command-line tools and a Homebrew environment set up.

After install, app bundles are available in:

$(brew --prefix)/opt/hatari-hrdb/Applications/hatari-hrdb/

To make them accessible in Finder:

# Link to your user Applications folder (~/Applications)
link-hatari-hrdb.sh

# Or to the system-wide Applications folder (requires sudo)
sudo link-hatari-hrdb.sh --system

These commands are added to your path:

• hatari-hrdb – launches Hatari via its .app bundle wrapper (not a raw binary).
• hrdb – launches the standalone HRDB debugger.

To remove the symlinks created above:

unlink-hatari-hrdb.sh                # Unlink from ~/Applications
sudo unlink-hatari-hrdb.sh --system  # Unlink from /Applications

• App icons are generated and embedded during the build.
• Launching from CLI preserves GUI functionality.
• Tested on macOS 15 with Apple Silicon and Intel. --

This tap is maintained by @kareandersen. Upstream HRDB fork by @tattlemuss.