kat5200 can be run from the command line or from a windowed environment. It will start with the last rom image run or with the GUI if no rom image found, no BIOS found, or if specified from the GUI.
Basic Usage (Command Line):
kat5200 [ -options value] rom_file_name | sql_file_name
The setup and control of the program is performed via the kat5200.db3 sqlite database file. On a Windows system, this file is located in the User’s application data directory. This is something like C:\Documents and Settings\user\Application Data in XP. On *nix systems it will be searched for in the user’s home directory first (as .kat5200/kat5200.db3), then in /etc/kat5200. In General, configuration settings are edited through the GUI menus but can be overridden through command line options (see the options below). Also note that SQL files are accepted and are run against the database.
The following options are allowed. They can be in any order but must come before the rom_file_name.
Start the program in debug mode.
Width to use in windowed mode or desired fullscreen width
Height to use in windowed mode or desired fullscreen height
FullScreen: 1 for Yes, 0 for No. Video mode is independant of this setting.
Widescreen: 1 for Yes, 0 for No. Shows extra pixels on left and right.
Zoom can be 1-3 and the video screen will be scaled by the value.
Mouse Speed can be 1-5 with 3 as the default.
Sound: 1 for On, 0 for Off.
Speed throttling in percent (0 for full speed).
Start the emulator with the GUI: 1 for Yes, 0 for No.
Start the GUI with Launcher: 1 for Yes, 0 for No.
This is PAL or NTSC.
Enable BASIC in the 8-bit mode: 1 for Yes, 0 for No.
Enable the SIO Patch in the 8-bit mode: 1 for Yes, 0 for No.
This can be 800/800XL/800XE/5200.
This loads up the entered state profile.
This loads up the quick state, value can be 1-9.
This loads up an alternative config db3 file
This resets the config to the default
User Keys (settings can be overidden in the GUI):
The GUI will show when the emulator is started without being able to load the current rom image file or BIOS or when the ESC key is pressed while in the emulation.
It is possible to make kat5200 portable, in other words all needed files are stored with the executable. To do this create a file called portable.txt in the same directory as the kat5200 executable and write a 1 in the file. Note that the kat5200.db3 file needs to be already present in the directory.