@chirag127/lanyard

Lanyard Discord presence API client.

Install

npm i @chirag127/lanyard

Usage

import { getPresence, watchPresence } from '@chirag127/lanyard';

// One-shot fetch
const data = await getPresence('799956529847205898');
// data.discord_status — 'online'|'idle'|'dnd'|'offline'
// data.activities     — array of activity objects
// data.discord_user   — { username, avatar, id }
// data.spotify        — { song, artist, album, album_art_url } | null

// Poll every 30s
const stop = watchPresence('799956529847205898', (data) => {
  console.log(data.discord_status);
});
// stop() to cancel

API

getPresence(userId)

GET https://api.lanyard.rest/v1/users/{userId}. Returns presence data or null.

watchPresence(userId, callback, interval = 30000)

Polls every interval ms. Calls callback(data) on each successful fetch. Returns a stopFn.