lyricsgenius 1.2.0

Download lyrics and metadata from Genius.com

LyricsGenius: a Python client for the Genius.com API

lyricsgenius provides a simple interface for the song, artist, and lyrics data stored on Genius.com.

Setup

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.

Installation

lyricsgenius requires Python 3.

Install the package via PyPI using pip:

pip install lyricsgenius

Or, install the latest version from GitHub:

pip install git+https://github.com/johnwmillr/LyricsGenius.git

Usage

Import the package and search for songs by a given artist:

import lyricsgenius as genius
api = genius.Genius("my_client_access_token_here")
artist = api.search_artist("Andy Shauf", max_songs=3)
print(artist.songs)

Search for a single song by the same artist:

song = api.search_song("To You", artist.name)
print(song.lyrics)

Add the song to the artist object:

artist.add_song(song)

Save the artist's songs to a JSON file:

artist.save_lyrics()

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

Example projects

• Trucks and Beer: A textual analysis of popular country music
• 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?

Contributing

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.