Skip to content
podkit

Environment Variables

podkit settings can be overridden via environment variables. These take precedence over values in the config file but are overridden by CLI arguments.

Variables

VariableDescription
PODKIT_CONFIGPath to config file (overrides default ~/.config/podkit/config.toml)
PODKIT_QUALITYUnified quality preset (overrides config file quality)
PODKIT_AUDIO_QUALITYAudio-specific quality (overrides config file audioQuality)
PODKIT_VIDEO_QUALITYVideo-specific quality (overrides config file videoQuality)
PODKIT_LOSSY_QUALITYLossy source quality (overrides config file lossyQuality)
PODKIT_ARTWORKDefault artwork setting (overrides config file artwork)
PODKIT_MUSIC_<NAME>_PASSWORDSubsonic password for collection <NAME> (uppercase, hyphens become underscores)
SUBSONIC_PASSWORDFallback password for any Subsonic collection

Subsonic Password Resolution

For a Subsonic collection named navidrome, the password is resolved in this order:

  1. password field in config file
  2. PODKIT_MUSIC_NAVIDROME_PASSWORD environment variable
  3. SUBSONIC_PASSWORD environment variable

The collection name is uppercased and hyphens are replaced with underscores. For example, a collection named my-server uses PODKIT_MUSIC_MY_SERVER_PASSWORD.

Configuration Priority

Settings are merged from multiple sources. Later sources override earlier ones:

  1. Hardcoded defaults — quality = "high", artwork = true
  2. Config file — ~/.config/podkit/config.toml
  3. Environment variables — PODKIT_*
  4. CLI arguments — --quality, --audio-quality, --video-quality, --no-artwork, etc.

Device-specific settings ([devices.<name>]) override global settings when that device is being used.

For the detailed quality resolution chain (how quality, audioQuality, and videoQuality interact across global, device, and CLI levels), see Config File Reference — Quality Resolution Order.

See Also