Recme

A screen recorder for Windows that Claude can drive. Recme has its own MCP server built in: connect it once and Claude can start and stop recordings, look at screenshots and frames of what it recorded, cut and rearrange clips, pull the audio out, shrink a file for sharing, and send it to a nearby device. Sharp native-resolution capture, record any area you drag out (or a saved one by name), built-in editor, Wi-Fi sharing. Everything stays on your computer.

⬇️ Download Recme for Windows

Open the newest release at the top (it is a beta), download Recme-Setup-<version>.exe from Assets, run it, done (ffmpeg is included; no other install needed). Windows 10/11, 64-bit. The installer is not code-signed, so SmartScreen may warn: More info → Run anyway. SHA-256 of each installer is in the release notes.

🍎 macOS (experimental, untested)

In the same release, download Recme-<version>-arm64.dmg (Apple Silicon: M1/M2/M3/M4) or Recme-<version>-x64.dmg (Intel), open it and drag Recme to Applications (ffmpeg is included; no Homebrew needed). The macOS version has not been tested on a real Mac yet, so expect problems and please report them.

The app is not notarized, so macOS blocks it the first time: right-click Recme → Open → Open, or run xattr -cr /Applications/Recme.app. On first use allow Screen Recording in System Settings → Privacy & Security, then quit and start Recme again. Details and limits: docs/MACOS.md.

📖 How it works / what it is built with (Thai): docs/HOW-IT-WORKS.md

Why Recme

• Made to be used with Claude. 20 MCP tools: record, screenshot, "show me the whole clip in one picture", cut, extract audio, compress to a size limit, send. Sensitive actions (send, delete, optionally capture) can ask you first.

• Sharp by default. Records at your screen's native resolution (e.g. 2880×1800), never downscales, uses your GPU encoder (NVENC / QSV / AMF) when there is one.

• Record exactly what you need. Whole desktop, one monitor, a dragged area (a red frame shows it while recording, not part of the video), a saved area ("game"), or "wherever that window is right now".

• System sound and microphone, merged into the MP4.

• A small editor. Split, trim, drag pieces to rearrange, waveform lane, "detach audio" in one click, export to fit under 8 / 25 / 100 MB.

• Share on Wi-Fi. LocalSend-style transfers with HTTPS, optional PIN and trusted devices.

• Stays out of the way. Lives in the system tray, global hotkey (default Ctrl+Shift+R), optional start with Windows.

Related MCP server: Screen Vision MCP Server

Help test

Recme is a beta and has only been tried on one PC. If you have a few minutes, see docs/TESTING.md (with a Thai summary) and open a Test report or Bug report. In the app, Record → App → Copy diagnostics collects the details we need (no token, PIN, file or device names).

Install

From an installer: run Recme-Setup-<version>.exe (it already contains ffmpeg). It is not code-signed, so Windows SmartScreen may warn: More info → Run anyway.

From source:

npm install
node node_modules/electron/install.js   # only if npm skipped Electron's download script
npm start

From source you need ffmpeg on the PC (winget install Gyan.FFmpeg). Recordings go to Videos\Recme (changeable in the Library tab).

Connect Claude

The app listens on http://127.0.0.1:7777/mcp (this computer only) and needs a token. The Claude tab shows ready-to-copy commands with your token.

Claude Code

claude mcp add --transport http recme http://127.0.0.1:7777/mcp --header "Authorization: Bearer <TOKEN>"

Claude Desktop: copy the JSON from the Claude tab into claude_desktop_config.json (it uses mcp-remote as a bridge).

Keep Recme running (it hides in the tray when you close the window). Then try:

• "Record my screen for 15 seconds, then show me an overview of the clip."

• "Record the game area for 20 seconds."

• "Cut the last recording to the first 10 seconds and save only the audio as MP3."

• "Make my latest recording small enough to send in a chat (under 25 MB)."

MCP tools (20)

Sources for start_recording / take_screenshot: desktop, display, region, area (saved name), window_area (where a window is now), window.

Videos cannot be returned to a chat as video: Claude gets frames and overviews as pictures and the file path as text. In the Claude Code desktop app it can also hand you the file.

Command line: recme

Everything Claude can do, you can script. recme talks to the running app through the same local MCP server (same token, same confirmations).

recme start --area game --max-seconds 30     # or --display 0, --region x,y,w,h, --window-area Unity
recme stop
recme list
recme trim rec_2026-01-01.mp4 --keep 0-5,12-30 --mute
recme compress rec_2026-01-01.mp4 --mb 25
recme send rec_2026-01-01.mp4 "My Phone"
recme help                                   # all commands; `recme call <tool> '{json}'` reaches any MCP tool

• Installed with the setup program: run powershell -ExecutionPolicy Bypass -File scripts\install-cli.ps1 (from a clone) once, then open a new terminal. It adds recme to your user PATH (no admin rights) and uses Recme's own runtime, so Node.js is not needed. -Uninstall removes it. Limitation: in that mode the exit code is not reliable.

• From a clone: npm install && npm link gives a recme command backed by Node.js, with proper exit codes (0 ok, 1 tool error, 2 bad command, 3 app not reachable).

• It reads the token and port from Recme's config.json; override with RECME_URL / RECME_TOKEN. The app has to be running.

Sharing on Wi-Fi

Send any file to another PC or phone on the same network (Recme or LocalSend). Drag files in or pick them from the library; the other side must accept every transfer. Receiving is encrypted (HTTPS), supports a PIN and "trusted devices", and saves into a folder you choose. Multicast discovery works on most home networks; press Find devices to scan the subnet when it does not.

Build the installer

npm run dist       # icon + copies your ffmpeg into vendor/ + electron-builder

Output: dist/Recme-Setup-<version>.exe (~180 MB, per-user). dist/win-unpacked/Recme.exe is the same app unpacked.

The bundled ffmpeg is a GPL build. That is fine for your own use; if you hand the installer to others, follow the GPL (license text and source offer) or swap in an LGPL build. See THIRD-PARTY-NOTICES.md.

Tests

npm run test:edit    # no app needed: cutting, reordering, size limit, audio, file transfer, HTTPS, PIN, trust
npm run test:cli     # no app needed: the recme command's argument handling and error messages
npm run test:mcp     # app running: the MCP tools and token check
npm run test:audio   # app running: records an area while a sound plays and checks it is in the file

Security

Found a vulnerability? See SECURITY.md (please report privately).

• The MCP server binds to 127.0.0.1, needs the bearer token, and rejects requests with an Origin header or a foreign Host, so web pages cannot drive it. Reset token in the Claude tab replaces it.

• Tools that send or delete files can ask for your confirmation first (on by default); capture tools can too.

• File receiving: private-network addresses only, HTTPS with certificate pinning by fingerprint, PIN with rate limiting, sanitised file names, nothing written before you accept (unless the device is trusted).

Known limits

Windows is the only tested platform. A macOS build exists but has never been run on a real Mac; see docs/MACOS.md for the status and how to help test. gdigrab reaches about 28–29 fps at 2880×1800. System sound is merged when you stop. The editor is basic (no text, transitions or multi-track). Not yet verified: transfers between two real devices and with the real LocalSend app, recording on multi-monitor setups, the installer itself.

Contributing

See CONTRIBUTING.md for setup, tests and guidelines.

License

MIT for Recme's own code (see LICENSE). Bundled FFmpeg and other components: see THIRD-PARTY-NOTICES.md.