🎵 lrc-dl

An ultimate CLI tool for downloading lyrics for songs, inspired by other awesome *-dl projects.

Installation

Before you begin, make sure you have python3 and pip installed.

0. If you wish to use the youtube provider, install ffmpeg and add it to your PATH.
1. Clone the repository:

   git clone https://github.com/mrsobakin/lrc-dl.git
   

2. Navigate to the project directory:

   cd lrc-dl
   

3. Install the package:

   pip install .
   

Usage

You can use lrc-dl both as a CLI tool and as a Python module.

CLI Usage

lrc-dl [-h] [-c CONFIG] [-e EXTENSIONS] [-f] path

Positional Arguments:

• path: Path to the song file or directory

Options:

• -h, --help: Display help message and exit.
• -c CONFIG, --config CONFIG: Specify a custom config file (in TOML format) for lrc-dl.
• -e EXTENSIONS, --extensions EXTENSIONS: Define music file extensions, separated by commas (e.g., wav,flac,mp3).
• -f, --force-override: Force override .lrc file, if it already exists.

Usage as a Python Module

You can also use lrc-dl as a Python module, allowing you to integrate its functionality directly into your own scripts or applications.

Initializing LyricsDl

from lrc_dl import LyricsDl, LyricsDlConfig

# Create a LyricsDl instance with default configuration
ldl = LyricsDl()

# Create a LyricsDl instance with a custom configuration
config = LyricsDlConfig(order=["kugou"])
ldl = LyricsDl(config=config)

Fetching Lyrics for a Song

from lrc_dl import Song

# Create a Song object
song = Song(title="Where'd All The Time Go?", artist="Dr. Dog")

# Fetch lyrics for the song
lyrics = ldl.fetch_lyrics(song)

if lyrics:
    print(lyrics)
else:
    print("Lyrics not found")

Processing a File

from pathlib import Path

# Define the path to the song file
file_path = Path("/path/to/song.mp3")

# Process the file
ldl.process_file(file_path)

Processing a Directory

from pathlib import Path

# Define the path to the directory
dir_path = Path("/path/to/songs/directory")

# Define the extensions of music files
extensions = ["mp3", "wav"]

# Process the directory
ldl.process_directory(dir_path, extensions)

For more detailed information on the usage of the LyricsDl class, Song class, and LyricsDlConfig class, you can explore the source code. The code is written with Python typing, making it easy to understand.

Configuration

By default, lrc-dl searches for the configuration file at $XDG_CONFIG_HOME/lrc-dl/config.toml. You can specify custom config location using -c flag.

The configuration is using the TOML format. Global provider parameters (for example, services order) are defined under the [providers] section. To change provider-specific configuration, add a [providers.provider_name] section and set the required parameters under it.

As an example, to enable the musixmatch provider, you'll need to acquire a Musixmatch token and create a config like this:

[providers]
order = ["musixmatch", "kugou"]
delay = 10  # Seconds to wait between searches
prepend_header = true  # Prepend lrc-dl's & provider's header to keep track of lyrics source

[providers.musixmatch]
token = "YOUR_TOKEN"