MP3Lyrics is a tool written in Ruby (currently only CLI) to download song lyrics from AZLyrics or Genius. The lyrics are added to the mp3 file via the USLT (Unsynchronised lyric/text transcription) tag (with the power of ruby-mp3info).
Because I wanted to try another language than Java.
Although they have got a pretty neat REST API the lyrics can't be fully retrieved, most likely due to licensing issues.
They no longer offer an API since January 2016. The site has since been shut down as of October 2020.
Simply because they charge me (the developer) for retrieving the lyrics.
The site has been shut down as of July 2021.
They do not offer fetching lyrics via the API (yet).
Either they were tied to iTunes and ugly DLL libraries, outdated/inactive, closed source or not cross platform. I'm mainly developing on my MacBook and my iTunes library is on my Windows system. I need something that works anywhere.
By dropping the need (and support) of iTunes running somewhere in the background, the tool is more lightweight.
- Bundler
- Nokogiri for HTML parsing
- mp3info as a MP3 library
- require_all for easier requiring of the wiki_api folder
- For testing purposes you should install rubocop, rake, minitest and optionally coverage reporters for CodeClimate
gem install mp3lyrics
mp3lyrics <dir> [-override true/false] [-use genius/azlyrics]
dir is the folder with your music, it's iterated recursively.
override is a boolean toggle to override existing lyrics (defaults to false).
use is a specific wiki to be used to download lyrics (all wikis are used by default).
The same options as above apply, but the binary has to be invoked from
./lib/mp3lyrics.rb
To execute the tests run
bundle exec rake
Add support to other lyrics sites when 404 is returned from LyricWiki- GUI for easier usage (maybe)
- Add test cases, see #1
Built by (c) Tim Brust and contributors. Released under the MIT license.