1HATARI(1) HATARI(1)
2
6 hatari - Atari ST(e) emulator
7
9 hatari [options] [diskimage]
10
12 Hatari is an Atari ST(e) emulator for Linux, FreeBSD, BeOS and other
13 Systems which are supported by the SDL library.
14 With hatari one can run games, demos or applications written for Atari
16 ST or Atari STE. It supports the commonly used *.st and *.msa disk
17 images and hard disk emulation.
18 To run the emulator a TOS ROM image is needed. EmuTOS, a free implemen‐
20 tation of TOS is shipped with hatari. Since it is not yet fully compat‐
21 ible with the original TOS some programs won't run correctly with this.
22 Because of this it is recommended to use a TOS ROM from a real Atari.
23
25 Hatari options are split into several categories:
26
28 -h, --help
29 Print command line options and terminate
30 -v, --version
32 Print version information and terminate
33 --confirm-quit <bool>
35 Whether Hatari confirms quitting
36 -c, --configfile <filename>
38 use the mentioned file as configuration file instead of
39 ~/.hatari.cfg
40
42 -m, --mono
43 Start in monochrome mode instead of color
44 --monitor <x>
46 Select monitor type (x = mono/rgb/vga/tv)
47 -f, --fullscreen
49 Start the emulator in fullscreen mode
50 -w, --window
52 Start the emulator in window mode
53 -z, --zoom <x>
55 Zoom low resolution (1=no, 2=yes)
56 --frameskips <x>
58 Skip <x> frames after each displayed frame to accelerate emula‐
59 tion (0 <= x <= 8)
60 --borders <bool>
62 Show screen borders (for overscan demos etc)
63 --spec512 <x>
65 Hatari uses this threshold to decide when to render a screen
66 with the slower but more accurate Spectrum512 screen conversion
67 functions (0 <= x <= 512, 0=disable)
68 --bpp <bool>
70 Force given internal bitdepth (x=8/16/32, x=0 for autodetec‐
71 tion). 8-bit color depth may be useful for older host computers
72
74 --vdi-planes <x>
75 Use extended VDI resolution with bit depth <x> (x = 1, 2 or 4)
76 --vdi-width <w>
78 Use extended VDI resolution with width <w> (384 <= w <= 1024)
79 --vdi-height <h>
81 Use extended VDI resolution with height <h> (200 < h <= 768)
82
84 -j, --joystick <port>
85 Emulate joystick with cursor keys in given port (0-5)
86 --printer <file>
88 Enable printer support and write data to <file>
89 --midi <filename>
91 Enable experimental MIDI output to the mentioned file
92 --rs232 <filename>
94 Enable experimental RS232 emulation via the mentioned
95 file/device
96
98 -d, --harddrive <dir>
99 Use <dir> as an emulated hard disk
100 --acsi <file>
102 Emulate ACSI hard disk with an image <file>
103 --slowfdc <bool>
105 slow down FDC emulation (needed to make some games and demos
106 work)
107
109 -s, --memsize <x>
110 Set amount of emulated RAM, x = 1 to 14 MiB, or 0 for 512 KiB
111 -t, --tos <imagefile>
113 Specify TOS ROM image to use
114 --cartridge <imagefile>
116 Use ROM cartridge image <file> (only works if GEMDOS HD emula‐
117 tion and extended VDI resolution are disabled)
118 --memstate <file>
120 Load memory snap-shot <file>
121
123 --cpulevel <x>
124 Specify CPU (680x0) to use (use x >= 1 with EmuTOS or TOS >=
125 2.06 only!)
126 --cpuclock <x>
128 Set the CPU clock (8, 16 or 32 Mhz)
129 --compatible <bool>
131 Use a more compatible but slower 68000 CPU mode
132
134 --machine <x>
135 select machine type (x = st, ste, tt or falcon)
136 --blitter <bool>
138 Enable blitter emulation
139 --dsp <x>
141 Falcon DSP emulation (x = none, dummy or emu)
142 --sound <x>
144 Sound quality (off/low/med/hi (off=faster))
145 --keymap <file>
147 load keyboard mapping from <file>
148
150 -D, --debug <bool>
151 activate the simple builtin debugger
152 --log <file>
154 Save log to <file> (can also be "stdout" or "stderr")
155 --trace <trace1,...>
157 Activate debug traces, see --trace help for tracing options
158
160 The shortcut keys can be configured in the configuration file. The
161 default settings are:
162 AltGr + a
164 record animation
165 AltGr + g
167 grab a screenshot
168 AltGr + i
170 boss key: leave full screen mode and iconify window
171 AltGr + j
173 activate joystick emulation via cursor keys
174 AltGr + m
176 (un-)lock the mouse into the window
177 AltGr + r
179 (warm) reset the ST
180 AltGr + c
182 coldreset the ST (same as the original power switch)
183 AltGr + s
185 enable/disable sound
186 AltGr + q
188 quit the emulator
189 AltGr + x
191 toggle normal/max speed
192 AltGr + y
194 enable/disable sound recording
195 AltGr + k
197 save memory snapshot
198 AltGr + l
200 load memory snapshot
201 F11 toggle between fullscreen and windowed mode
203 F12 activate the hatari command GUI
205 You may need to hold SHIFT down while in windowed mode.
206 Pause will go to the debugger if it was activated with the --debug
208 option
209
212 All other keys on the keyboard act as the normal Atari ST keys so
213 pressing SPACE on your PC will result in an emulated press of the SPACE
214 key on the ST. The following keys have special meanings:
215 Alt will act as the ST's ALTERNATE key
217 left Ctrl
219 will act as the ST's CONTROL key
220 Page Up
222 will emulate the ST's HELP key
223 Page Down
225 will emulate the ST's UNDO key
226 AltGr will act as Alternate as well as long as you do not press it
228 together with a Hatari hotkey combination.
229 The right Ctrl key is used as the fire button of the emulated joystick
231 when you turn on joystick emulation via keyboard.
232 The cursor keys will act as the cursor keys on the Atari ST as long as
234 joystick emulation via keyboard has been turned off.
235
238 The main program documentation, usually in /usr/share/doc/.
239 The homepage of hatari: http://hatari.sourceforge.net
241
244 /etc/hatari.cfg (or /usr/local/etc/hatari.cfg)
245 the global configuration file of Hatari
246 ~/.hatari.cfg
248 the user's personal Hatari configuration file
249 tos.img
251 The TOS ROM image will be loaded from the data directory of
252 Hatari unless it is specified on the command line or the config‐
253 uration file.
254
257 This manual page was written by Marco Herrn <marco@mherrn.de>, for the
258 Debian project and later modified by Thomas Huth to suit the latest
259 version of Hatari.
260Hatari 2008-03-14 HATARI(1)