-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
These directories contain albums by multiple artists. Stillwater manages per-artist metadata (biography, images, genres), which does not apply to compilation or soundtrack folders. Excluding them avoids creating meaningless artist entries.
The default exclusion list is: Various Artists, Various, VA, Soundtrack, OST. You can customize it via the SW_SCANNER_EXCLUSIONS environment variable or config.yaml (see Configuration).
No. MusicBrainz, Wikidata, and Deezer work without API keys. Fanart.tv, Last.fm, and Discogs require free API keys (register on their respective sites). TheAudioDB works on a free tier with an optional premium key for higher rate limits.
You can add keys at any time from the Settings page. The onboarding wizard also prompts for them during initial setup.
Stillwater supports one active platform profile at a time (Emby, Jellyfin, or Kodi). The active profile controls NFO format and image file naming. You can switch profiles at any time from Settings, but switching changes how new files are written going forward.
If you run multiple media servers, choose the primary one as the active profile. The others may still be able to read the files depending on format compatibility.
Yes. You can add multiple connections of the same type. Each connection is independent and can be used to import artists or push metadata to different servers.
Deleting an artist from Stillwater removes it from the database only. NFO files and images already written to disk are not deleted. A subsequent library scan will rediscover the directory and recreate the artist entry (without metadata).
When MBIDs are available (from Lidarr, embedded tags, or NFO files), Stillwater uses them directly for provider lookups. This avoids ambiguous name-based matching. IDs are stored per artist and persist across scans.
The project builds to a single Go binary. You can build from source (make build) and run it directly, but Docker is the supported deployment method. You would need to set environment variables or provide a config file, and ensure the binary has access to the data and music directories.
Stillwater automatically backs up the SQLite database at a configurable interval (default: every 24 hours). Backups are stored in /data/backups and rotated (default: keep 7). You can also trigger a manual backup and download backup files from the Settings page.
Log in and click Guide in the navigation bar, or visit /guide. It covers library structure, scanner exclusions, platform profiles, metadata providers, image management, server connections, the rule engine, and NFO files.