Man Linux: Main Page and Category List


       hatari - Atari ST/STE/TT/Falcon emulator


       hatari [options] [diskimage]


       Hatari  is  an Atari ST/STE/TT/Falcon 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,  STE or Falcon.  Atari TT support is experimental.  Hatari 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


       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  given  file   as   configuration   file   instead   of

       --fast-forward <bool>
              On fast machine helps skipping (fast forwarding) Hatari output

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

       --grab Grab mouse (also) in window mode

       -z, --zoom <x>
              Zoom low resolution (1=no, 2=yes)

       --max-width <x>
              Maximum window width for zooming (Falcon/TT only)

       --max-height <x>
              Maximum window height for zooming (Falcon/TT only)

       --aspect <bool>
              Whether to do monitor aspect ratio correction (Falcon/TT only)

       --borders <bool>
              Show  ST/STE  screen  borders  (for  low/med resolution overscan

       --frameskips <x>
              Skip  <x>  frames  after  each  displayed  frame  to  accelerate
              emulation  (0=disabled,  >4  uses automatic frameskip with given
              value as maximum)

       --statusbar <bool>
              Show statusbar (with floppy leds etc etc)

       --drive-led <bool>
              Show overlay drive led when statusbar isn’t shown

       --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 internal bitdepth (x = 8/15/16/32, 0=disable)

VDI options

       --vdi <bool>
              Whether to use VDI screen mode

       --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> (320 < w <= 1280)

       --vdi-height <h>
              Use extended VDI resolution with height <h> (200 < h <= 960)

Video recording options

              Start AVI recording

       --avi-vcodec <x>
              Select avi video codec (x = bmp/png)

       --avi-fps <x>
              Force avi frame rate (x = 50/60/71/...)

       --avi-crop <bool>
              Remove status bar from the recorded file

       --avi-file <file>
              Use <file> to record avi

Devices options

       -j, --joystick <port>
              Emulate joystick with cursor keys in given port (0-5)

       --joy<port> <type>
              Set joystick type (none/keys/real) for given port

       --printer <file>
              Enable printer support and write data to <file>

       --midi-in <filename>
              Enable MIDI support and write MIDI data to <file>

       --midi-out <filename>
              Enable MIDI support and read MIDI data from <file>

       --rs232-in <filename>
              Enable serial port support and use <file> as the input device

       --rs232-out <filename>
              Enable serial port support and use <file> as the output device

Disk options

       --disk-a <file>
              Set disk image for floppy drive A

       --disk-b <file>
              Set disk image for floppy drive B

       --protect-floppy <x>
              Write protect floppy image contents (on/off/auto).  With  "auto"
              option  write  protection  is  according  to the disk image file

       --protect-hd <x>
              Write  protect  harddrive  <dir>  contents  (on/off/auto).  With
              "auto"  option  the  protection  can  be  controlled  by setting
              individual files attributes as it disables  the  file  attribute
              modifications for the GEMDOS hard disk emulation.

       -d, --harddrive <dir>
              Emulate harddrive partition(s) with <dir> contents

       --acsi <file>
              Emulate an ACSI hard disk with an image <file>

       --ide-master <file>
              Emulate an IDE master hard disk with an image <file>

       --ide-slave <file>
              Emulate an IDE slave hard disk with an image <file>

       --slowfdc <bool>
              slow down FDC emulation (deprecated)

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
              emulation 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 (ST only)

       --timer-d <bool>
              Patch redundantly high Timer-D frequency set by TOS.  This about
              doubles Hatari speed as the original  Timer-D  frequency  causes
              most of the interrupts.

       --dsp <x>
              Falcon DSP emulation (x = none, dummy or emu, Falcon only)

       --sound <x>
              Sound frequency: 6000-50066. "off" disables the sound and speeds
              up  the  emulation.  To  prevent  extra  sound  artifacts,   the
              frequency  should  be  selected so that it either matches evenly
              with the STE/TT/Falcon sound DMA (6258, 12517, 250033, 50066 Hz)
              or   your   sound  card  frequencies  (11025,  22050,  44100  or
              6000...48000 Hz).  Check what your sound card supports.

       --sound-buffer-size <x>
              SDL’s sound buffer size : 10-100, or 0  to  use  default  buffer
              size.   By  default  Hatari  uses  an  SDL  buffer  size of 1024
              samples, which gives approximatively 20-30 ms of sound depending
              on  the  chosen sound frequency. Under some OS or with not fully
              supported sound card, this default setting can  cause  a  bigger
              delay  at  lower  frequency (nearly 0.5 sec).  In that case, you
              can use this option to force the size of the sound buffer  to  a
              fixed  number of milliseconds of sound (using 20 is often a good
              choice if you have such problems). Most users will not need this

       -k, --keymap <file>
              load keyboard mapping from <file>

Debug options

       -D, --debug
              Toggle whether CPU exceptions invoke the debugger

              Enable Bios/XBios interception

       --trace <trace1,...>
              Activate  debug  traces,  see --trace help for available tracing

       --trace-file <file>
              Save trace output to <file> (default=stderr)

       --parse <file>
              Parse/execute debugger commands from <file>

              Save Hatari configuration  and  exit.  Hatari  UI  needs  Hatari
              configuration  file  to  start,  this  can  be used to create it

              Disable SDL parachute to get Hatari core dumps. SDL parachute is
              enabled  by  default  to  restore  video  mode  in  case  Hatari
              terminates   abnormally   while   using   non-standard    screen

       --control-socket <file>
              Hatari reads options from given socket at run-time

       --log-file <file>
              Save log output to <file> (default=stderr)

       --log-level <x>
              Log output level (x=debug/todo/info/warn/error/fatal)

       --alert-level <x>
              Show dialog for log messages above given level

       --run-vbls <x>
              Exit after X VBLs


       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 (same as the reset button)

       AltGr + c
              cold reset the ST (same as the power switch)

       AltGr + d
              open dialog to select/change disk A

       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 options GUI
              You may need to hold SHIFT down while in windowed mode.

       Pause  Pauses the emulation

       AltGr + Pause
              Invokes the internal Hatari debugger

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.


       The main program documentation, usually in /usr/share/doc/.

       The homepage of hatari:


       /etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
              The global configuration file of Hatari.

              The  (default)  directory  for  user’s  personal  Hatari  files;
              hatari.cfg (configuration  file),  hatari.nvram  (NVRAM  content
              file),  hatari.sav  (Hatari  memory  state  snapshot  file which
              Hatari  can  load/save  automatically  when  it   starts/exits),
              hatari.prn  (printer  output  file),  hatari.wav (recorded sound
              output in WAV format), hatari.ym (recorded sound  output  in  YM

       /usr/share/hatari/ (or /usr/local/share/hatari/)
              The global data directory of Hatari.

              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.


       This  manual  page was written by Marco Herrn <> for the
       Debian project and later modified by Thomas Huth and Eero  Tamminen  to
       suit the latest version of Hatari.