lrcdl is a command-line tool for fetching lyrics from audio files using https://lrclib.net.
pip install lrcdl
Download lyrics (.lrc) from a track:
lrcdl song.mp3
By default, lrcdl will only download timed lyrics if they're found. To include plain, non-timed lyrics, use the --include-plain flag:
lrcdl song.mp3 --include-plain
Which will download plain lyrics only if timed ones were not found.
lrcdl relies on the metadata inside the audio track to find lyrics. In cases where the audio file does not have enough metadata, you can manually fill them in using the following parameters: --title, --album, --artist
Example:
lrcdl "Ghost Division.flac" --title "Ghost Division" --album "The Art of War" --artist Sabaton
If you have a music library and you want to download lyrics for all tracks, you can use the -r/--recursive option while specifying a directory as the path:
lrcdl /PATH/TO/MUSIC -r
Note that lrcdl will skip files that already have an LRC file and will not overwrite them.
This command can be safely setup as a scheduled task or a cron job to download lyrics on a nightly basis, however if you have a lot of tracks in your library which lrcdl cannot find lyrics for, then lrcdl will continue to try and download lyrics for them on every run.
To improve performance and avoid unnecessary strain on lrclib's servers, you're highly advised to specify a cache file to skip already-checked files on the next run:
lrcdl /PATH/TO/MUSIC/ -r --cache /PATH/TO/CACHE/cache.txt
To use within Python:
from lrcdl import Track, Options
track = Track("/path/to/song.mp3")
options = Options()
# or specify a path
options = Options(download_path="/path/file.lrc")
track.download_lyrics(options)