Smart playlist generator for Spotify
Features - Spotify login
- Generate playlists based on artist, track or playlist seeds
- Generate playlists based on personal playlist as a seed
- Tune parameters like popularity, mood, energy, etc. to further customize the playlist
Algorithm to generate similar playlists
- Feature range calculation
- Get all tracks in the playlist from the Spotify API
- Query Spotify for different track features
- Calculate the 0.1 and 0.9 quantile range for each feature
- Use these as min and max targets for each feature
- Extract most relevant artists and tracks as seeds
- Find the frequency of artists and tracks in:
- Playlist
- User profile / listening history: short, medium, long term
- Select most frequently appearing artists and tracks that exist in the playlist
- Find the frequency of artists and tracks in:
- Query Spotify API with the calculated seeds and parameter values
Installation
Clone
git clone https://github.com/rtkg12/remixr.git
Pre-requisites
- Make a developer account at https://developer.spotify.com and obtain the
Client IDandClient Secret - Update
client/.envandserver/app.envaccordingly.
| Property | Description |
|---|---|
| REACT_APP_API_URL | Use /api for default configuration. Replace with backend server address for custom deployment |
| REACT_APP_TRACKING_ID | optional Google Analytics Tracking Id |
| CLIENT_URL | Address of the client application |
| REDIRECT_URI | Callback endpoint for Spotify authentication. Note Make sure this matches the Redirect URL in the Spotify API console |
Installation
yarn install
Building and developing locally
Configuration
| Environment variable | Value |
|---|---|
| REACT_APP_API_URL | http://localhost:8080/api |
| CLIENT_URL | http://localhost:3000 |
| REDIRECT_URI | http://localhost:8080/api/callback |
Running the project
yarn develop
The React app should start running in port 3000 and the Node.js app will be running in 8080
Deploying to Production
Configuration
| Environment variable | Value |
|---|---|
| REACT_APP_API_URL | /api |
| CLIENT_URL | http://PUBLIC_URL |
| REDIRECT_URI | http://PUBLIC_URL/api/callback |
Deploying
yarn deploy
This will build the React app and serve the build folder from Express. Express should be running in port 8080
Future Areas of Improvement
- Add support for greater than five seeds using random sampling from generated playlists
- Functionality to add individual songs to library directly from the app
- Regenerate, re-order and edit the playlist dynamically before saving
- Session-wide playlist building. Add songs from multiple queries, save in the end
- Algorithm improvements - different statistical measures, collaborative filtering
Contribute
Please feel free to open an issue/pull request if you wish to work on any of the above features, or if you have any other suggestions for improvement.