Metadata-Version: 2.1
Name: lyricsgenius
Version: 1.0.0
Summary: Download lyrics and metadata from Genius.com
Home-page: https://github.com/johnwmillr/lyricsgenius
Author: John W. Miller
Author-email: john.w.millr@gmail.com
License: MIT
Description: # LyricsGenius - a Python client for the Genius.com API
        [![Build Status](https://travis-ci.org/johnwmillr/LyricsGenius.svg?branch=master)](https://travis-ci.org/johnwmillr/LyricsGenius)
        [![PyPI version](https://badge.fury.io/py/lyricsgenius.svg)](https://pypi.org/project/lyricsgenius/)
        [![Python version](https://img.shields.io/badge/python-3.x-brightgreen.svg)](https://pypi.org/project/lyricsgenius/)
        
        ## Setup
        This repository is intended to provide an easy interface for programatically accessing the song information stored on [Genius.com](https://www.genius.com). Check out [my blog post](http://www.johnwmillr.com/scraping-genius-lyrics/) for a more thorough description of the package and its usage.
        
        To use the Genius API you'll need to sign up for a (free) client that authorizes you to [access their API](http://genius.com/api-clients). You'll need to supply your `client_access_token` from Genius when using this module. See [Usage](https://github.com/johnwmillr/LyricsGenius#usage) below for an example.
        
        ## Installation
        *LyricsGenius* requires Python 3.
        
        Install the package via [PyPI](https://pypi.python.org/pypi/lyricsgenius) using `pip`:
        
        ```bash
        pip install lyricsgenius
        ```
        
        Or, install the latest version from GitHub:
        
        ```bash
        pip install git+https://github.com/johnwmillr/LyricsGenius.git
        ```
        
        ## Usage
        Import the package and search for songs by a given artist:
        
        ```python
        import lyricsgenius as genius
        api = genius.Genius("my_client_access_token_here")
        artist = api.search_artist("Andy Shauf", max_songs=3)
        ```
        
        Search for a single song by the same artist:
        
        ```python
        song = api.search_song("To You", artist.name)
        ```
        
        Add the song to the artist object:
        
        ```python
        artist.add_song(song)
        ```
        
        Save the artist's songs to a JSON file:
        
        ```python
        artist.save_lyrics()
        ```
        
        You can also call the package from the command line:
        
        ```bash
        export GENIUS_CLIENT_ACCESS_TOKEN="my_client_access_token_here"
        python3 -m lyricsgenius --help
        ```
        
        Search for and save lyrics to a given song:
        
        ```bash
        python3 -m lyricsgenius song "Begin Again" "Andy Shauf" --save
        ```
        
        Search for five songs by 'The Beatles' and save the lyrics:
        
        ```bash
        python3 -m lyricsgenius artist "The Beatles" --max-songs 5 --save
        ```
        
        ## Example projects
        
          - [Textual analysis of popular country music](http://www.johnwmillr.com/trucks-and-beer/)
          - [What makes some blink-182 songs more popular than others?](http://jdaytn.com/posts/download-blink-182-data/)
          - [Words per song for rap, rock, and country music](https://www.reddit.com/r/dataisbeautiful/comments/8j1r7b/words_per_song_for_rap_rock_and_country_music_oc/)
          - [Sentiment analysis on hip-hop lyrics](https://github.com/Hugo-Nattagh/2017-Hip-Hop)
        
          I'd love to have more examples to list here! Let me know if you've made use of this wrapper for one of your own projects, and I'll list it here.
        
        ## Contributing
        Please contribute! If you want to fix a bug, suggest improvements, or add new features to the project, just [open an issue](https://github.com/johnwmillr/LyricsGenius/issues) or send me a pull request.
        
Keywords: genius api genius-api music lyrics artists albums songs
Platform: UNKNOWN
Classifier: Topic :: Software Development :: Libraries
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
