OpenScreen

OpenScreen

在你的 AI Agent 中用一句话制作演示视频：

Install the OpenScreen demo skill with `npx skills add getopenscreen/openscreen --skill openscreen-demo -y`, then follow it to make a demo video of this feature.

一款免费、开源的桌面应用，可录制屏幕，并将录制内容制作成精致的产品演示和操作指南。

说明

OpenScreen 项目延续至此。 Siddharth Vaddem 创建了该项目，并在 v1.5.0 后将原始仓库归档。经他批准，开发工作迁移至此，并沿用相同的名称和 MIT 许可证。

录制原始画面，输出即可发布到 X、Reddit、YouTube、文档页面或着陆页。这正是 Screen Studio 定义的类别；OpenScreen 是该类别中的开源选择，而非克隆品。

个人和商业用途完全免费，所有功能均无需付费解锁。

项目状态。 OpenScreen 正在积极开发中，可能存在尚待完善之处，也可能偶尔出现不兼容更改，包括 .openscreen 项目格式和 CLI 的变更。欢迎报告错误：提交 issue。

核心功能

• 录制指定窗口或整个屏幕。
• 录制麦克风和系统音频。
• 摄像头叠加画中画，支持八种吸附位置、可调圆角、镜像和形状选项。
• 自动或手动缩放，可调节缩放幅度、时长、缓动效果和像素级精确位置；自动缩放会在你工作时跟随光标。
• 自定义光标大小、平滑度和点击效果，并在录制后平滑光标路径。
• 语音旁白自动生成字幕，在设备端转录，无需上传（支持离线使用）；提供可编辑的转录文本，可从中剪辑，并可选择翻译字幕。
• AI 剪辑助手：在聊天中描述你想要的剪辑效果，它会将更改应用到时间线上，包括剪切、缩放、变速、注释和摄像头构图。使用你自己的密钥（Claude、OpenAI、Gemini、Mistral、OpenRouter、MiniMax 或任何兼容 OpenAI 的端点）；默认情况下不会启用任何功能。
• 壁纸、纯色、渐变或你自己的背景图片。
• 动态模糊。
• 在时间线上裁剪、修剪片段并控制各片段的速度。
• 添加文本、箭头和图片注释，并提供文本动画预设。
• 时间线吸附参考线和音频波形，让修剪更轻松。
• 可自定义键盘快捷键。
• 导出为 MP4 或 GIF，支持多种宽高比和分辨率；使用 GPU 渲染和编码（macOS 上为 Metal，Windows 上为 D3D11，Linux 上为 Vulkan），并自动回退到 CPU。
• 支持的语言：阿拉伯语、捷克语、英语、西班牙语、法语、德语、意大利语、日语、韩语、葡萄牙语（巴西）、俄语、土耳其语、越南语、简体中文和繁体中文。

命令行界面（无头模式）

OpenScreen 提供 CLI，供脚本、CI 和 AI 编码 Agent 使用：以无头模式录制屏幕，以编程方式编辑 .openscreen 项目 JSON（缩放、注释、修剪），并使用完整导出流程渲染 MP4/GIF——不显示窗口，使用 --json 输出 NDJSON。

openscreen record --duration 20 --project demo.openscreen --json
openscreen export demo.openscreen -o demo.mp4 --json

请参阅 CLI 参考。

让你的 AI Agent 为功能发布附上视频

将以下内容粘贴到你的 AI Agent（Claude Code、Codex、Cursor…）中：

Install the OpenScreen demo skill with `npx skills add getopenscreen/openscreen --skill openscreen-demo -y`, then follow it to add a video of this change to the PR.

该技能会完成所有设置：如果尚未安装 OpenScreen，则会在你同意后安装（仅安装一次），连接其 MCP 服务，然后提示你打开新会话并说 "continue the OpenScreen demo"。这是 Agent 无法自行完成的唯一一步。 手动操作时，在 Claude Code 中需要运行以下两条命令，其中 <executable> 是你系统上应用的可执行文件（查找方法）：

claude mcp add openscreen -- "<executable>" mcp
npx skills add getopenscreen/openscreen --skill openscreen-demo

之后，只需提出请求："Add a video of this change to the PR." Agent 会规划分镜、录制应用、使用 OpenScreen 自带的剪辑工具编辑视频、导出 MP4、逐帧检查，并将视频附加到拉取请求中，方便评审者直接在原处观看。也可以让它制作发布演示视频；它会起草一篇 X 帖文，但只有在你同意后才会发布。Codex 和其他客户端的用法请参阅 AI 剪辑。

