Next: , Previous: , Up: Top   [Contents]

General Usage

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.

Command Line Options

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 value

FullScreen: 1 for Yes, 0 for No. Video mode is independant of this setting.

-widescreen value

Widescreen: 1 for Yes, 0 for No. Shows extra pixels on left and right.

-zoom value

Zoom can be 1-3 and the video screen will be scaled by the value.

-mouse_speed value

Mouse Speed can be 1-5 with 3 as the default.

-sound value

Sound: 1 for On, 0 for Off.

-throttle value

Speed throttling in percent (0 for full speed).

-start_with_gui value

Start the emulator with the GUI: 1 for Yes, 0 for No.

-start_gui_with_launcher value

Start the GUI with Launcher: 1 for Yes, 0 for No.

-system_type value

This is PAL or NTSC.

-basic_enable value

Enable BASIC in the 8-bit mode: 1 for Yes, 0 for No.

-sio_patch value

Enable the SIO Patch in the 8-bit mode: 1 for Yes, 0 for No.

-machine_type value

This can be 800/800XL/800XE/5200.

-state profile

This loads up the entered state profile.

-quick_state value

This loads up the quick state, value can be 1-9.

-config filename

This loads up an alternative config db3 file


This resets the config to the default

User Keys (settings can be overidden in the GUI):

GUI Usage

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.

Portable Usage

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.

Next: , Previous: , Up: Top   [Contents]