Sprimo/docs/CONFIG_REFERENCE.md

Sprimo Config Reference

File location:

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

Schema

[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"

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.
• On Windows, recovery_hotkey provides click-through recovery even when the window is non-interactive.
• frontend.backend selects runtime frontend implementation (bevy or tauri).