公司内网不让装录屏软件，于是我用 ffmpeg 自己封装了一个 CLI 工具
起因很简单：公司内网管控比较严，录屏软件装不上，OBS 装不了，Win+G 又没有权限开，但 ffmpeg 不知道为什么没有被拦——它就静静地躺在某个服务器目录里，能用。
于是就想着，ffmpeg 本身支持录屏，能不能把那一长串命令参数封装一下，做成一个随时能跑的小工具，录完就走，不依赖任何需要安装权限的软件。
就这样写了这个东西，叫 ScreenRecorder-cli。
项目地址：
https://github.com/gdjdkid/ScreenRecorder-cli
痛点在哪
ffmpeg 本身当然能录屏，但命令太难记了，每次临时录东西都要现查参数：
ffmpeg -f gdigrab -framerate 30 -i desktop \
-f dshow -i audio="virtual-audio-capturer" \
-f dshow -i audio="麦克风 (Conexant ISST Audio)" \
-filter_complex "[1:a][2:a]amerge=inputs=2[a]" \
-map 0:v -map "[a]" \
-c:v libx264 -crf 23 -preset veryfast \
-c:a aac -b:a 128k \
recording_2025-05-17_10-30-00.mp4
音频设备名拼错一个字符就报错，时间戳要手动写，输出路径每次都要重新指定。在工作中临时录个演示或者操作步骤，效率反而比直接截图还低。
所以我想做的事情就一件：把这些参数固化下来，音频设备名保存一次，之后一条命令搞定。
目前实现了什么
- 跨平台：Windows 用
gdigrab+dshow，macOS 用avfoundation，Linux 用x11grab+pulseaudio - 音频设备名保存到本地配置文件，下次启动直接复用
- 默认输出目录可配置，也可以每次用
-o临时覆盖 - 安装时自动检测 ffmpeg 是否在 PATH 里，没有的话给出安装提示
- 按
Ctrl+C优雅退出（向 ffmpeg stdin 写q，不产生损坏文件） - 输出文件名自动带时间戳：
recording_YYYY-MM-DD_HH-MM-SS.mp4 - 无需安装权限，只要 ffmpeg 在 PATH 里，
npm install -g之后就能用
基本用法
# 安装
npm install -g screenrecorder-cli
# 第一次用，先查一下有哪些音频设备
screenrec devices
# 把设备名保存到配置，之后不用再输
screenrec set-device --mic "麦克风 (Conexant ISST Audio)" --system "virtual-audio-capturer"
# 开始录制，Ctrl+C 停止，文件自动保存
screenrec start
# 临时指定输出路径和帧率
screenrec start -o D:\Videos -r 60
# 不录音频
screenrec start --no-audio
# 查看当前配置
screenrec show-config
有几个地方没想清楚，想听听意见
1. Windows 系统音频需要额外装一个驱动
录系统声音需要装 screen-capture-recorder（开源的 DirectShow 驱动），不装只能录麦克风。在内网受限环境下这个驱动不一定能装，目前没找到绕过的方式，只是在文档里说明了。
2. Linux 部分是按文档写的，没有实机测过
我自己用 Windows ，Linux 下 x11grab + pulseaudio 的逻辑是照着 ffmpeg 文档写的，不同发行版差异可能不小。有 Linux 用户的话能帮忙验证一下吗。
3. 只能录全屏
目前没有窗口选择或区域选择。ffmpeg 的 gdigrab 支持 -i title=窗口标题，但窗口标题需要手动输入，不太实用。有没有更好的思路？
4. 输出格式写死了 mp4
编码用 libx264 ，没有其他格式的选项。有没有人有别的格式需求？
技术栈
- Node.js ，CJS ，无额外框架
- commander 做参数解析
- 底层是
child_process.spawn调 ffmpeg ，没用任何 ffmpeg npm wrapper
最开始只是为了解决自己工作里的问题，后来整理了一下结构，加了跨平台支持，就顺手放出来了。如果有人在类似受限的内网环境下办公，或者单纯想要一个轻量的命令行录屏方案，可以试一下。
macOS 和 Linux 用户帮忙验证一下跨平台逻辑有没有问题就更好了，Issues 和 PR 都欢迎。