With hatari one can run games, demos or applications written for Atari ST or Atari STE. It supports the commonly used *.st and *.msa disk images and hard disk emulation.

To run the emulator a TOS ROM image is needed. EmuTOS, a free implementation of TOS is shipped with hatari. Since it is not yet fully compatible with the original TOS some programs won't run correctly with this. Because of this it is recommended to use a TOS ROM from a real Atari.

-h, --help

print command line options and terminate

-v, --version

print version information and terminate

-m, --mono

start the emulated Atari ST in monochrome resolution

-f, --fullscreen

start the emulator in fullscreen mode

-w, --window

start the emulator in window mode

-j, --joystick <port>

emulate ST joystick in <port> 0 or 1 with keyboard

--nosound

disable sound (makes emulation faster)

--frameskip

drop every second frame (accelerates emulation)

-D, --debug

activate the simple builtin debugger

--slowfdc

slow down FDC emulation (needed to make some games and demos work)

-d, --harddrive <dir>

use <dir> as an emulated hard disk

--hdimage <imagefile>

emulate hard disk with an image file

--tos <imagefile>

specify TOS ROM image to use

--cartridge <imagefile>

use ROM cartridge image <file> (only works if GEMDOS HD emulation and extended VDI resolution are disabled)

-s, --memsize x

set amount of emulated RAM x=0 for 512K, and x=1, x=2 or x=4 for 1, 2 or 4 MB

--cpulevel x

specify CPU (680x0) to use (TOS 2.06 only!!)

--compatible

use a more compatible but slower 68000 CPU mode

--blitter

enable blitter emulation

--vdi

use extended VDI resolution

--printer

enable experimental printer support

--midi <filename>

enable experimental MIDI output to the mentioned file

--rs232 <filename>

enable experimental RS232 emulation via the mentioned file/device

-c, --configfile <filename>

use the mentioned file as configuration file instead of ~/.hatari.cfg

--machine <x>

select machine type (x = st or ste)

--keymap <file>

load keyboard mapping from <file>

AltGr + a

record animation

AltGr + g

grab a screenshot

AltGr + i

boss key: leave full screen mode and iconify window

AltGr + j

activate joystick emulation via cursor keys

AltGr + m

(un-)lock the mouse into the window

AltGr + r

(warm) reset the ST

AltGr + c

coldreset the ST (same as the original power switch)

AltGr + s

enable/disable sound

AltGr + q

quit the emulator

AltGr + x

toggle normal/max speed

AltGr + y

enable/disable sound recording

F11

toggle between fullscreen and windowed mode

F12

activate the hatari command GUI You may need to hold SHIFT down while in windowed mode.

Pause

will go to the debugger if it was activated with the --debug option

Alt

will act as the ST's ALTERNATE key

left Ctrl

will act as the ST's CONTROL key

Page Up

will emulate the ST's HELP key

Page Down

will emulate the ST's UNDO key

AltGr will act as Alternate as well as long as you do not press it together with a Hatari hotkey combination.

The right Ctrl key is used as the fire button of the emulated joystick when you turn on joystick emulation via keyboard.

The cursor keys will act as the cursor keys on the Atari ST as long as joystick emulation via keyboard has been turned off.

The homepage of hatari: http://hatari.sourceforge.net

/etc/hatari.cfg (or /usr/local/etc/hatari.cfg)

the global configuration file of Hatari

~/.hatari.cfg

the user's personal Hatari configuration file

tos.img

The TOS ROM image will be loaded from the data directory of Hatari unless it is specified on the command line or the configuration file.