# Troubleshooting

## Error loading BIOS image

kat5200 does not know the BIOS/OS file for the current machine.

- Open the [System](options/machine.md) tab and verify the **BIOS File** (and the
  **OS** variant) are set for the selected system.
- If it is empty, browse to the file, or use **Scan for ... BIOS** in
  [Setup](options/misc.md#setup).

## Error loading BASIC image

Same as BIOS: the 8-bit **BASIC File** is not set. Set it on the
[System](options/machine.md) tab or scan for it.

## Error loading ROM image

The image file could not be found or read.

- In the [Launcher](launcher/index.md), select the title and check the **File** field in
  [ROM Options](launcher/rom-settings.md). If it shows *(not set)*, the file has not
  been located.
- Use **Scan for ... ROMs** in [Setup](options/misc.md#setup) to locate it.

## "No filename set for this ROM"

The Launcher entry exists but has no file assigned. Set the **File** in
[ROM Options](launcher/rom-settings.md) or scan for files.

## CPU Crashed — Enter Debugger?

This can have several causes; work through them in order:

1. **Bad ROM dump.** Try a different copy of the image.
2. **SIO patch + disk/cassette.** Disable **Enable SIO Patch** on the
   [System](options/machine.md) tab (use **Save for ROM only** to affect just this
   title).
3. **BASIC mismatch.** Toggle **Enable BASIC** on/off — some titles need it, most
   don't. Save it per-ROM with **Save for ROM only**.
4. **Wrong cartridge mapping.** Set the correct **Mapping** for the title in
   [ROM Options](launcher/rom-settings.md) (default is **Auto**).
5. **Unsupported image.** If none of the above help, the image may not be supported yet.

## A cassette image does nothing on launch

After launching a cassette, press the spacebar in the emulation to begin loading.

## 5200 analog games feel unplayable with a digital stick

Tune the analog options in [Input](options/input.md):

- Lower **Joy Sensitivity** to ~50–75%.
- Enable **Digital To Analog Enable** and set a comfortable **Digital To Analog
  Speed** for position-based games (*Gorf*, *Missile Command*, *Super Breakout*).
- Reduce **Joy Deadzone** to the lowest value that doesn't jitter.

Or just apply the matching game preset in [Setup](options/misc.md#setup).

## Where are my settings, logs, and screenshots?

- Configuration: `~/.config/kat5200/kat5200.conf` (TOML), unless running in
  [portable mode](installation.md#portable-mode). The exact path is shown under
  **Options → Misc → Configuration → Directory**.
- Log file: `kat5200.log` is written in the same directory.
- Screenshots: saved in the same directory as `.bmp` files named after the
  ROM's CRC (e.g. `1A2B3C4D.bmp`, then `1A2B3C4D_01.bmp` and so on).

## Resetting everything

Use **Factory Reset** ([Misc → Configuration](options/misc.md#configuration)) to
restore default configuration. Restart the program for it to take effect.