安装

每个平台都有推荐的安装方式。Windows 上推荐使用 Microsoft Store；其他平台则推荐从 GitHub Releases 页面下载安装程序。

系统要求

• Windows：最低要求为版本 1903+（内部版本 18362），配备 Intel 第 8 代 / AMD Ryzen 2000 系列或更新的处理器；推荐使用配备 Intel 第 12 代 / Ryzen 4000 系列或更新处理器的 Windows 11
• macOS：13（Ventura）或更高版本——ScreenCaptureKit 的录制功能要求此版本
• Linux：使用原生录制和系统音频需要 xdg-desktop-portal 和 PipeWire；即使没有它们，仍可通过浏览器录制回退方案进行录制，但功能较少（请参阅平台差异）
• RAM：最低 8 GB，推荐 16 GB

完整表格以及关于旧款集成显卡的说明，请参阅：系统要求。

macOS

直接从 Releases 页面 下载 .dmg 安装程序，并将 OpenScreen 拖入 Applications 文件夹。从 1.9.0 开始的构建版本均使用 Developer ID 证书签名，并经过 Apple 公证，因此 Gatekeeper 不会拦截，也无需执行终端操作。

首次启动时，打开 系统设置 > 隐私与安全性，并授予 OpenScreen 所需的两项权限：屏幕录制和辅助功能。两项权限都获批后才能开始录制。

说明

macOS 15 及更高版本会定期重新请求屏幕录制权限。 该提示由 macOS 本身发出，适用于所有第三方屏幕录制工具——这并不表示安装有问题，也不表示更新导致了故障。收到提示时，请再次授予权限。

说明

从早于 1.9.0 的版本升级？ 这些构建版本未使用 Developer ID 证书签名，而 macOS 会将屏幕录制和辅助功能权限与应用签名关联，因此无法识别新构建版本是同一个应用，之前授予旧版本的权限也不会沿用。如果授予权限后新版本仍无法录制，请在 系统设置 > 隐私与安全性 中移除 OpenScreen 的现有条目（屏幕录制和辅助功能两项），然后重新启动应用，并在出现提示时授予权限。

说明

选择录制内容或倒计时开始时，OpenScreen 就退出了？ 很可能是某个会在应用最后一个窗口关闭后退出应用的实用工具导致的，例如 Vorssaint 的 关闭时退出选项。该工具不把 OpenScreen 的录制栏计算在内，因为录制栏会浮在其他窗口上方，因此每当录制栏隐藏或源窗口关闭时，它都会退出 OpenScreen。请将 OpenScreen 添加到该工具的例外列表，或关闭该选项。FAQ 介绍了如何检查是哪个应用要求 OpenScreen 退出。

Windows

推荐 — Microsoft Store

从 Microsoft Store 获取 OpenScreen，或在终端中运行：

winget install --source msstore OpenScreen

Microsoft 会在认证期间为 Store 软件包签名，因此安装时不会出现安全警告，并且会自动更新。

替代方案 — 独立安装程序

从 Releases 页面下载 .exe。安装程序提供 x64（Openscreen.Setup.<version>-x64.exe）和 ARM64（Openscreen.Setup.<version>-arm64.exe）两种版本——在 ARM64 设备上，x64 版本会通过模拟运行，录制效果不佳，因此请选择 ARM64 版本。如果无法访问 Store（例如使用 Windows LTSC、受限制的工作设备、离线安装），或想使用某个较旧的特定版本，请选择此方案。

说明

.exe 未经过代码签名，因此 Windows SmartScreen 会显示 “Windows 已保护你的电脑”，并报告发布者未知。选择 更多信息 → 仍要运行以继续。

这并不表示下载文件有问题：对于未签名的安装程序，SmartScreen 会针对每个文件单独建立信任，因此无论有多少人安装过之前的版本，全新构建版本一开始都会被视为不受信任。此处无法验证签名——因为根本没有签名可供验证。如果想选择经过检查的安装方式，请使用上面的 Store 版本。如果使用 .exe，请仅从此处链接的 Releases 页面下载。

说明

在 Windows 10 上使用 OpenScreen 2.0.0 时，录制栏无法点击？ 运行 setx OPENSCREEN_DISABLE_CONTENT_PROTECTION 1，从系统托盘图标退出 OpenScreen，然后重新启动。之后录制栏便可出现在录制内容中。FAQ 介绍了修复推出后如何撤销此设置。

Linux

