# 🎵 Spotify Integration Setup

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.

Open Spotify Dashboard →
2

## Configure the App

Use these values in the Spotify form:

- App name: Social Stream Ninja
- 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:

1. Reveal and copy the Client ID.
2. Reveal the Client Secret and copy it somewhere secure.
3. 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:

1. Open Settings → 🎵 Spotify Integration.
2. Paste your Client ID and Client Secret into the matching fields.
3. 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.