Skip to content

Configuration

As an alternative to environment variables, Claudio can be configured with a TOML file. The config path is set via the CLAUDIO_CONFIG_PATH environment variable, defaulting to /config/config.toml.

Environment variables take precedence over config file values.

[server]
port = 8080
# log_level = "warn" # error | warn | info | debug | trace
[database]
provider = "sqlite" # "sqlite" or "postgres"
sqlite_path = "/config/claudio.db"
# postgres_connection = "postgres://claudio:secret@localhost/claudio"
[igdb]
client_id = ""
client_secret = ""
# timeout_secs = 600 # Maximum runtime for a queued IGDB scan job
[steamgriddb]
api_key = ""
# timeout_secs = 900 # Maximum runtime for a queued SteamGridDB job
[library]
library_paths = ["/games"]
# exclude_platforms = ["ps", "ngc"] # Platform folders to skip during scans
# scan_interval_secs = 120 # How often to re-scan the library (in seconds)

Server configuration including the HTTP port and log level.

  • port — HTTP port to listen on (default: 8080)
  • log_level — controls log verbosity. Accepts error, warn, info, debug, or trace (default: warn). Also accepts the full filter syntax, e.g. warn,claudio_api=debug.

Database provider selection (sqlite or postgres) and connection details.

IGDB/Twitch API credentials for game metadata. See the Twitch Developer Portal to create credentials.

  • timeout_secs — maximum runtime for a queued IGDB scan job (default: 600)

SteamGridDB API key, used to search for cover art when IGDB has no match.

  • api_key — your SteamGridDB API key
  • timeout_secs — maximum runtime for a queued SteamGridDB job (default: 900)

List of paths to scan for game directories and scan timing.

  • library_paths — directories to scan for platform/game folders (default: ["/games"])
  • exclude_platforms — platform folders to skip during scans, e.g. ["ps", "ngc"] (default: none)
  • scan_interval_secs — how often to re-scan the library in seconds (default: 120)