A simple way to display the current Spotify song on your stream!
- Fast song change detection
- Animations when changing songs
- Text Scrolling when song name is too long
- Loading animation for slow networks
- Python 3.8, 3.9, 3.10 or 3.11
- websockets
- spotipy
Ensure that a valid version of Python is installed.
Install the package requirements using:
pip install -r requirements.txtNext, you need to setup a Spotify developer account to be able to get the current song information.
- Head to https://developer.spotify.com/dashboard
- Create a new app (https://developer.spotify.com/documentation/web-api/tutorials/getting-started#create-an-app)
- Set the callback URL to
http://localhost:8888/callback - Create a file called
.env - Put your client_id in the first line
- Put your client_secret in the second line
You should be all ready to go now!
Once pip has finished installing all the required packages, run server.py using:
python server.pyThis will start the server needed for the webpage to communicate with it.
To integrate with OBS (or other similar streaming software), simply add index.html as a local file browser source.


