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.
Example
Section titled “Example”[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)Sections
Section titled “Sections”[server]
Section titled “[server]”Server configuration including the HTTP port and log level.
port— HTTP port to listen on (default:8080)log_level— controls log verbosity. Acceptserror,warn,info,debug, ortrace(default:warn). Also accepts the full filter syntax, e.g.warn,claudio_api=debug.
[database]
Section titled “[database]”Database provider selection (sqlite or postgres) and connection details.
[igdb]
Section titled “[igdb]”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]
Section titled “[steamgriddb]”SteamGridDB API key, used to search for cover art when IGDB has no match.
api_key— your SteamGridDB API keytimeout_secs— maximum runtime for a queued SteamGridDB job (default:900)
[library]
Section titled “[library]”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)