Openscreen logo

Openscreen

by getopenscreen

Drive OpenScreen over stdio to record, edit, caption, annotate, and export demo videos.

Install Openscreen

Run the project’s own setup commands, in order.

Setup steps from the project

getopenscreen/openscreen installs with its own commands rather than a config we can generate, so these are copied as-is. Run them in order in a terminal. Source: github.com

  1. 1. Add to Claude Code
    claude mcp add openscreen -- "<executable>" mcp
    
  2. 2. Install
    winget install --source msstore OpenScreen
    
  3. 3. Install
    sudo apt install ./Openscreen-Linux-*.deb
    
  4. 4. Install
    sudo dnf install ./Openscreen-Linux-*.rpm
    
  5. 5. Install
    sudo pacman -U Openscreen-Linux-*.pacman
    
  6. 6. Run
    chmod +x Openscreen-Linux-*.AppImage
    

Overview

getopenscreen/openscreen connects an MCP client to the OpenScreen desktop app through its executable and the `mcp` command. Agents can record screens, edit project timelines, add zooms, captions, annotations, and shader effects, then export MP4 or GIF videos. The desktop application runs on macOS, Windows, and Linux, while its headless CLI supports scripted recording, project editing, and rendering. Reach for it when an agent needs to produce product demos, walkthroughs, or videos documenting software changes.

Use cases

  • Record a product walkthrough from a selected window
  • Create a demo video for a pull request
  • Trim and annotate screen recordings with an agent
  • Export edited projects as MP4 or GIF files

Key features

  • stdio MCP connection through the OpenScreen desktop executable
  • Screen, window, microphone, system audio, and webcam recording
  • Agent-directed timeline editing with zooms and annotations
  • On-device captions with editable transcripts
  • MP4 and GIF export with GPU rendering and CPU fallback
  • Custom WGSL shader effects

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/19 checks healthy over the last 11d

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6.7kStargazers on the source repository.
Last commitTodayMost recent push to the default branch.

How Openscreen works

What getopenscreen/openscreen does

getopenscreen/openscreen exposes OpenScreen’s desktop recording and editing workflow to AI agents over MCP. OpenScreen captures a selected window or the full screen, optionally records microphone and system audio, and can include a webcam overlay. Agents can then work with the recording as a project: trim footage, crop it, change segment speed, add cursor effects, create zooms, place text, arrows, and images, and apply captions or annotations.

The result can be exported as an MP4 or GIF in several resolutions and aspect ratios. Custom WGSL shader effects are supported and export as shown in the preview. This makes the server suitable for demo videos, product walkthroughs, launch material, and recordings attached to pull requests.

How it works

The MCP connection starts the OpenScreen application executable with the mcp argument. Communication uses standard input and output, allowing an MCP-compatible client to send recording and editing requests to the desktop app. The app remains the editing and rendering engine rather than requiring a separate hosted service.

OpenScreen also includes a headless command-line interface for scripts, CI jobs, and coding agents. The CLI can record for a specified duration, modify .openscreen project JSON programmatically, and render projects to MP4 or GIF. Passing --json produces newline-delimited JSON output for automation.

An included demo skill can install OpenScreen when needed, connect the MCP server, and guide an agent through creating a video. The documented Claude Code setup adds the executable as an MCP server and then installs the skill.

Setup and configuration

Install OpenScreen using the platform-specific installer: the Microsoft Store on Windows or the GitHub Releases installer elsewhere. The MCP command follows this pattern:

Terminal
claude mcp add openscreen -- "<executable>" mcp

The executable path depends on the operating system and installation method. OpenScreen supports macOS 13 or later, Windows 1903 or later, and Linux systems with xdg-desktop-portal and PipeWire for native capture and system audio. Linux can fall back to browser capture with fewer capabilities. The application requires at least 8 GB of RAM, with 16 GB recommended.

On macOS, grant OpenScreen Screen Recording and Accessibility permissions before recording. The application’s AI editing assistant is separately configured with a user-provided key for supported providers or OpenAI-compatible endpoints; those keys are for AI editing rather than the MCP transport itself.

Tools and capabilities

  • Record a window or the entire screen.
  • Capture microphone, system audio, and webcam overlays.
  • Follow cursor activity with automatic zooms or create manual zooms.
  • Edit timelines with trims, crops, speed changes, and transcript-based cuts.
  • Add captions, translated subtitles, text, arrows, images, and animated annotations.
  • Export GPU-rendered MP4 or GIF files, with CPU fallback.
  • Apply custom WGSL shader effects that match the preview.

Limitations and notes

OpenScreen is under active development, so project format and CLI changes can include breaking changes. Native Linux capture and system audio depend on xdg-desktop-portal and PipeWire; the browser-capture fallback has fewer capabilities. macOS recording also depends on the required operating-system permissions. The AI editing assistant is optional and requires the user to supply a key for the selected provider or endpoint.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Openscreen

getopenscreen/openscreen is an MCP server that connects AI agents to the OpenScreen desktop app over stdio. Its main tools support screen recording, timeline editing, captions, zooms, annotations, shader effects, and MP4 or GIF export for product demos and walkthroughs.

Install the OpenScreen desktop app, then register its executable with your MCP client using the `mcp` argument. In Claude Code, run `claude mcp add openscreen -- "<executable>" mcp`; the executable path varies by operating system.

Yes, Cursor is named as a supported client for the OpenScreen demo workflow. Configure Cursor to start the OpenScreen executable with the `mcp` argument, then use the server to record, edit, and export videos.

OpenScreen supports macOS, Windows, and Linux. macOS requires version 13 or later, Windows requires version 1903 or later, and Linux uses native capture capabilities when `xdg-desktop-portal` and PipeWire are available.

Yes, OpenScreen’s headless CLI can record, edit project JSON, and render MP4 or GIF files without visible windows. Use commands such as `openscreen record` and `openscreen export`, adding `--json` for NDJSON output.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOpenscreen AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/getopenscreen-openscreen?style=directory)](https://allmcps.com/mcp/getopenscreen-openscreen)
HTML Embed
<a href="https://allmcps.com/mcp/getopenscreen-openscreen"><img src="https://allmcps.com/api/badge/getopenscreen-openscreen?style=directory" alt="Openscreen on AllMCPs" /></a>