Follow these four steps to connect your Spotify account to Social Stream Ninja. You only need to do this once per Spotify app.
Why do I need my own Spotify app?
Spotify requires every integration to use its own credentials. This keeps your listening history private and under your control.
1
Create a Spotify App
Sign in to the Spotify Developer Dashboard and create a new app.
Description: Integration for displaying Spotify "Now Playing" data
Website: https://socialstream.ninja
Add all of the following Redirect URIs (these cover Electron + hosted flows):
https://socialstream.ninja/spotify.html
http://127.0.0.1:8888/callback
Tip: If you use a custom domain for hosting Social Stream Ninja, add that version of the callback URL as well.
3
Collect Your Credentials
From the Spotify app's Settings tab:
Reveal and copy the Client ID.
Reveal the Client Secret and copy it somewhere secure.
Keep the Spotify dashboard open— you may need it again.
4
Paste the Details into Social Stream Ninja
Back in the Social Stream Ninja popup:
Open Settings → 🎵 Spotify Integration.
Paste your Client ID and Client Secret into the matching fields.
Click Connect to Spotify and follow the prompts.
Once connected you unlock:
Automatic “Now Playing” announcements.
Chat commands such as !song, !nowplaying, and !np.
Future Spotify queue tooling and Streamer.bot automations.
Need to finish an in-progress login?
If Spotify redirects you to a page that says "Processing authorization", just leave that tab open—Social Stream Ninja will finish automatically. If it ever gets stuck, re-run the login and paste the callback URL into the popup’s manual field.