# getopenscreen/openscreen [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/getopenscreen/openscreen  
**GitHub Stars:** 5041  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/getopenscreen-openscreen

## Description
Free, open-source screen recorder and video editor that agents drive over stdio (the desktop app's own executable started with mcp): record the screen, trim, zoom, caption, annotate and export demo videos, and add custom WGSL shader effects that export exactly as previewed.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What getopenscreen/openscreen does

getopenscreen/openscreen exposes OpenScreen's desktop recording and editing workflow to AI agents. OpenScreen captures a selected window or the full screen, along with microphone and system audio, and can add a webcam picture-in-picture overlay. Agents can then work with the resulting project to create a finished demo or walkthrough.

Editing features include trimming, cropping, segment-level speed changes, cursor styling, automatic or manually placed zooms, captions, text, arrows, images, camera framing, and other timeline changes. Captions are transcribed on the device and the transcript can be edited to remove corresponding parts of the video. Custom WGSL shader effects are also supported, with exports matching the preview.

The finished result can be rendered as MP4 or GIF in multiple aspect ratios and resolutions. OpenScreen's export pipeline uses GPU encoding where available, with a CPU fallback.

## How it works

The MCP connection starts the OpenScreen executable with the `mcp` argument. The desktop application provides the recording and editing capabilities while the agent sends requests over standard input and reads responses over standard output.

OpenScreen also supplies a headless command-line interface for scripts, CI jobs, and coding agents. Projects use the `.openscreen` format, which can be edited programmatically as JSON. The CLI can record for a specified duration and export a project without opening visible windows; JSON output is available with `--json`.

For larger workflows, the OpenScreen demo skill helps an agent set up the application and MCP connection, plan a storyboard, record an application, edit the take, export the video, and inspect the result. The workflow can be used for videos attached to pull requests or for launch demonstrations, with publication requiring user approval.

## Setup and configuration

Install OpenScreen using the recommended installer for the target platform. macOS builds are distributed as a DMG, Windows uses the Microsoft Store route, and other platform installers are available from GitHub Releases. The application supports macOS, Windows, and Linux.

In Claude Code, add the executable as an MCP server:

```bash
claude mcp add openscreen -- "<executable>" mcp
```

The demo skill can be installed with:

```bash
npx skills add getopenscreen/openscreen --skill openscreen-demo
```

On macOS, OpenScreen requires Screen Recording and Accessibility permissions. Linux native capture and system audio require `xdg-desktop-portal` and PipeWire; browser capture remains available with fewer capabilities when those components are absent. The documented minimum RAM is 8 GB, with 16 GB recommended.

## Tools and capabilities

- Record a specific window or the entire screen.
- Capture microphone and system audio.
- Add and configure webcam overlays.
- Apply cursor effects, smoothing, zooms, and camera framing.
- Generate, edit, and optionally translate captions.
- Trim, crop, annotate, and adjust playback speed.
- Apply custom WGSL shader effects.
- Export projects to MP4 or GIF.
- Operate headlessly through the CLI with NDJSON output.

_Full upstream README: https://allmcps.com/mcp/getopenscreen-openscreen/readme_