Start here
A presence shows on Discord what someone is doing on a website or in a Windows program. It is a folder with a manifest and one JavaScript file. Every few seconds the application asks your script what is happening, and it takes care of Discord.
function read(context) {
const page = bestPage(context.pages);
if (!page) return null;
return { title: page.title };
}
function activity(seen) {
return { details: cut(seen.title), kind: "watching" };
}That is a complete script. read collects what it needs, and activity says what the card
shows. You need no Rust, no Node and no build step: save the file and the application loads it.
Where to go#
| You want to | Read |
|---|---|
| Make your first presence, step by step | Your first presence |
| Show a Windows program or a game | Show a Windows program |
| Get a value out of a site | Read a site |
| Fix a presence that shows nothing | When nothing shows |
| Look up a field or a function | Manifest, Script, Helpers |
| Understand what happens behind the card | How it works |
How these pages are organized#
- Start teaches with one guided example.
- Guides each solve one task.
- Reference lists every field, function and limit, in the same shape on every page.
- How it works explains the design behind the rules.
What you need#
- Windows 10 or 11, with the Discord desktop app open.
- Rich Presence Plus installed.
- A code editor. Visual Studio Code also explains each function as you type.
- For websites, the browser extension, connected from the Browser page of the application.