Skip to main content

A command line tool to fetch lyrics from Genie

Project description

lyriks License PyPI version PyPI downloads

A command line tool that fetches lyrics from Genie.


You can easily install lyriks from PyPI by using pip:

pip install lyriks

To install it from source instead, clone the repository and build the wheel before installing it with pip:

python -m build --wheel
pip install dist/lyriks-0.3.4-py3-none-any.whl

You can also run the script directly from within the repository:

`./ /path/to/music/folder`

Make sure to first install the required dependencies from pyproject.toml.


Simply run the script with the path to the folder containing your music as an argument. This can be your whole collection, a single artist, or a single album.

lyriks /path/to/music/folder

The script will search for audio files (.flac or .mp3) in the given folder, and attempt to fetch the lyrics. Note that it will only be able to do that for files that are properly tagged with MusicBrainz MBIDs (specifically musicbrainz_releasegroupid and musicbrainz_trackid). It then uses them to resolve the Genie album ID from the release or release group on MusicBrainz. Thus, at least one release in the release group must have a URL relationship to the album on Genie.

If successful, the lyrics will be downloaded and stored next to the audio files with the appropriate extension (.lrc or .txt, depending on whether they're synced or not).

Exclude files and folders

You can recursively ignore folders by adding a (empty) .nolyrics file inside the folder you want to exclude. This can be useful for Western artists, where Genie is unlikely to have lyrics, or for instrumental releases.

Likewise, you can ignore specific songs by creating a file with the same name as the audio file but the extension changed to .nolyrics. For example, a track named 01 Song.flac can be excluded by creating a file named 01 Song.nolyrics.

Excluded files won't be queried at all, which can noticeably speed up the synchronisation process for large collections.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lyriks-0.3.4.tar.gz (22.2 kB view hashes)

Uploaded Source

Built Distribution

lyriks-0.3.4-py3-none-any.whl (22.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page