- Overview
- Scorecard
- Updates9
Show your Obsidian activity on Discord via Rich Presence — vault name, file, edit/reading mode and an elapsed timer, directly in your Discord profile.
Features
- Vault name and current file shown in Discord
- Edit / Reading mode detection — shown as icon and status text
- Canvas file support —
.canvasfiles tracked correctly, no stale presence on view switch - Elapsed timer — total session or per-file
- Auto-reconnect every 15 seconds if Discord restarts
- Status bar indicator (green/red/yellow) with click-to-reconnect or pause
- Pause mode — hide presence via status bar, settings button, or command palette
- Idle detection — show AFK or clear presence after configurable inactivity timeout
- Exclusion list — hide files or folders from Discord, supports glob patterns (
Journal/**,*.canvas) - Custom status format —
{file},{fileNoExt},{folder},{vault},{mode},{wordCount},{lineCount},{meta:key} - Swap image layout — flip editing/reading icon and Obsidian logo positions
- Up to 2 custom profile buttons (e.g. "View Repository")
- Custom Discord Application support (bring your own Client ID + images)
Settings
| Setting | Description |
|---|---|
| Discord Client ID | Your own Discord Application ID for custom images. Leave empty for the default. |
| Show vault name | Toggle vault name in Discord status |
| Custom vault name | Override the displayed vault name |
| Show file name | Toggle current file name in status |
| Show file extension | Toggle .md extension in file name |
| Per-file timer | Reset timer on each new file vs. total session time |
| Show connection notices | Show notice on Discord connect |
| No file open text | Text shown when no file is active. Default: No file open |
| Swap image layout | Flip editing/reading icon and Obsidian logo positions |
| Details format | Custom top line, e.g. Editing {fileNoExt} |
| State format | Custom bottom line, e.g. {mode} in {vault} ({wordCount} words) |
| Excluded patterns | One pattern per line. Supports plain text and globs (Journal/**, *.canvas) |
| Enable idle detection | Toggle idle detection |
| Idle timeout | Minutes of inactivity before going idle |
| When idle | Show "Away from keyboard" or clear presence entirely |
| Button 1 / 2 label | Text shown on the button (max 32 characters) |
| Button 1 / 2 URL | Link opened when the button is clicked (must start with https://) |
Custom format placeholders
| Placeholder | Description |
|---|---|
{file} |
Full file name including extension |
{fileNoExt} |
File name without extension |
{folder} |
Parent folder path |
{vault} |
Vault name |
{mode} |
Editing or Reading |
{wordCount} |
Live word count |
{lineCount} |
Live line count |
{meta:key} |
Any frontmatter value, e.g. {meta:project} |
Profile Buttons
Add up to 2 clickable buttons to your Discord profile card.
- Open Settings → Community Plugins → Discord RPC → Profile Buttons
- Enter a label (e.g.
View Repository) and URL (e.g.https://github.com/yourname/yourrepo) - Leave label or URL empty to disable a button
Note: Discord does not show your own buttons on your own profile — ask someone else to verify they appear.
Custom Discord Application
By default the plugin uses a shared Discord Application with the Obsidian logo. To use your own images and branding:
- Go to discord.com/developers/applications and create a new application
- Under Rich Presence → Art Assets, upload images with these exact key names:
| Key | Used for |
|---|---|
obsidian |
Main large image |
editing |
Small icon in Edit mode |
reading |
Small icon in Preview/Reading mode |
- Copy your Application ID and paste it into the Discord Client ID setting
Installation
Obsidian Community Store (recommended)
- Settings → Community Plugins → Browse → search for
Discord RPC - Click Install, then Enable
- Make sure Discord is running — the status bar should turn green
Manual
- Download
main.js,manifest.json,styles.cssfrom the latest release - Copy to
.obsidian/plugins/discord-rpc/in your vault - Enable Discord RPC in Settings → Community Plugins
Requirements
- Obsidian 1.4.0 or higher
- Desktop only (Discord IPC is not available on mobile or web)
- Discord must be running locally
Development
git clone https://github.com/30jannik06/Obsidian-Presence
cd Obsidian-Presence && pnpm install
pnpm dev # watch mode with sourcemaps
pnpm build # production build
pnpm lint # ESLint check
pnpm format # Prettier format
Changelog
v1.4.0
- Canvas file support —
.canvasfiles tracked correctly - New placeholders:
{folder},{wordCount},{lineCount},{meta:key} - Swap image layout setting
- Glob pattern support in exclusion list
- Configurable "no file open" text
v1.3.5
- Sentence case fixes in all UI strings (Obsidian marketplace compliance)
v1.3.0
- Pause mode (status bar, settings button, command palette)
- Idle detection with configurable timeout and action
- Exclusion list for private files/folders
- Custom status format with placeholders
v1.2.0
- Live connection status in settings tab (🟢/🔴)
- Reconnect button and command palette entry
- Up to 2 configurable profile buttons
v1.1.0
- Initial public release
Inspired by obsidian-discordrpc by lukeleppan (MIT). Rewritten from scratch as the original has not been maintained since 2022.
88%
HealthExcellent
ReviewSatisfactory
About
Show Obsidian activity on Discord via Rich Presence, displaying vault and file name, edit/preview mode, and elapsed timers. Use auto-reconnect, idle detection, pause mode and exclusion lists for privacy, and add custom status formats, up to two profile buttons, or a custom Discord app for personalized presence.Details
Current version
1.4.0
Last updated
2 days ago
Created
Last month
Updates
9 releases
Downloads
28
Compatible with
Obsidian 1.4.0+
Platforms
Desktop only
License
MIT