Skip to content

How-to guides

Step-by-step procedures for the common operations. For background and why, see core concepts.

  • The Dashboard


    Read the health bubbles, work the action queue, and follow the live activity rail.

    Read more

  • Run scans


    Discover artists from disk, refresh from connected platforms, schedule recurring runs.

    Read more

  • Edit an artist


    Change metadata by hand, lock fields you've curated, override provider IDs.

    Read more

  • Filter the artists list


    Narrow the Artists page with tri-state field, image, platform, and status filters.

    Read more

  • Unmatched images


    Review, allowlist, or delete unmatched images found on disk.

    Read more

  • Activity feed


    Browse and filter the library-wide history of metadata changes, and undo one from its entry.

    Read more

  • Logs viewer


    Watch the live-tailing log stream, filter by severity or component, and export for a bug report.

    Read more

  • Customize preferences


    Adjust theme, layout density, typography, and per-artist section order from the Preferences drawer.

    Read more

  • Quick Actions


    Cycle themes, open the keyboard shortcut reference, and log out from the sidebar Quick Actions bar.

    Read more

  • Refresh metadata


    Pull updates from providers for a single artist or a whole library.

    Read more

  • Fetch and crop images


    Get artwork from providers or the web, crop in-browser, save canonical filenames.

    Read more

  • Fetch discography


    Pull release groups from MusicBrainz and write them into the artist's NFO discography.

    Read more

  • Configure provider priorities


    Set which providers Stillwater asks first for each field, globally and per library.

    Read more

  • Enable and configure rules


    Turn rules on and off, change automation modes, tune thresholds.

    Read more

  • Export and import settings


    Move your configuration to another instance with an encrypted bundle.

    Read more

  • Convert YAML config to TOML


    Migrate a deprecated YAML config file to the supported TOML format, section by section.

    Read more

  • Update Stillwater


    Apply a new version manually or have Stillwater check for updates.

    Read more

  • Reverse proxy


    Front Stillwater with Caddy, Nginx, Traefik, or LSIO SWAG.

    Read more