https://github.com/kgarner7/navidrome-listenbrainz-plugin
A Navidrome plugin to fetch various metadata from ListenBrainz/MusicBrainz
https://github.com/kgarner7/navidrome-listenbrainz-plugin
navidrome navidrome-plugin
Last synced: 5 months ago
JSON representation
A Navidrome plugin to fetch various metadata from ListenBrainz/MusicBrainz
- Host: GitHub
- URL: https://github.com/kgarner7/navidrome-listenbrainz-plugin
- Owner: kgarner7
- License: mit
- Created: 2025-06-23T03:15:17.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-01-20T04:51:21.000Z (5 months ago)
- Last Synced: 2026-01-20T11:35:33.425Z (5 months ago)
- Topics: navidrome, navidrome-plugin
- Language: Go
- Homepage:
- Size: 28.3 KB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Navidrome ListenBrainz Plugin
A plugin for Navidrome for fetching the metadata from Listenbrainz:
- Artist homepage
- Artist top songs
- Similar artists
**NOTE**: Since the current implementation of `SimilarSongs` is serial, and each request to ListenBrainz is in series, this means that `getSimilarSongs` and `getSimilarSongs2` will take a while (upwards of 10 seconds)
## Requirements
Navidrome >= 0.60.0. This reworked the plugin API. When upgrading to this version, you will need to install a new plugin.
For older versions of Navidrome, see https://github.com/kgarner7/navidrome-listenbrainz-plugin/releases/tag/v1.0.2
## Install instructions
### From GitHub Release
You can download the `brainz.ndp` from the latest release and then run `navidrome plugin install brainz.ndp`.
Make sure to run this command as your navidrome user.
This will unzip the package, and install it automatically in your plugin directory.
### From source
Requirements:
- `go` 1.25
- [`tinygo`](https://tinygo.org/) (recommended)
#### Build WASM plugin
##### Using stock golang
```bash
make
```
This is a development build of the plugin. Compilation should be _extremely_ fast
##### Using TinyGo
```bash
make prod
```
This is the production version of the plugin.
Expect compilation to be slower, but the binary is also slower.
### Install
Copy the package `listenbrainz-metadata-provider.ndp` to your Navidrome plugin directory.
As an admin user open the plugin page (profile icon > plugins) and enable the `listenbrainz-metadata-provider` plugin.
Add the plugin name (`listenbrainz-metadata-provider`) to your [Agents](https://navidrome.org/docs/usage/configuration/options/#:~:text=Default%20Value-,agents,-ND_AGENTS).