Create YouTube Playlists of Music Charts

This is a Python script that will download some of the current Billboard charts and create YouTube playlists containing videos for all the songs for the charts. If it is run regularly, it will create new playlists each week for the current Billboard charts.

When run, the script downloads the current charts from RSS feeds on the Billboard website. For each chart, it searches YouTube for a video of each song and adds the first result to a dated playlist of the chart for the current week.

The script creates playlists for these charts:

• Hot 100
• Pop
• Dance/Club Play
• R&B/Hip-Hop
• Rock

An example of what the script creates can be seen here:

http://www.youtube.com/user/GimmeThatHotPopMusic

Dependencies

This script depends on Python 2.7 and these Python packages:

• Google API v3 Client Library for Python
• billboard.py
• oauth2client

Usage

1. Clone the git repository.

2. Install the Python dependencies with pipenv. Run this command within the root directory of the repository:

   $ pipenv install

3. Create a new project in the Google Developer Console by clicking the "Select a project" dropdown in the header and clicking the "Create a project" button. Give the project any name you like. After creating the project, open it if it isn't opened automatically.

4. Enable the Youtube Data API v3 in the Library tab of your Google Developer Console. Open the "Library" tab, then click the "Youtube Data API v3" link and click the "Enable" link.

5. Create an API key. Go to the Credentials tab in the Google Developer Console and click "Create credentials". Click "API key" link.

6. Create a new client ID. Still on the Credentials tab of the Google Developer console, click the "Create credentials" dropdown. Select "OAuth client ID" from the list and select the application type "Other". Click the "Create" button. Click "OK" in the modal dialog that appears. The new client ID should appear on the Credentials page. Click the "Download JSON" button for your new client ID. A download of the JSON key will start in your browser. Save the file with the name client_secrets.json in the root directory of your clone of the git repository.

7. Copy settings-example.cfg to settings.cfg and fill in the API key you created in step #5. Then run:

   $ pipenv run python createbillboardplaylist.py --noauth_local_webserver

8. Before the first time you run the script, you will need to create a YouTube channel. Go to any YouTube video and click the "Add to playlist" icon below the video. This will prompt you to create your channel.

9. The first time you run the script, you will have to authenticate the application in a web browser. Open the URL that the script outputs, approve the application for the YouTube Account in which you want to create the playlists, and enter the verification code on the command line. This will create a file, oauth2.json, which must be kept in the root of the git repository as long as you want to upload playlists to this account.

10. In subsequent runs of the script, you can run it without any command line arguments:

    $ pipenv run python createbillboardplaylist.py

Troubleshooting

If the script was working, but you start getting HttpError 404 responses with the message "Channel not found.", you may have to re-authorize the application. Do this by deleting the oauth2.json file and running the script with --noauth_local_webserver.

Development

Coding Style

The code in the script is written to follow the PEP8 style guide. Both pylint and flake8 are used to check the coding style. You can install both of them with pipenv if you include development packages:

$ pipenv install --dev

Then you can run them both with pipenv:

$ pipenv run pylint *.py
$ pipenv run flake8 *.py

Testing

The tests are written using the unittest module and can be run with this command:

$ pipenv run python createbillboardplaylist_test.py

License

This code is free software licensed under the GPL 3. See the LICENSE.md file for details.