Skip to content

Commit c173d39

Browse files
committed
Document the Discord status text
1 parent 6856efd commit c173d39

1 file changed

Lines changed: 8 additions & 1 deletion

File tree

‎docs/customization.md‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,14 +36,21 @@ Discord settings (Settings > Discord, saved to `config.json`):
3636

3737
- elapsed, remaining, both or no timestamps (`discord.timestamps`);
3838
- idle behaviour (`discord.idleBehavior`);
39+
- the status text next to your name (`discord.name`) and which line Discord shows there (`discord.statusDisplayType`: `name`, `state` or `details`);
3940
- album art lookup (`discord.artworkLookup`, off by default).
4041

41-
Wording templates, buttons, asset keys and the update interval can't be changed yet. Values for them in `config.json` are ignored, and a settings save removes them.
42+
Wording templates for the other lines, buttons, asset keys and the update interval can't be changed yet. Values for them in `config.json` are ignored, and a settings save removes them.
4243

4344
TV episodes with a known series show the series and episode code, for example "Lost" and "S04E05 · The Constant".
4445

4546
Discord Rich Presence runs locally and communicates with the user's Discord IPC socket. Analytics, when explicitly enabled, sends only one anonymous installation ping.
4647

48+
## Status text
49+
50+
Discord shows `<artist> on <service>` by default, for example "fakemink on Spotify". Films and episodes keep Discord's own app name unless you set a status text. Change it in Settings > Discord > Status text, or set `discord.name` in `config.json`. Leave it empty for the default.
51+
52+
Write fields in braces: `{artist}`, `{title}`, `{subtitle}`, `{album}`, `{year}`, `{series}`, `{season}`, `{episode}`, `{episodeCode}`, `{service}` (Spotify, Navidrome, Plex and so on), `{provider}`, `{mediaType}`, `{state}`, `{stateLabel}`, `{position}`, `{duration}` and `{progressPercent}`. Other text is kept as typed. Write `{{` or `}}` for a literal brace. A field that is not in this list is rejected when you save. The text can be 128 characters at most. With hidden titles on, `{artist}` is blank.
53+
4754
## Privacy
4855

4956
Privacy is applied before formatting. Removed data cannot be restored by card or Discord visibility settings.

0 commit comments

Comments
 (0)