每个版本都会在发布页面发布四个软件包。请选择与你的发行版匹配的软件包：

Debian / Ubuntu / Pop!_OS（.deb）

sudo apt install ./Openscreen-Linux-*.deb

Fedora / RHEL / CentOS（.rpm）

sudo dnf install ./Openscreen-Linux-*.rpm

Arch / Manjaro（.pacman）

sudo pacman -U Openscreen-Linux-*.pacman

任意发行版（.AppImage）

chmod +x Openscreen-Linux-*.AppImage
./Openscreen-Linux-*.AppImage

NixOS / Nix（flake）

试用，无需安装：

nix run github:getopenscreen/openscreen

安装到你的用户配置文件中：

nix profile install github:getopenscreen/openscreen

用于 NixOS 系统配置（flake）：

{
  inputs.openscreen.url = "github:getopenscreen/openscreen";

  outputs = { nixpkgs, openscreen, ... }: {
    nixosConfigurations.<host> = nixpkgs.lib.nixosSystem {
      modules = [
        openscreen.nixosModules.default
        { programs.openscreen.enable = true; }
      ];
    };
  };
}

对于 Home Manager，请使用 openscreen.homeManagerModules.default，并设置相同的 programs.openscreen.enable = true;。

根据你的桌面环境，可能需要授予屏幕录制权限。

**沙盒错误：**如果 AppImage 启动时出现“sandbox”错误，请使用 --no-sandbox 运行：

./Openscreen-Linux-*.AppImage --no-sandbox

平台差异

在 macOS、Windows 和 Linux 上，编辑器和导出功能完全相同：缩放、背景、运动模糊、裁剪／修剪／速度、模糊区域、注释、自动字幕、AI 编辑、项目、导出以及所有语言。目前这三个平台都通过原生采集管线进行录制；它们之间的差异比以往更小：

• 原生录制：macOS（ScreenCaptureKit）、Windows（Windows Graphics Capture）和 Linux（通过 ScreenCast portal 使用 PipeWire）均通过原生管线录制，以获得更高画质和干净的窗口级采集。如果 Linux 上的辅助程序不可用，浏览器管线会自动作为后备方案。
• 自定义光标：在 macOS 和 Windows 上会捕获真实光标的形状、类型和点击。在 Linux 上，会通过 portal 捕获光标位置和形状，因此可编辑的光标叠加效果同样可用。Linux 也支持点击效果，但不通过 portal 实现——Wayland 不提供鼠标按键的 portal，因此采集辅助程序会从 evdev 读取左键状态，这需要具备鼠标的读取权限：可按照Wayland 上的鼠标点击所示，为指针设备添加 udev 规则（推荐），或将用户添加到 input 组。没有该权限也不影响录制，只是每个光标采样都会被视为移动。
• 网络摄像头：所有平台都会将网络摄像头画面保存为屏幕录制旁边的独立文件。Windows 由录制辅助程序进行原生采集；macOS 和 Linux 则在应用中录制。三个平台都支持将其作为画中画叠加层。
• 系统音频支持因操作系统而异：
  • macOS：所有受支持的版本均可使用。在 macOS 14.2+ 上，系统会提示你授予音频采集权限。
  • Windows：开箱即用。
  • Linux：需要 PipeWire（Ubuntu 22.04+、Fedora 34+ 默认提供）。仅使用旧版 PulseAudio 的配置可能无法采集系统音频（麦克风仍应可用）。

官方链接

此仓库是 OpenScreen 的社区维护延续版本。

官方／可信链接：

• 原始归档仓库：https://github.com/siddharthvaddem/openscreen
• 社区延续版本：https://github.com/getopenscreen/openscreen
• 官方网站：https://getopenscreen.com

为确保安全，请只从此仓库链接的官方 GitHub Releases 下载 OpenScreen。除非此处明确列出，否则使用 OpenScreen 名称的第三方网站均与此延续版本无关。

社区

OpenScreen 由社区驱动。如果你需要帮助、想要报告错误，或只是想与其他用户和贡献者交流：

• 💬 Discord — 加入 OpenScreen Discord，获取实时帮助、展示作品并参与讨论
• 🐞 GitHub Issues — 提交错误报告和功能请求
• 🗺️ 路线图 — 查看我们接下来要开发的内容
• ❤️ 支持项目 — GitHub Sponsors 或 Ko-fi

---

许可证

本项目采用 MIT 许可证。使用本软件即表示您同意，作者不对因使用本软件而产生的任何问题、损害或索赔承担责任。