hatari - Atari ST emulator

hatari [options] [diskimage]

Hatari is an Atari ST emulator for Linux, FreeBSD, BeOS and other Systems which are supported by the SDL library.

With hatari one can run games, demos or applications written for Atari ST. 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

activate joystick emulation via cursor keys

--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)

--memsize x

set amount of emulated RAM

x=0 for 512K,

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

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

All other keys on the keyboard act as the normal Atari ST keys so pressing SPACE on your PC will result in an emulated press of the SPACE key on the ST. The following keys have special meanings:

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 main program documentation, usually in /usr/share/doc/.

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

This manual page was written by Marco Herrn <marco@mherrn.de>, for the Debian project and later modified by Thomas Huth to suit the latest version of Hatari.