Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/TheOutdoorProgrammer/crate/llms.txt

Use this file to discover all available pages before exploring further.

Crate’s Navidrome integration is a lightweight, optional hook that fires after every download is organized into your library. Once a file lands in its final location, Crate calls the Navidrome Subsonic API to start a scan — so new tracks show up in Navidrome without you having to trigger a manual rescan or wait for Navidrome’s scheduled sweep. If you never configure Navidrome, Crate continues to work exactly as normal; the integration is purely additive.
Navidrome integration is completely optional. Crate downloads, organizes, and tracks music independently — Navidrome connection details are only needed if you want new files to appear in Navidrome immediately after download.

​
How it works

When Crate finishes organizing a completed download, it calls Navidrome’s /rest/startScan endpoint. Crate authenticates using the Subsonic token-based auth scheme: it generates a random salt, hashes password + salt with MD5, and passes u (username), t (token), and s (salt) as query parameters. Navidrome’s filesystem scan is incremental, so in practice only the newly added file is processed. If the Navidrome connection is misconfigured or temporarily unreachable, Crate logs a warning and moves on — a failed scan trigger never blocks a download from completing or being recorded in your library.

​
Setup

1

Open the Integrations settings

In the Crate UI, navigate to Settings → Integrations → Navidrome.
2

Enter your Navidrome URL

Paste the base URL of your Navidrome server — for example, http://navidrome:4533 or https://music.example.com. Do not include a trailing path.This is stored as the navidrome_url setting.
3

Enter your Navidrome username and password

Enter the Navidrome account credentials Crate should use when triggering scans. These are stored as navidrome_user and navidrome_password.
Create a dedicated Navidrome account for Crate with the minimum required permissions, rather than using your personal admin account.
4

Save and test

Click Save. Trigger a test download (or re-download an existing track) to confirm that a Navidrome scan starts immediately after the file is organized. You should see new music appear in Navidrome without a manual rescan.

​
Configuration reference

All three values must be non-empty for the integration to activate. If any field is blank, Crate silently skips the scan trigger.
Setting keyDescription
navidrome_urlBase URL of your Navidrome server
navidrome_userNavidrome username Crate uses for authentication
navidrome_passwordNavidrome password for the above account

​
Using Navidrome alongside Music Assistant

If you also run Music Assistant, you can configure both integrations simultaneously. See the Music Assistant integration guide for details — Music Assistant adds library sync after downloads and a reject-from-app workflow on top of what Navidrome provides.

Build docs developers (and LLMs) love

Get started for freeTalk to us