跟随鼠标的 Windows 录屏工具。录屏时不只是录下整屏,而是同时产出一份自动跟随光标的裁切视口 —— 适合教程、演示、操作回放这类「观众想知道你在看哪里」的场景。
Rust + Tauri 2 + WebView2,纯 Windows。
每次录制都会同时写出:
| 文件 | 内容 |
|---|---|
master.mp4 |
完整原片,保留全屏,供二次裁切 |
camera.mp4 |
跟拍成片:自动裁切、跟随光标的视口(录制时生成,导出不依赖它) |
track.csv |
鼠标轨迹,坐标 + 时间,250 Hz |
另外还有 frames.csv(帧 → 相机刻度映射)和 meta.json(本次录制参数)。素材是自描述的:一个目录就是一份可重现的工程。
取景器在 250 Hz 上解算,与录制帧率解耦:
- One Euro 滤波抑制抖动,保留快速移动的跟随性
- 临界阻尼弹簧做位置过渡,避免生硬跳切
- 速度驱动的视口放大:鼠标移动越快,视口越大(默认 1.2 倍),让观众看到更多上下文;光标本身按视口放大的同比例补回,所以看起来是「光标变大」而不是「画面缩小」
- 前瞻量按速度提前偏移视口中心
- 亚像素采样:取景矩形保留小数,由双线性缩放器在源图的分数位置上取样。慢速平移是连续滑动,不会攒够一个整像素再跳一格(
MC_SUBPIXEL=0可回退以做对比)
因为结构是「先记轨迹、后渲染」,同一段 master.mp4 可以按不同参数反复烘焙出不同版本。
- 取景框(HUD):录制前在屏幕上标出当前取景范围。它是一个独立进程(
mousecam.exe --hud),用UpdateLayeredWindow绘制,崩溃不影响录制 - 录制帧率:30 或 60 fps(录制页选择,会记住);60 更顺滑,文件约大一倍。导出可保持素材帧率,也可重采样成别的帧率
- 音频:可分别开关「电脑声音」(WASAPI 回环)与「麦克风」,编码后混流;某一路为静音时会补静音,避免音画漂移
- 编辑页:裁切区间、跟随关键帧、代理预览、多格式导出(H.264 / H.265 / VP9 / ProRes / GIF)
- 编辑操作:空格播放/暂停,
←/→单帧、Shift+←/→十帧、Home/End首尾,Ctrl+Z / Ctrl+Shift+Z撤销重做;拖裁切头时预览会跟到那一帧并显示时间码,裁切吸附到帧边界与录制中的点击时刻;时间轴滚轮缩放、中键平移;时间码可双击手输 - 画面选项:稳定死区(小范围画圈时视口不跟着晃)、光标平滑(零相位,默认 60 ms)、点击强调(按下处扩散一圈)
- 参数记忆:跟拍参数与界面分栏尺寸都会被记住
- 可观测:轮转日志、panic hook、心跳看门狗、崩溃遗留录制自动恢复
从 Releases 下载便携版,解压后双击 mousecam.exe。需要系统里有 WebView2 运行时(Windows 11 自带)。
依赖:
- Rust(stable,MSVC 工具链)
- Node.js 22+(只为 Tauri CLI)
- Visual Studio 2022 C++ 生成工具 + Windows SDK
- WebView2 Runtime
cd rust\mc-app
npm install
npx tauri build --bundles msi开发调试:
cd rust\mc-app
cargo build构建出的 mousecam.exe 需要同目录下有 ffmpeg.exe(从 dist/ffmpeg.exe 复制过去,正式打包时会自动内联)。
rust/mc-engine/ 采集(DXGI 复制 + GDI 兜底)、相机解算、录制管线、取景框、编辑烘焙、日志
rust/mc-api/ Tauri 命令层(会话 / 预览 / 设置)
rust/mc-app/ 应用外壳(Tauri 入口、界面、打包配置)
rust/mc-server/ 本地服务
tools/ 自动化验证脚本(CDP 驱动界面 + 录制回归)
rust/README.md 里有更详细的架构说明。
- HDR / 10bit 显示器:DXGI 会返回无法映射的色彩格式,程序会在启动时明确报错,需要关闭 HDR
- 录制期间取景框自动隐藏:桌面复制接口不理会
WDA_EXCLUDEFROMCAPTURE,留着会把边框录进画面 - 仅整屏录制,暂不支持区域 / 窗口采集与暂停继续
- 未签名,首次运行可能被 SmartScreen 或安全软件拦截
你可以自由使用、修改、分发本项目(包括商用),但分发修改后的版本时必须同样以 GPL-3.0 开源,并保留版权声明。
第三方组件与分发义务见 THIRD_PARTY.md。
Issue 和 PR 都欢迎。开发环境的搭建见上面的「自行构建」,tools/ 里有基于 CDP 的界面回归脚本,改动后建议跑一遍。