Status Your Spot

Simple FastAPI server that signs in with Spotify and shows your live now-playing track.

Setup

1. Create a Spotify app: https://developer.spotify.com/dashboard
2. Set the redirect URI to http://localhost:8000/callback in the Spotify app.
3. Create a Slack app: https://api.slack.com/apps
4. Add a redirect URL: http://localhost:8000/slack/callback
5. Under OAuth & Permissions, add user scopes: users.profile:read, users.profile:write
6. Copy .env.example to .env and fill in your values.
7. Install dependencies:

pip install -r requirements.txt

5. Run the server:

uvicorn main:app --reload --port 8000

Open http://localhost:8000

Notes

• Tokens and sync preferences are stored in a local SQLite file (default app.db).
• Background sync runs on the server every 5 seconds and keeps Slack updated even when the tab is closed.
• This is not production hardened. Use HTTPS and server-side storage in production.

Optional settings

• DB_PATH to change the SQLite file location (default app.db).
• SYNC_INTERVAL_SEC to change the sync cadence (default 5).