cap-sort

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.

About 7.5–9.5 MB per minute of busy screen AV1 + Opus in WebM macOS, Windows, Linux

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 · My vault

Meeting notes

Walkthrough of the new export flow for the team:

0 backlinks12 words
Source
Screen
desktopCapturer
Video
Chromium
cursor drawn
Crop
Whole frame
no crop
Audio
Mic + system
mixed, one track
Encode
AV1 + Opus
≤1.73 Mbps
Vault
WebM
embedded in note

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

RecordingPathOutput
Screen, cursor onChromium1920×1200
Screen, cursor offRust helper1920×1200
Windowboth1920×1164
Region 50%×40%both960×480
The kitten clip above (window, 7.7 s)Rust helper1920×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

  1. Open Settings → Community plugins. If Restricted mode is on, click Turn on community plugins.
  2. Click Browse and search for cap-sort.
  3. Click Install, then Enable.
  4. 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