LyricsGenius: a Python client for the Genius.com API
lyricsgenius provides a simple interface to the song, artist, and lyrics data stored on Genius.com.
Before using this package you'll need to sign up for a (free) account that authorizes access to the Genius API. The Genius account provides a
client_access_token that is required by the package. See the Usage section below for examples.
lyricsgenius requires Python 3.
pip to install the package from PyPI:
pip install lyricsgenius
Or, install the latest version of the package from GitHub:
pip install git+https://github.com/johnwmillr/LyricsGenius.git
Import the package and search for songs by a given artist:
import lyricsgenius genius = lyricsgenius.Genius("my_client_access_token_here") artist = genius.search_artist("Andy Shauf", max_songs=3, sort="title") print(artist.songs)
Search for a single song by the same artist:
song = genius.search_song("To You", artist.name) print(song.lyrics)
Add the song to the artist object:
Save the artist's songs to a JSON file:
There are various options configurable as parameters within the
genius.verbose = False # Turn off status messages genius.remove_section_headers = True # Remove section headers (e.g. [Chorus]) from lyrics when searching genius.skip_non_songs = False # Include hits thought to be non-songs (e.g. track lists) genius.excluded_terms = ["(Remix)", "(Live)"] # Exclude songs with these words in their title
You can also call the package from the command line:
export GENIUS_CLIENT_ACCESS_TOKEN="my_client_access_token_here" python3 -m lyricsgenius --help
Search for and save lyrics to a given song:
python3 -m lyricsgenius song "Begin Again" "Andy Shauf" --save
Search for five songs by 'The Beatles' and save the lyrics:
python3 -m lyricsgenius artist "The Beatles" --max-songs 5 --save
- Trucks and Beer: A textual analysis of popular country music
- Neural machine translation: Explaining the Meaning Behind Lyrics
- What makes some blink-182 songs more popular than others?
- Sentiment analysis on hip-hop lyrics
- Does Country Music Drink More Than Other Genres?
- 49 Years of Lyrics: Why So Angry?
Please contribute! If you want to fix a bug, suggest improvements, or add new features to the project, just open an issue or send me a pull request.