Presence

Presence is a service for getting the current Spotify/Listening status of users in our Discord Server. It connects a Discord Bot (with Presence Intent) to the Gateway and exposes it via REST and WebSocket.

Note

Presence is only available for users in our server. You can try this for yourself by joining our Discord.

Endpoints

• WebSocket stream: WS /ws/v1/{DISCORD_USER_ID} (personally use websocat to test in dev)
• REST snapshot: GET /v1/{DISCORD_USER_ID} (only works with pre-existing websocket subscriber, this is intentional by design)
• Check if user in server: GET /v1/{DISCORD_USER_ID}/in_server
• Health: GET /health

Usage

Response

{
  "user_id": "492731761680187403",
  "spotify": {
    "track": "A Shoulder to Cry On",
    "artist": "Dance Gavin Dance",
    "album": "Pantheon",
    "album_art_url": "https://i.scdn.co/image/ab67616d0000b273bb86aa29f862c224e21b96d8",
    "started_at_ms": 1766447419972,
    "ends_at_ms": 1766447701646
  },
  "timestamp_ms": 1766447420190
}

Development

# copy env, fill in credentials
cp .env.example .env

# (DOCKER IS NEEDED) start redis + run the app
./dev.sh

Caching

Presence uses Redis for caching with automatic fallback to in-memory if Redis is unavailable. On startup, the app waits up to 10 seconds for Redis before falling back.

Check /health to see current Redis status:

{"status": "ok", "redis": true}

Why this approach?

This avoids dealing with Spotify OAuth in general while still providing real-time listening data, within Discord’s limitations.

This idea for the implementation is heavily inspired by Lanyard which I (dromzeh) personally use on my own site to display what I'm currently listening to.

License

antifield/presence is licensed under the GNU Affero General Public License v3.0. Authored by @dromzeh.

You must state all significant changes made to the original software, make the source code available to the public with credit to the original author, original source, and use the same license.

© 2025 Antifield LTD | Registered UK Company No. 15988228 | ICO Reference No. ZB857511