billboardify

This application allows users to save their favorite weeks of the Billboard Top 50 (1980-) to their Spotify account using the Spotify Web API.

Try out Billboardify

Spotify API

Billboardify uses the following parts of the Spotify Web API

MongoDB

Billboardify uses MongoDB Realm and Atlas to store Billboard Top 50 information, and uses the Anonymous authentication provider to access data.

Python Web Scraper

The Billboard data used by Billboardify was obtained using Python. The only 3rd party packages necessary are Spotipy and lxml. All project data is in the data folder of the repo.

Install requirements from project root directory pip install -r requirements.txt
Navigate to scraper folder cd ./data/scraper
Run the scraper to build your own dataset from scratch python scraper.py

Development

Clone the repository git clone https://github.com/kyleschan/billboardify.git
Install necessary npm/yarn packages yarn install
Switch to root directory cd billboardify
Run development server on localhost:3000 yarn start

Billboardify is built on create-react-app

Deployment

Billboardify is deployed on Github Pages using this tutorial
After following the steps in the tutorial above, switch to project root cd billboardify
Run yarn run deploy

Photo Credits

Concert Photo by Aditya Chinchure on Unsplash

Vinyl Photo by Georgios Kaleadis on Unsplash

License

MIT

Thanks to Replayify for their styling!

kyleschan/billboardify