Navidrome

Dashboard Status

This module is live. The dashboard uses Navidrome's Subsonic-compatible API with token/salt authentication.

Primary API surfaces:

/rest/ping.view
/rest/getMusicFolders.view
/rest/getArtists.view
/rest/getAlbumList2.view
/rest/getNowPlaying.view

Admin Fields

• Navidrome URL
• Username
• Password

Recommended Values

Navidrome URL: https://music.example.com
Username: dashboard-user
Password: dashboard-user-password

Use a normal Navidrome account. The dashboard derives Subsonic token/salt auth from the password; it does not send the password as a query parameter on every request.

What The Card Shows

• Reported now-playing listener count.
• Artist count.
• Album sample count.
• Music folder count.
• Up to six now-playing rows when clients report playback.

Now Playing Notes

Navidrome only reports now-playing data when now-playing is enabled and the client reports playback/scrobble updates. Some clients can stream successfully without appearing in getNowPlaying.

If library stats work but now-playing stays empty:

1. Confirm Navidrome now-playing support is enabled.
2. Test with a client known to report playback.
3. Confirm the dashboard user can see the same library/playback scope.

Test From The Docker Host

The dashboard generates Subsonic token/salt parameters internally. For a manual test, use a known-good Subsonic client or generate equivalent u, t, s, v, c, and f=json parameters.

Basic shape:

https://music.example.com/rest/ping.view?u=USER&t=TOKEN&s=SALT&v=1.16.1&c=homelab-dashboard&f=json

Common Problems

• Wrong base URL or reverse proxy subpath.
• Password changed after saving dashboard settings.
• Now-playing empty because the client does not report playback.
• Album count shows as sampled when the API result is capped by the dashboard request size.

Sources

• Navidrome Subsonic API compatibility: https://www.navidrome.org/docs/developers/subsonic-api/