# Sprimo Config Reference

File location:

- Windows: `%APPDATA%/sprimo/config/config.toml`
- macOS: `~/Library/Application Support/sprimo/config/config.toml`
- Linux: `~/.config/sprimo/config/config.toml`

## Schema

```toml
[window]
x = 200.0
y = 200.0
monitor_id = ""
scale = 1.0
always_on_top = true
click_through = false
visible = true

[animation]
fps = 30
idle_timeout_ms = 3000

[sprite]
selected_pack = "default"
sprite_packs_dir = "sprite-packs"

[api]
port = 32145
auth_token = "generated-uuid-token"

[logging]
level = "info"

[controls]
hotkey_enabled = true
recovery_hotkey = "Ctrl+Alt+P"

[frontend]
backend = "bevy"
debug_overlay_visible = false
```

## Notes

- `auth_token` is generated on first run if config does not exist.
- `window.x`, `window.y`, `window.scale`, and flag fields are persisted after matching commands.
- `window.click_through` is deprecated and ignored at runtime; it is always forced to `false`.
- On Windows, `recovery_hotkey` now forces `visible = true` and `always_on_top = true` for recovery.
- `frontend.backend` selects runtime frontend implementation (`bevy` or `tauri`).
- `frontend.debug_overlay_visible` controls whether tauri window debug diagnostics panel is shown.