A bot that scrapes the internet for song lyrics, song names and artists. This program can be either used as a CLI tool to add lyrics to your terminal, or it can be linked with a Twitter account and tweet lyrics automatically.

After cloning this repository, you can run lyricurator in its most simple mode of operation python lyricurator.py --notwitter which will print random lyrics in the terminal.

In order to send lyrics to Twitter, you have to add the following credentials to the file auth.json.

Then you can start lyricurator with the -t/--twitter argument and a tweet will be sent.

You can learn more about how to get your own Twitter application credentials by following this guide's first 2 steps.

• -nt/--notwitter prints lyrics to the console instead of tweeting them.
• -la/--listartists gets a list of all available artists.
• -a/--artist specifies artist to get lyrics for.
• -fs/--fullsong prints the entire lyrics of a song to the console.
• -ls/--listsongs lists all songs for random or user-selected artists.

Check out CONTRIBUTING.md for instructions.