https://github.com/nielsdejong/neo4j-playlist-builder
A tool to dynamically generate Spotify playlists using Neo4j graph data science.
https://github.com/nielsdejong/neo4j-playlist-builder
Last synced: 26 days ago
JSON representation
A tool to dynamically generate Spotify playlists using Neo4j graph data science.
- Host: GitHub
- URL: https://github.com/nielsdejong/neo4j-playlist-builder
- Owner: nielsdejong
- License: apache-2.0
- Created: 2020-09-18T09:31:55.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-01-21T08:06:42.000Z (over 3 years ago)
- Last Synced: 2025-05-08T00:06:11.162Z (26 days ago)
- Language: Python
- Size: 46.9 KB
- Stars: 9
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## neo4j-playlist-builder
A tool to generate Spotify playlists using Neo4j graph data science.
Taking a single (large, public) playlist as an input, the tool uses node similarity algorithms and kmeans clustering to group songs based on genre, energy and mood.
The script is set up to be a complete end-to-end tool for organizing your music:
- It loads your data directly into Neo4j using the Spotify API...
- ...runs graph algorithms to build playlists...
- ...uses keywords to name playlists...
- ...and eventually creates new playlists in Spotify.
### Quick setup
This project uses a single Python script: `neo4j_spotify_playlist_builder.py`.
In here, you specify the parameters needed to connect to your spotify account using the Spotify API:
```
user_id = "[ADD YOUR SPOTIFY USER ID HERE]"
client = "[ADD YOUR SPOTIFY CLIENT ID HERE]"
secret = "[ADD YOUR SPOTIFY CLIENT SECRET HERE]"
playlist_uri = "[ADD YOUR PUBLIC PLAYLIST TO SORT HERE]"
```
Steps:
1. Your `user_id` can be found by using the web version of spotify and going to your profile overview. A spotify user id will look something like this: `111306XXXXX`
2. You need the Spotify developer dashboard to obtain a client id/secret. You can access it here: https://developer.spotify.com/dashboard/login. Next, create an app to obtain a `client_id` and a `client_secret`.
3. Your public `playlist_uri` can be found using the spotify application. Right click a playlist, select 'Share' and click 'Copy Spotify URI'. Your URI will have the following format: `spotify:playlist:XXXXXXXXXXXXXXXXXX`
4. Ensure that your Spotify developer app has the right `redirect_url` configured. For this tool to work, go to the Spotify developer dashboard and open the app you created. Click 'edit settings', and add the following url to "Redirect URIs": http://localhost:8888/callback.
5. Set up your Neo4j connection in `neo4j_spotify_playlist_builder.py`:
```
neo4j_url = "bolt://localhost:7687"
neo4j_username = "neo4j"
neo4j_password = "neo"
```
Keep in mind this application clears your database, so best use a fresh DB.
**Ensure that your Neo4j installation has the Neo4j Graph Data Science plugin installed!**
6. Install python dependencies in `requirements.txt`.
7. Run `neo4j_spotify_playlist_builder.py` and watch the magic happen!
### Notes
- An input playlist *must* be made public for the tool to work. Output playlists will be private by default.
- The tool can also be run without creating new playlists in Spotify by disabling the `write_to_spotify` parameter.