Screen recording inside Obsidian
Record a whole screen, one app window, or a region you draw. Your mic and system audio come along, the cursor can be left out, and the video lands in your vault as WebM, embedded in the note you're writing.
Try it right here
This is a working copy of the plugin's interface, running in your browser. Click the camera in the left ribbon and go through a recording. Nothing is actually captured. The steps panel explains what the real plugin does at each step, and the pipeline under the demo shows the path your settings take.
Meeting notes
Walkthrough of the new export flow for the team:
Record screen
How it works
Obsidian is built on Electron, so the plugin asks Electron's desktopCapturer for your screens and windows and records the one you pick with the browser's MediaRecorder. A region is cut out of each frame before it is encoded, so the file only holds the area you drew.
Chromium always draws the mouse pointer and ignores requests to leave it out. When you turn the cursor off, cap-sort swaps in a small Rust helper built on scap that captures frames without it, using ScreenCaptureKit on macOS, Windows.Graphics.Capture on Windows and PipeWire on Linux. Cropping, audio and encoding stay the same either way.
Video is capped at 1920×1200 and encoded with AV1 when your system supports it (VP9 or VP8 otherwise). The mic and system audio are mixed into one Opus track at 64 kbps.
Measured on macOS 27.3, Obsidian 1.15.1
| Recording | Path | Output |
|---|---|---|
| Screen, cursor on | Chromium | 1920×1200 |
| Screen, cursor off | Rust helper | 1920×1200 |
| Window | both | 1920×1164 |
| Region 50%×40% | both | 960×480 |
| The kitten clip above (window, 7.7 s) | Rust helper | 1920×1080 · 300 KB |
A busy full screen averaged 1.0 to 1.3 Mbps, about 7.5 to 9.5 MB per minute. Windows and Linux builds exist but haven't been tested by hand yet.
Install
Needs Obsidian 1.15 or later on macOS, Windows or Linux. Not available on mobile.
From Community plugins
- Open Settings → Community plugins. If Restricted mode is on, click Turn on community plugins.
- Click Browse and search for cap-sort.
- Click Install, then Enable.
- On macOS, allow Obsidian under Privacy & Security → Screen Recording when asked.
cap-sort has been submitted to the community directory. Until it's listed, add th3r-dev/cap-sort with BRAT, or copy main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/cap-sort/.
What goes over the network
Only the cursor helper, and only after you click Download helper. It comes from this project's GitHub releases and is stored in the plugin folder. Recordings never leave your vault.
npm install && npm run build cd helper && cargo build --release