爱意满满的作品展示区。

公司内网不让装录屏软件，于是我用 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