Documentation

The documentation files of Hatari:

Frequently asked questions:

Q: I can't compile Hatari!?
A: You should check if you have installed all needed tools for compiling Hatari: The GNU C compiler (GCC), GNU make (sometimes also called "gmake", other versions of make might not work), the SDL library and the ZLib compression library.

Q: Why is Hatari so slow? Are there any possibilities to speed it up?
A: You should not enable sound when running Hatari (or at least switch to 11kHz), this will increase the speed of the emulator.
There is also the possibility to skip every second screen update, this also speeds it up. You can enable it by passing the "--frameskip" option to Hatari or by using the screen configuration dialog.
Note that you should also not enable the screen zoom mode for the ST Low resolution since this will slow down the emulator, too. If you still want to have a nice fullscreen mode, you should rather add the right resolution mode-lines (e.g. "320x200") to your XF86Config file.
Apropos XF86Config, Hatari currently runs best in 16 bits per pixel color depth mode, so switching your system to 16 BPP might help to avoid speed problems, too.
If Hatari is still too slow, you probably have not enough CPU power. I guess that you need to have a 200Mhz CPU at least.

Q: Game XY does not work, what can I do?
A: Many ST games often need a certain TOS version to run right. Old games often only work with TOS 1.00 or TOS 1.02, so you should try these TOS versions first. If the game still does not work, you should also try TOS 1.04 and 2.06. Some games also either need a NTSC (US American) or a PAL (European) TOS, so it might be useful to test these different types, too.
You should also try different RAM sizes, for example some games do not work with 4 MB memory size!
And finally, try to enable the "CPU prefetch mode" and/or the blitter chip emulation in the system options dialog, this might help, too.