.\" Hey, EMACS: -*- nroff -*- .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH "HATARI" "1" "2007-05-12" "Hatari" "" .\" Please adjust this date whenever revising the manpage. .SH "NAME" hatari \- Atari ST(e) emulator .SH "SYNOPSIS" .B hatari .RI [options] .RI [diskimage] .SH "DESCRIPTION" Hatari is an Atari ST(e) emulator for Linux, FreeBSD, BeOS and other Systems which are supported by the SDL library. .PP 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. .PP 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. .SH "OPTIONS" .TP .B \-h, \-\-help print command line options and terminate .TP .B \-v, \-\-version print version information and terminate .TP .B \-m, \-\-mono start the emulated Atari ST in monochrome resolution .TP .B \-f, \-\-fullscreen start the emulator in fullscreen mode .TP .B \-w, \-\-window start the emulator in window mode .TP .B \-j, \-\-joystick emulate ST joystick in 0 or 1 with keyboard .TP .B \-\-nosound disable sound (makes emulation faster) .TP .B \-\-frameskip drop every second frame (accelerates emulation) .TP .B \-D, \-\-debug activate the simple builtin debugger .TP .B \-\-slowfdc slow down FDC emulation (needed to make some games and demos work) .TP .B \-d, \-\-harddrive use as an emulated hard disk .TP .B \-\-hdimage emulate hard disk with an image file .TP .B \-\-tos specify TOS ROM image to use .TP .B \-\-cartridge use ROM cartridge image (only works if GEMDOS HD emulation and extended VDI resolution are disabled) .TP .B \-s, \-\-memsize x set amount of emulated RAM .br x=0 for 512K, and x=1, x=2 or x=4 for 1, 2 or 4 MB .TP .B \-\-cpulevel x specify CPU (680x0) to use (TOS 2.06 only!!) .TP .B \-\-compatible use a more compatible but slower 68000 CPU mode .TP .B \-\-blitter enable blitter emulation .TP .B \-\-vdi use extended VDI resolution .TP .B \-\-printer enable experimental printer support .TP .B \-\-midi enable experimental MIDI output to the mentioned file .TP .B \-\-rs232 enable experimental RS232 emulation via the mentioned file/device .TP .B \-c, \-\-configfile use the mentioned file as configuration file instead of ~/.hatari.cfg .TP .B \-\-machine select machine type (x = st or ste) .TP .B \-\-keymap load keyboard mapping from .SH "COMMANDS" The shortcut keys can be configured in the configuration file. The default settings are: .TP .B AltGr + a record animation .TP .B AltGr + g grab a screenshot .TP .B AltGr + i boss key: leave full screen mode and iconify window .TP .B AltGr + j activate joystick emulation via cursor keys .TP .B AltGr + m (un-)lock the mouse into the window .TP .B AltGr + r (warm) reset the ST .TP .B AltGr + c coldreset the ST (same as the original power switch) .TP .B AltGr + s enable/disable sound .TP .B AltGr + q quit the emulator .TP .B AltGr + x toggle normal/max speed .TP .B AltGr + y enable/disable sound recording .TP .B AltGr + k save memory snapshot .TP .B AltGr + l load memory snapshot .TP .B F11 toggle between fullscreen and windowed mode .TP .B F12 activate the hatari command GUI .br You may need to hold SHIFT down while in windowed mode. .TP .B Pause will go to the debugger if it was activated with the -\-debug option .SH 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: .TP .B Alt will act as the ST's ALTERNATE key .TP .B left Ctrl will act as the ST's CONTROL key .TP .B Page Up will emulate the ST's HELP key .TP .B Page Down will emulate the ST's UNDO key .PP .B AltGr will act as .B Alternate as well as long as you do not press it together with a Hatari hotkey combination. The .B 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. .SH "SEE ALSO" The main program documentation, usually in /usr/share/doc/. .PP The homepage of hatari: http://hatari.sourceforge.net .SH "FILES" .TP /etc/hatari.cfg (or /usr/local/etc/hatari.cfg) the global configuration file of Hatari .TP ~/.hatari.cfg the user's personal Hatari configuration file .TP 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. .SH "AUTHOR" This manual page was written by Marco Herrn , for the Debian project and later modified by Thomas Huth to suit the latest version of Hatari.