# Install hatari with Homebrew, apt, dnf, MacPorts, Nix, pacman

Atari ST/STE/TT/Falcon emulator. Version 2.6.1 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:hatari
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install hatari
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install hatari
```

  Evidence: MacPorts ports tree: emulators/hatari/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install hatari
```

  Evidence: Debian stable package indexes: hatari from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install hatari
```

  Evidence: Fedora Rawhide package metadata: hatari from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#hatari
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ha/hatari/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S hatari
```

  Evidence: Arch Linux sync databases: hatari from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:hatari
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/hatari>
- **Version:** 2.6.1
- **Source summary:** Atari ST/STE/TT/Falcon emulator
- **Homepage:** <https://www.hatari-emu.org/>
- **Repository:** <https://framagit.org/hatari/releases>
- **Upstream docs:** <https://www.hatari-emu.org/docs.html>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://framagit.org/hatari/releases/-/raw/main/v2.6.1/hatari-2.6.1.tar.bz2>
- **Last updated:** 2026-06-18T02:28:58-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- atari-convert-dir (cli)
- atari-hd-image (cli)
- gst2ascii (cli)
- hatari (cli)
- hatari-prg-args (cli)
- hatari_profile (cli)
- hmsa (cli)
- zip2st (cli)
- atari-convert-dir (alias)
- atari-hd-image (alias)
- gst2ascii (alias)
- hatari (alias)
- hatari-prg-args (alias)
- hatari_profile (alias)
- hmsa (alias)
- zip2st (alias)

## Dependencies

- libpng
- sdl2-compat

## Build dependencies

- cmake

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.6.1
- Package-manager updated: 2026-06-18
- Local data: ok
- Upstream repository: https://www.hatari-emu.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Hatari is an open-source Atari ST/STE/TT/Falcon emulator for Unix-like systems, macOS, Windows, and other SDL-supported platforms. It is historically significant because it targets hardware-faithful emulation for games, demos, GEM applications, and retro-development workflows rather than only a comfortable desktop shell.

The project has a long-lived release record: the official site marked Hatari v0.01 as twenty years old in March 2021, placing the project's origin in 2001. Its package-manager presence gives retro-computing users a maintained route to an emulator whose accuracy depends on many small CPU, video, sound, disk, debugger, and machine-model fixes.

### Project history

The official About page describes Hatari as an Atari ST/STE/TT/Falcon emulator and explains the design goal: emulate ST hardware closely enough to run old ST games and demos. It also notes support for STE hardware, TT and Falcon hardware such as Videl and DSP 56001, hard-disk images, host-directory mounting, joystick emulation, and the need for a TOS image or EmuTOS.

Hatari's release history shows steady expansion from ST/STE emulation toward more accurate TT and Falcon behavior. Entries for the 1.x and 2.x lines repeatedly mention CPU core work, WinUAE-derived CPU updates for Falcon accuracy, TT video, DSP, MMU, FPU, Videl, SCSI, SCC, MIDI, sound, debugger, profiler, and demo/game compatibility fixes.

The project's hosting history also reflects older open-source infrastructure. The news page records a move from BerliOS to tuxfamily.org in 2011, a source repository switch from Mercurial to Git in 2019, and a move to Framagit and the hatari-emu.org site in 2025.

### Adoption history

Hatari adoption sits in the retro-computing and demo-scene ecosystem. Users install it to run Atari ST software, inspect old programs, test demos and games, use a built-in debugger, and develop or debug software for ST-family machines without relying on original hardware.

The official site notes packages and binaries are not available for all architectures, which helps explain the role of OS package managers. Homebrew, Debian, Ubuntu, Fedora, Arch, Nix, and MacPorts entries make Hatari available through familiar update channels while still pointing users to TOS/EmuTOS requirements and project documentation.

The emulator's compatibility story is cumulative. Release notes repeatedly name fixed demos, games, and programs, which is how emulators earn adoption in preservation communities: each hardware edge case can unlock a specific title or production.

### How it is used

Typical use is graphical or command-line: run hatari with a TOS or EmuTOS image, select an Atari machine profile, mount disk images or host directories, configure video/sound/input, and launch Atari software. Companion tools in the package help convert directories, create hard-disk images, inspect GST symbols, profile code, and manage disk-image formats.

Hatari is also a developer tool. The debugger manual describes a built-in debugging interface for analyzing code running in the emulated machine, and the release notes emphasize debugger and profiler improvements alongside end-user emulation fixes.

### Why package nerds care

Hatari is interesting to package maintainers because it bridges old machine ROM requirements with modern SDL-based distribution. The package can ship the emulator and tools, but users still need a legal TOS image or EmuTOS replacement, so documentation and runtime expectations matter.

It is also a reminder that emulator packages are living compatibility databases. Seemingly obscure changelog entries about DMA sound, MFP timers, SCSI request handling, Videl refresh rates, MMU bus errors, and Falcon DSP behavior can be the difference between a demo working or failing.

