← API docs

No presence yet. If this stays empty, the user probably hasn't joined discord.gg/lanyard yet — that's what lets the card track them.

live · free for friends

Now-Playing API

The same Discord presence card from my homepage — but pointed at your Discord. Give it your user ID and you get a live card with your status, Spotify, games, what you're coding, badges, the lot. No accounts, no keys, no Google Sheet.

1. Join Lanyard

The card reads your presence through Lanyard, which only tracks people in its Discord server. So join you will need to join it and stay there for it to work. Join at: discord.gg/lanyard.

2. Grab your user ID

In Discord: Settings → Advanced → Developer Mode (turn it on), then right-click your name and Copy User ID. It's a long number like 1464890289922641993.

3. Use your card

Three ways to point it at your ID — all do the same thing:

https://clove.is-a.dev/api/YOUR_ID      ← prettiest
https://clove.is-a.dev/api/?u=YOUR_ID
https://clove.is-a.dev/api/#YOUR_ID

Pick a theme by adding ?theme=mocha (default), macchiato, frappe, or latte:

https://clove.is-a.dev/api/YOUR_ID?theme=latte

Embed it anywhere

Drop it into Notion, a website, an OBS browser source, a README iframe — anywhere that takes HTML or a URL:

<iframe
  src="https://clove.is-a.dev/api/YOUR_ID"
  style="border:0;width:340px;height:360px"
  title="my Discord presence"></iframe>

Want it on your own page without the iframe? Add a mount + the two files and pass your ID via data-user:

<link rel="stylesheet" href="https://clove.is-a.dev/api/api.css">
<div id="now-playing"></div>
<script src="https://clove.is-a.dev/api/now-playing.js"
        data-user="YOUR_ID"></script>

What it shows

Avatar, decoration & status dot · display name (incl. Discord's gradient name styles) · server tag · active platforms (desktop/mobile/web) · Discord badges (Nitro, boosts, etc. via dstn) · custom status · live Spotify with a progress bar · what game you're playing · what you're coding (VS Code) · streaming. The card auto-tints to your Spotify album art.

Notes & limits

← back to clove.is-a.dev