OpenScreen CLI 完全参考无头录屏与自动化导出指南为 CI 和 AI Agent 而生【免费下载链接】openscreenRecord your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.项目地址: https://gitcode.com/gh_mirrors/opens/openscreenOpenScreen 是一款免费开源的录屏工具它的内置 CLI命令行界面让你不用打开任何窗口就能完成无头录屏headless screen recorder、本地字幕生成和 MP4/GIF 自动化导出。本文将从零讲清 6 个核心命令、NDJSON 机器可读输出以及如何在 CI 流水线或 AI 编码助手中用它自动生产产品演示视频。为什么需要 OpenScreen CLI普通录屏工具的终点是打开编辑器而 OpenScreen CLI 的终点是一条能进脚本的管道️无头录屏终端里录屏、录音进程退出即得到视频文件项目即 JSON.openscreen项目是纯 JSON程序可以随意改缩放、标注、裁剪GPU 渲染导出CLI 导出与编辑器Export按钮走同一套原生合成器画面完全一致机器可读--json把 stdout 变成 NDJSON 事件流脚本和 AI Agent 可以直接解析它直接内置在桌面应用的同一个可执行文件里安装 OpenScreen 即拥有 CLI。完整命令参考见仓库内 website/docs/cli.md。5 大核心命令速览命令作用典型场景record无头录屏可选麦克风/系统音自动化采集一段屏幕操作sources列出显示器、窗口、麦克风脚本动态选择--display/--windowexport把项目渲染为 MP4/GIFCI 中生成最终成片captions本地 Whisper 转写并写入字幕给演示视频自动加字幕pack/info打包项目媒体 / 检查项目引用把项目当 CI 制品传递、校验文件完整性无头录屏record 命令怎么用record驱动与桌面端完全相同的录屏钩子文件直接落进应用的录制目录openscreen record --duration 30 --project demo.openscreen --json openscreen record --window My App --mic --system-audio常用选项完整表格见 electron/cli/args.ts--window 标题只录标题匹配的窗口优先于--display--mic/--system-audio收录麦克风与系统声音--cursor editable-overlay|system默认把鼠标录成可编辑数据额外生成video.cursor.json遥测文件之后可换样式、可自动放大system则把指针直接画进画面--duration 秒到时自动停止非常适合无人值守--project out.openscreen录完自动写出一个可直接export的项目文件没有--duration时可用 CtrlC、SIGTERM 或在 stdin 输入stop停止。注意CLI 录屏不支持摄像头只包含屏幕和音频。⚠️ 平台差异macOS 走 ScreenCaptureKit需屏幕录制权限Windows 走 Windows Graphics CaptureLinux 走 PipeWire且桌面的屏幕共享选择器每次都会弹一次因此Linux 录屏无法完全无人值守。自动化导出export 命令与 --auto-zoomexport是 CLI 的灵魂——缩放、裁剪、变速、标注、字幕、光标、背景全部来自项目 JSONopenscreen export demo.openscreen -o out.mp4 --quality source openscreen export demo.openscreen -o out.gif --gif-fps 20 --gif-size large openscreen export demo.openscreen -o out.mp4 --auto-zoom --audio voice.m4a --audio-mode replace重点选项--quality medium|good|source720p / 1080p / 跟随源分辨率绝不放大--auto-zoom按录制到的鼠标点击自动生成镜头缩放与编辑器的自动缩放同一引擎--audio file导出后把配音混进 MP4视频流直接拷贝不重编码CLI 的 MP4 固定H.264 60fps见 src/cli/CliExportRunner.tsx更细的编码控制请用桌面端导出对话框小技巧导出任意已有视频也只需一个最小项目——一个媒体路径加空 editor保存成.openscreen即可被export渲染。本地字幕与 NDJSON 机器可读输出captions命令用本地 Whisper 转写项目音频不上传字幕直接写进项目文件导出时烧录进画面首次运行会下载约 264 MB 的模型。所有命令加--json后stdout 每行一个 JSON 事件started/progress/done…stderr 只放诊断日志方便jq直接消费{event:progress,percentage:50,currentFrame:60,totalFrames:120,estimatedTimeRemaining:3} {event:done,success:true,outputPath:/path/out.mp4,format:mp4,width:1920,height:1080}退出码约定0成功、1失败、2参数错误。脚本里以退出码为准判断成败。在 CI 中运行 OpenScreen CLI每条命令都会启动 Electron需要显示服务器即使没有可见窗口。因此在无头 Linux runner 上用xvfb-run提供虚拟 X 显示export不采集屏幕配一个 Vulkan 软件驱动如 Mesa lavapipe即可纯 CPU 渲染成片record在无显示/无桌面会话的服务器上不可行——录屏需要真实桌面OpenScreen 自己的 Nix 构建流水线就证明了这条路在无屏幕的 Linux runner 上xvfb-run lavapipe 渲染出一个 MP4没有产物就让 CI 失败见 .github/workflows/nix-build.yml。AI Agent 全自动产品 Demo 工作流这正是 CLI 为 AI 编码助手设计的典型链路record --window MyProduct --mic --duration 20 --project demo.openscreencaptions demo.openscreen本地转写字幕用脚本编辑demo.openscreenJSON往editor.zoomRegions/editor.annotationRegions里加缩放和文字标注export demo.openscreen -o demo.mp4 --auto-zoom渲染成片全程无需人工打开编辑器。项目格式与 CLI 在版本间仍可能有破坏性变更升级后请跑一遍脚本回归。源码导读与 CLI 不适合的场景CLI 的实现分布在两处供进阶读者查阅参数解析与启动electron/cli/args.ts、electron/cli/cliMain.ts项目命令 pack/infoelectron/cli/projectCommands.ts隐藏窗口执行器src/cli/record / export / captions / sources 各有 runner共享契约类型src/lib/cliContracts.ts❌ 以下情况请绕开 CLI无桌面的纯服务器录屏、需要稳定版本化 API、需要码率/帧率/编码深度定制、脚本录屏要带摄像头、或需要字幕文件SRT输出。常见问题 FAQQCLI 和桌面版是两个程序吗不是CLI 就内置在桌面应用的可执行文件中help子命令可查看用法CLI 运行不占用应用的单实例锁桌面版开着也能用。Q--json 输出里哪些字段最有用done事件export 给你outputPath/width/heightrecord 给你screenVideoPath/durationMs/projectPath可作为下一步流水线的输入。Q如何把项目交给另一台机器渲染pack demo.openscreen --out bundle/会把项目、录屏、光标遥测全部复制进一个文件夹并重写路径适合作为 CI 制品归档与分发。【免费下载链接】openscreenRecord your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.项目地址: https://gitcode.com/gh_mirrors/opens/openscreen创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考