For Homebrew specifically, Hatari is a desktop-style retro package that also installs command-line helper utilities, so it sits between games, preservation, development, and media tooling.

### Timeline

- 2001: Hatari v0.01 was created, according to the project's twentieth-birthday news post.
- 2011: The project announced a move from BerliOS to tuxfamily.org and a Mercurial repository.
- 2012: The 1.6.x releases emphasized Falcon DSP/CPU/MMU/FPU and debugger improvements.
- 2015: Version 1.9.0 included a major CPU update for Falcon emulation based on WinUAE CPU work and added TT-RAM support.
- 2016: Version 2.0.0 added SDL2 support and a single CPU core path for ST, STE, TT, and Falcon.
- 2019: The source repository switched from Mercurial to Git.
- 2025: The project moved to Framagit and the hatari-emu.org site; version 2.6.0 continued machine, debugger, video, serial, SCSI, and compatibility work.

### Related projects

- EmuTOS is the free TOS replacement recommended by Hatari when users cannot supply an Atari TOS image.
- SDL is the portability layer Hatari uses for supported host systems.
- WinUAE CPU work influenced Hatari's more accurate Falcon CPU emulation.
- Atari ST, STE, TT, Falcon, GEMDOS, TOS, Videl, YM2149, DSP 56001, SCSI, and SCC hardware/software concepts recur throughout Hatari documentation and releases.

### Sources

- <https://formulae.brew.sh/formula/hatari>
- <https://framagit.org/hatari/hatari>
- <https://www.hatari-emu.org/>
- <https://www.hatari-emu.org/doc/debugger.html>
- <https://www.hatari-emu.org/doc/emutos.txt>
- <https://www.hatari-emu.org/docs.html>
- <https://www.hatari-emu.org/news.html>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/hatari.cfg, /usr/local/etc/hatari.cfg, ~/.config/hatari/hatari.cfg
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hatari
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Requirements:** xcode
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - hatari - 2.5.0+dfsg-1+b1: normalized package name match | Debian stable package indexes: hatari from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Emulator for the Atari ST, STE, TT, and Falcon computers | http://hatari.tuxfamily.org/
- Nix - hatari: normalized package name match | nixpkgs package indexes: pkgs/by-name/ha/hatari/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - hatari - 2.4.1+dfsg-2build2: normalized package name match | Ubuntu 24.04 LTS package indexes: hatari from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Emulator for the Atari ST, STE, TT, and Falcon computers | http://hatari.tuxfamily.org/
- dnf - hatari - 2.6.1-3.fc45: normalized package name match | Fedora Rawhide package metadata: hatari from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | An Atari ST/STE/TT/Falcon emulator suitable for playing games | https://www.hatari-emu.org/
- dnf - hatari-ui - 2.6.1-3.fc45: normalized package name match | Fedora Rawhide package metadata: hatari-ui from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | External user interface for Hatari | https://www.hatari-emu.org/
- pacman - hatari - 2.6.1-1: normalized package name match | Arch Linux sync databases: hatari from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | An Atari ST and STE emulator | https://www.hatari-emu.org/
- MacPorts - hatari: normalized package name match | MacPorts ports tree: emulators/hatari/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Game and emulation packages](https://www.automicvault.com/pkg/game-emulation-tools/) - Matched game or emulation metadata.
- [libpng](https://www.automicvault.com/pkg/brew/libpng/) - Runtime dependency declared by Homebrew.
- [sdl2-compat](https://www.automicvault.com/pkg/brew/sdl2-compat/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [mgba](https://www.automicvault.com/pkg/brew/mgba/) - Shares av.db curated category or tags: cli, emulator, emulators, games.
- [dosbox-staging](https://www.automicvault.com/pkg/brew/dosbox-staging/) - Shares av.db curated category or tags: cli, emulator, games, retro-computing.
- [dosbox-x](https://www.automicvault.com/pkg/brew/dosbox-x/) - Shares av.db curated category or tags: cli, emulator, games, retro-computing.
- [openmsx](https://www.automicvault.com/pkg/brew/openmsx/) - Shares av.db curated category or tags: cli, emulator, games, retro-computing.
- [pc6001vx](https://www.automicvault.com/pkg/brew/pc6001vx/) - Shares av.db curated category or tags: cli, emulator, games, retro-computing.
- [quasi88](https://www.automicvault.com/pkg/brew/quasi88/) - Shares av.db curated category or tags: cli, emulator, games, retro-computing.
- [atari800](https://www.automicvault.com/pkg/brew/atari800/) - Shares av.db curated category or tags: cli, emulator, games.
- [blastem](https://www.automicvault.com/pkg/brew/blastem/) - Shares av.db curated category or tags: cli, emulator, games.

## Combined YAML source

View the package source record on GitHub. [combined/hatari.yml](https://github.com/automic-vault/db/blob/main/combined/hatari.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
