A CLI tool for automatically downloading lyrics for your music collection from the LRCLIB database.

• Fetches synchronized (.lrc) and plain text (.txt) lyrics
• Supports batch processing of directories with progress tracking
• Recursive directory scanning
• Handles instrumental tracks
• Preserves existing lyrics files unless specified otherwise
• Supports common audio formats (MP3, FLAC, WAV, OGG, M4A, AAC, OPUS, WMA, APE, DSF, DFF)

Clone the repository:

git clone https://github.com/khalil-cheddadi/lrcphile.git

Build and install:

cd lrcphile
cargo install --path .

Process your entire music library (defaults to system music directory):

lrcphile

Process a single audio file:

lrcphile /path/to/song.mp3

Process a specific directory:

lrcphile /path/to/music/

Process recursively and override existing lyrics files:

lrcphile -r -o

Use a different LRCLIB instance:

lrcphile --url https://my-lrclib.example.com

• [PATH]: Path to audio file or directory (defaults to system music directory)
• -r, --recursive: Recursively process subdirectories
• -o, --override: Override existing lyrics files
• -u, --url <URL>: URL for the lyrics database instance (default: https://lrclib.net)

Audio files must have proper metadata (title, artist, album) for lyrics lookup to work.