librelyrics-lrclib

LRCLIB provider plugin for LibreLyrics. Fetches line-synced and word-synced lyrics from the free, key-less LRCLIB database.

This is a search plugin: it matches on artist, title and duration rather than a provider URL.

Install

pip install librelyrics-lrclib

Usage

# LRCLIB is searched automatically when no URL plugin matches.
librelyrics --artist "Radiohead" --title "Creep"

# Or force it explicitly.
librelyrics --from lrclib --artist "Radiohead" --title "Creep"

# Duration sharpens the match (LRCLIB requires +/-2s agreement).
librelyrics --artist "Radiohead" --title "Creep" --duration 239

To make it part of the normal search chain:

{
    "search_priority": ["lrclib", "betterlyrics"]
}

How it matches

1. GET /api/get with the full track signature (title, artist, album, duration). This is the precise path and the only one that can return word-synced records.
2. If that misses, GET /api/search with structured track_name / artist_name, ranking candidates on artist, title and duration agreement so covers and live versions do not win by accident.

Configuration

Optional, under plugins.lrclib:

librelyrics config edit

Politeness

LRCLIB asks clients to send requests sequentially with a 200-500 ms pause. This plugin throttles itself process-wide (with jitter, so concurrent batch fetches do not burst) and honours Retry-After on both 429 and 503.

Licence

GPL-3.0-or-later. Lyrics are served by LRCLIB under their own terms.