HATARI(1)HATARI(1)NAME
hatari - Atari ST(e) emulator
SYNOPSIS
hatari [options] [diskimage]
DESCRIPTION
Hatari is an Atari ST(e) 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 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 implemen‐
tation of TOS is shipped with hatari. Since it is not yet fully compat‐
ible 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.
OPTIONS
Hatari options are split into several categories:
General options-h, --help
Print command line options and terminate
-v, --version
Print version information and terminate
--confirm-quit <bool>
Whether Hatari confirms quitting
-c, --configfile <filename>
use the mentioned file as configuration file instead of
~/.hatari.cfg
Display options-m, --mono
Start in monochrome mode instead of color
--monitor <x>
Select monitor type (x = mono/rgb/vga/tv)
-f, --fullscreen
Start the emulator in fullscreen mode
-w, --window
Start the emulator in window mode
-z, --zoom <x>
Zoom low resolution (1=no, 2=yes)
--frameskips <x>
Skip <x> frames after each displayed frame to accelerate emula‐
tion (0 <= x <= 8)
--borders <bool>
Show screen borders (for overscan demos etc)
--spec512 <x>
Hatari uses this threshold to decide when to render a screen
with the slower but more accurate Spectrum512 screen conversion
functions (0 <= x <= 512, 0=disable)
--bpp <bool>
Force given internal bitdepth (x=8/16/32, x=0 for autodetec‐
tion). 8-bit color depth may be useful for older host computers
VDI options--vdi-planes <x>
Use extended VDI resolution with bit depth <x> (x = 1, 2 or 4)
--vdi-width <w>
Use extended VDI resolution with width <w> (384 <= w <= 1024)
--vdi-height <h>
Use extended VDI resolution with height <h> (200 < h <= 768)
Devices options-j, --joystick <port>
Emulate joystick with cursor keys in given port (0-5)
--printer <file>
Enable printer support and write data to <file>
--midi <filename>
Enable experimental MIDI output to the mentioned file
--rs232 <filename>
Enable experimental RS232 emulation via the mentioned
file/device
Disk options-d, --harddrive <dir>
Use <dir> as an emulated hard disk
--acsi <file>
Emulate ACSI hard disk with an image <file>
--slowfdc <bool>
slow down FDC emulation (needed to make some games and demos
work)
Memory options-s, --memsize <x>
Set amount of emulated RAM, x = 1 to 14 MiB, or 0 for 512 KiB
-t, --tos <imagefile>
Specify TOS ROM image to use
--cartridge <imagefile>
Use ROM cartridge image <file> (only works if GEMDOS HD emula‐
tion and extended VDI resolution are disabled)
--memstate <file>
Load memory snap-shot <file>
CPU options--cpulevel <x>
Specify CPU (680x0) to use (use x >= 1 with EmuTOS or TOS >=
2.06 only!)
--cpuclock <x>
Set the CPU clock (8, 16 or 32 Mhz)
--compatible <bool>
Use a more compatible but slower 68000 CPU mode
Misc system options--machine <x>
select machine type (x = st, ste, tt or falcon)
--blitter <bool>
Enable blitter emulation
--dsp <x>
Falcon DSP emulation (x = none, dummy or emu)
--sound <x>
Sound quality (off/low/med/hi (off=faster))
--keymap <file>
load keyboard mapping from <file>
Debug options-D, --debug <bool>
activate the simple builtin debugger
--log <file>
Save log to <file> (can also be "stdout" or "stderr")
--trace <trace1,...>
Activate debug traces, see --trace help for tracing options
COMMANDS
The shortcut keys can be configured in the configuration file. The
default settings are:
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
AltGr + k
save memory snapshot
AltGr + l
load memory snapshot
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
Emulated Atari ST keyboard
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.
SEE ALSO
The main program documentation, usually in /usr/share/doc/.
The homepage of hatari: http://hatari.sourceforge.net
FILES
/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 config‐
uration file.
AUTHOR
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.
Hatari 2008-03-14 HATARI(1)