# Misc

The **Misc** tab collects program-level options and utility windows: the first-run
**Setup** window, **Configuration** (start-up behavior, throttle, factory reset),
**Palette** import, **Create Media**, **Log**, the **Debugger**, and the **Manual**.
Press **Save** to persist the options on this tab.

## Program options

| Setting | Description |
|---------|-------------|
| **Start With** | What kat5200 does at launch: **Last ROM** (boot the most recently run ROM), **ROM Launcher** (open the Launcher), or **File Browser** (open the file browser). |
| **Throttle** | Emulation speed as a percentage, where **100%** is normal speed. Lower to slow down; raise (toward 200%) to fast-forward through disk loads. |

## Setup

The **Setup** window is the fastest way to get a new install ready and to set up
the 5200's tricky analog games. It groups game presets, ROM/BIOS scanning, and the
ROM-set downloader.

### Game presets

Each preset applies known-good controls (and analog tuning where relevant) for a
specific title or style of game:

| Group | Presets |
|-------|---------|
| **Trackball Games** | Setup Mouse, plus presets for *Centipede*, *Missile Command*, *Super Breakout*, *Bug Hunt (Trackball)*. |
| **Paddle/Cursor Games** | Setup Mouse, Setup Digital To Analog, plus presets for *Star Wars Arcade*, *Gorf*, *Castle Crises*, *Kaboom*, *Bug Hunt (Joystick)*. |
| **Setup 2 Stick Games** | Presets for *Space Dungeon* and *Robotron 2084*. |

The paddle-style presets can also constrain the POKEY POT range to the horizontal
range a game actually uses. This is useful for games such as *Super Breakout* and
*Kaboom*, where small paddle movements should stay inside the playable range.

### Scan for BIOS and ROMs

| Action | Description |
|--------|-------------|
| **Scan for 5200 BIOS** / **Scan for 8-bit BIOS** | Locate OS/BIOS images and assign the best match per machine. Each has its own directory field. |
| **Scan for 5200 ROMs** / **Scan for 8-bit ROMs** | Add game images to the Launcher database. Each has its own directory field. |
| **Download 5200 ROM Set** | Fetch a 5200 ROM set into the **Download Directory** (requires a ROM-download backend). |

Scanning a directory matches files against the image database and fills in each
entry's **File** so images become launchable. Best-fit BIOS images are assigned
per machine and can later be changed under [System](machine.md). Finish with
**Scan & Save** (or **Download, Scan & Save**), or **Save only** to keep the
directory paths without scanning.

## Create Media

Creates blank media images for the 8-bit machines:

- **Create Disk** — choose **Sector Size / Boot Type** and number of **Sectors**,
  then **Create** (save with an `.atr` extension) to write a new floppy image.
- **Create Cassette** — add an optional **Description**, then **Create** (save with
  a `.cas` extension) to write a new cassette image.

## Palette

Imports an Atari800-style binary palette into `kat5200.conf`. The expected
format is a **768-byte** file of 256 RGB triplets (one byte each for red, green,
blue) — the same layout used by Adobe Color Table **`.act`** files and Atari800
`.pal` palettes.

| Item | Description |
|------|-------------|
| **File** | Opens the file browser to choose the palette file (a 768-byte `.act`/`.pal` binary palette). |
| **Name** | The palette name saved in the config. If empty when a file is chosen, it is filled from the filename without the directory or extension. |
| **Import** | Adds the palette. Existing palette names are not overwritten. |
| **Palette** | Selects an existing palette as the delete target. This does not change the active Graphics palette. |
| **Delete** | Confirms, then removes the selected palette from `kat5200.conf`. If it was active, kat5200 falls back to another available palette or the generated default. |

After importing, select the new palette under [Graphics](video.md).

## Configuration

| Item | Description |
|------|-------------|
| **Directory** | The (read-only) path kat5200 reads/writes its configuration and files from. Use this to find the active `kat5200.conf`. |
| **Factory Reset** | Restore the configuration to defaults. You are asked to confirm; the change takes effect after restarting the program. |

## Log

**Log** shows the current tail of `kat5200.log` in a read-only text view. The
view loads the latest log contents when opened and supports selecting text and
copying it with **Ctrl+C**.

## Debugger

**Debugger** opens kat5200's built-in 6502 debugger for the running machine. It
shows the machine state in separate movable windows — CPU registers, a live
disassembly, and the ANTIC, GTIA, and POKEY chip registers — plus execution
controls for stepping and resuming. The window positions are remembered between
sessions. The debugger is also reachable with its UI shortcut (++f1++ by
default) and is offered when the emulated CPU crashes.

## Manual

**Manual** opens this user guide as a PDF in your system's default PDF viewer.
The PDF is installed with the program's data files; if it is missing or the
system has no PDF handler, kat5200 shows a message and logs the details to
`kat5200.log`.
