Navidrome for Kodi

Stream your Navidrome music library in Kodi — browsing, search, playlists, offline downloads, ratings and scrobbling. This page is the add-on repository; add it once and Kodi handles updates from then on.

Plugin 0.6.0 Repository 1.0.1 Kodi 19 Matrix or newer

Before you start

You need a reachable Navidrome server (its URL, plus a username and password), and Kodi 19 “Matrix” or newer — the add-on targets Python 3, so Kodi 18 and earlier cannot run it.

Install

You add the repository once. After that Kodi checks it for new versions on its own and offers the update — there is nothing to repeat per release.

  1. Allow add-ons from outside the official repository: Settings → System → Add-ons, turn on Unknown sources, and accept the warning.
  2. Go to Settings → File manager → Add source, choose <None>, and enter this address exactly, with the trailing slash: https://kodi.kellerwahnsinn.com/repo/ Name it navidrome and select OK.
  3. Go to Settings → Add-ons → Install from zip file, pick navidrome → repository.kodi.navidrome → repository.kodi.navidrome-1.0.1.zip. This installs the repository, not the plugin.
  4. Now go to Settings → Add-ons → Install from repository, choose Navidrome Kodi Repository → Music add-ons → Navidrome, and select Install.

Step 4 always installs the current release, which is 0.6.0. Future updates arrive through the same repository automatically.

Installing a specific version by hand

For rolling back, or for a one-off install without adding the repository.

Every published zip stays available at repo/plugin.kodi.navidrome/. Using the same navidrome file source from step 2, go to Install from zip file and browse into plugin.kodi.navidrome instead, then pick the version you want.

Kodi will not auto-update a plugin installed this way while the repository is absent, and it will not downgrade one either — to go back up, install the newer zip the same way.

Connect it to your server

Nothing works until you enter your server details. Open Add-ons → Music add-ons, then right-click (or long-press) Navidrome and choose Settings.

On the Server tab:

Server URL
Your Navidrome address, including the scheme and port if it is not standard — for example https://music.example.com or http://192.168.1.10:4533.
Username / Password
Your normal Navidrome login.
Verify TLS certificate
Leave this on. If your server uses a private or self-signed certificate, keep verification on and point CA certificate at the certificate that signed it. Turning verification off is the last resort — it removes any protection against an intercepted connection.

The remaining tabs are optional and have working defaults: Playback (server-side transcoding and bitrate), Offline (download tracks, albums or playlists for listening without the server, and the cache size limit), Scrobbling (on by default, with a configurable threshold), Display and Advanced (API timeout, debug logging).

Already added this repository before September 2026?

Earlier releases of the repository add-on pointed at a hostname that was never published, so Kodi silently found no updates. Kodi cannot repair this on its own — it cannot download a fix from an address it fails to resolve.

To fix it: uninstall Navidrome Kodi Repository under Settings → Add-ons → My add-ons → Add-on repository, then follow Install above again. Version 1.0.1 or newer has the correct address. Your plugin settings and offline downloads are untouched.

If something goes wrong

“Could not connect to repository” or no updates appear
Check that the device can reach kodi.kellerwahnsinn.com at all, then confirm the repository add-on is version 1.0.1 or newer — see the note above.
“Failed to install a dependency” or the add-on will not enable
Almost always Kodi 18 or older. Check Settings → System information.
Empty library, or a connection error inside the add-on
Re-check the Server URL, including scheme and port. If you are on HTTPS with a private CA, see Verify TLS certificate above. Turning on Enable Debug Logging under Advanced puts detail into the Kodi log.