1.6 KiB
Nicole - Lyrics Scraper
Overview
Nicole is a program that searches for lyrics and writes them into the mp3-tag "USLT". There is a 5 second delay between each request to azlyrics.com because the site will block your ip if there are too many requests.
History
Nicole can create a history of all files that were processed in ~/.configs/nicole.
If a file is in the history, it will be skipped unless ignore_history=True.
If the lyrics for a file can not be obtained, it is added to ~/.configs/nicole/failed_files.
Those files are not skipped, the file only exists so that you can see which lyrics were not downloaded.
azlyrics
Nicole creates a azlyrics.com url from the title and artist mp3-tags of the file. The lyrics are extracted from the html document using regex.
Usage
Command line options: -d [directory] process directory [directory] -f [file] process file [file] -r go through directories recursively -s silent, no command-line output -i ignore history -n do not write to history -o overwrite if the file already has a comment -h show this If you do not specify a directory or file, the program will ask you if you want to use the current working directory.
Installation
Clone this repository and install it using python-pip. pip should also install https://github.com/seebye/mutagen, which is needed to read and write the mp3-tags.
cd ~/Downloads
git clone https://github.com/MatthiasQuintern/nicole.git
cd nicole
python3 -m pip install .
You can also install it system-wide using sudo python3 -m pip install.
Importand Notice
This software comes with no warranty!