BetterRadio

Recommendation focused music player powered by Spotify Web API

Table of Contents

1. About The Project
   • Key Features
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Contact
4. Acknowledgements

About The Project

BetterRadio is an app that finds the songs you love. Customise, create, and discover new playlists based on your favorite artists and genres.

Key Features

• Discover: Get an array of playlists based on the top genres you listen to. Each playlist will contain 15-20 songs corresponding to a group of similar genres.
• Create: Generate your own playlists based on any number of songs, and customise them with up to 14 different unique track attributes i.e. popularity, energy, danceability.
• Browse: Search for songs, and browse through the top tracks from your favorite artists. Search results are filtered based on your top artists and listening preferences.
• My Radio: See and play all your custom playlists, and get the option to add them to your own Spotify account.

Built With

• React
• Django
• Spotify Web API

Getting Started

Contact [email protected] to request access for the public version, which is available here.

To get a local copy up and running follow these simple steps.

Prerequisites

• Spotify Premium
• Desktop Computer with Chrome/Firefox/Edge/Internet Explorer (required for in-app playback)
• npm

  npm install npm@latest -g

• Python virtual environment

  python3 -m venv env
  source env/bin/activate

Installation

1. Clone the repo

   git clone https://github.com/colin-ho/BetterRadio.git

2. Install NPM packages

   npm install

3. Install Python packages

   pip install -r requirements.txt

4. Create .env file containing environment variables listed in spotify/credentials.py

   touch .env

5. Make migrations and run backend server

   python manage.py migrate
   python manage.py runserver

6. Start frontend

   npm start

Contact

• Colin Ho - Linked-In - [email protected]

Acknowledgements

• React-Spotify-Web-Playback
• Material-UI