A Navidrome plugin to fetch lyrics from multiple sources. Formerly Navidrome LRCLIB Plugin.
[!IMPORTANT] The Navidrome WebUI does not display lyrics from plugins at the moment, you need a third party client in order to see them.
Make sure your Navidrome version is at least v0.61.2.
nd-lyrics.ndp from the Releases page and place it in your plugins folder.nd-lyrics to the LyricsPriority config option. See here.TIP: If you are using the "Write lyrics to .lrc files" option, you can do ".lrc,nd-lyrics,<others...>" so Navidrome reads the files
directly when available. This will only work if "Write to custom path" is disabled.
At this time, the following providers are available. Please report any issues you encounter while using them.
You can optionally pass parameters to a provider by placing them in parentheses after the provider name. Providers with and without parameters can be mixed together in the same list.
The following example will first try to fetch lyrics from http://my_custom_lrclib.net, then fall back to default lrclib and lyrics.ovh if no lyrics are found.
lrclib(http://my_custom_lrclib.net),lrclib,lyrics.ovh
| Provider | Type | Optional parameters |
|---|---|---|
| lrclib | plain + synced | (Base URL) |
| lyrics.ovh | plain | (Base URL) |
| kugou | synced | |
| netease | synced |
Custom paths to write lyrics files to can be composed using path variables.
Consider the following example:
_lyrics/{type}/{track:album}/{track:track_number:2} - {track:title}
This will be transfored into something like this:
<selected_library_root>/_lyrics/synced/The Razors Edge/01 - Thunderstruck.lrc
Note that the extension is appended automatically based on the configuration and lyrics type.
| Variable | Description |
|---|---|
| {type} | The type of lyrics ("plain", "synced" or "instrumental") |
| {track:id} | The ID of the track |
| {track:title} | The title of the track |
| {track:album} | The name of the album this track belongs to |
| {track:artist} | The artist of the track |
| {track:album_artist} | The artist of the album this track belongs to |
| {track:track_number} | The number of track in the album* |
| {track:disc_number} | The number of the disc in the album* |
* {track:track_number} and {track:disc_number} accept a padding argument to fill with 0s:
{track:track_number:2} will ensure that there are at least 2 digits. For example, track_number 1 will become 01.
$ claude mcp add navidrome-lyrics-plugin \
-- python -m otcore.mcp_server <graph>