A complete toolkit for fetching, syncing, and managing lyrics — from CLI power tools to a fully extensible Python API.
Fetch plain, line-synced, or rich word-level synced lyrics. Export to standard or Enhanced LRC format with precision timestamps.
Extend LibreLyrics with custom providers via a clean plugin API. Distribute plugins as standard PyPI packages.
Download lyrics for entire albums or playlists in a single command with progress tracking and status reports.
Use from the terminal with a rich interactive CLI, or import as a library in your Python projects. Your choice.
Platform-aware JSON configuration with per-plugin settings, interactive editor, and sensible defaults.
Built-in exponential back-off with configurable retry counts and delays for resilient fetching across providers.
Works as a command-line tool or as a Python library. Choose what fits your workflow.
from librelyrics import LibreLyrics, LyricsType
lib = LibreLyrics()
# Fetch synced lyrics for a track
response = lib.fetch(
"https://open.spotify.com/track/...",
lyrics_type=LyricsType.SYNCED,
)
# Export as LRC
print(response.to_lrc())# Single track
librelyrics https://open.spotify.com/track/...
# Album — batch download
librelyrics https://open.spotify.com/album/...
# Manage configuration
librelyrics config show
librelyrics config edit
# Install a plugin
librelyrics plugin install librelyrics-geniusThree steps to perfectly synced lyrics.
A single pip install gets you the CLI and Python library.
Give it a track, album, or playlist URL. The plugin system auto-detects the provider.
Receive perfectly synced lyrics in LRC or Enhanced LRC format, ready for any player.
Dive into the documentation, explore the API, or build your own plugin.