如何快速上手 macOS 轻量屏幕录制:QuickRecorder 高效录屏完整指南
【免费下载链接】QuickRecorderA lightweight screen recorder based on ScreenCapture Kit for macOS / 基于 ScreenCapture Kit 的轻量化多功能 macOS 录屏工具项目地址: https://gitcode.com/GitHub_Trending/qu/QuickRecorder
QuickRecorder 是一款免费的开源 macOS 屏幕录制工具,面向开发者、教师与视频创作者,基于 Apple 原生 ScreenCaptureKit 框架实现,SwiftUI 编写、安装包不到 10MB。它把全屏、窗口、App 级、移动设备四类录制目标,以及系统声音与麦克风的双音轨处理,整合进一个轻量原生界面:选目标、调参数、点录制,一条链路走到底。
快速上手:三步跑起来 🚀
一条 brew 命令完成安装,授权屏幕录制权限后即可开录,默认参数直接可用,试用门槛几乎为零。
第一步,安装。要求 macOS 12.3 及以上,Homebrew 一行搞定:
brew install lihaoyun6/tap/quickrecorder想读源码或二次开发,直接拉取仓库即可:git clone https://gitcode.com/GitHub_Trending/qu/QuickRecorder。
第二步,首次使用。单击 Dock 图标呼出主面板(关闭后随时可再呼出),选择录制模式——屏幕、区域、窗口、应用或移动设备;首次启动按提示授权屏幕录制权限。
第三步,参数调整。设置面板里可改的关键项:帧率(默认 60)、编码器(H.264 / H.265)、Retina 输出(highRes 默认 2 倍)、容器(MP4 / MOV)、音频编码(AAC / ALAC / FLAC / Opus / MP3),保存目录默认桌面。不动它们,默认值也够完成一次干净录屏。
功能全景:能解决哪些问题
录什么、怎么录、录完怎么用——常见录屏痛点在这里都有对应功能位,且均为原生实现。
| 典型场景 | 对应功能 | 实现位置 |
|---|---|---|
| 教学录课 / 直播回放 | Presenter Overlay 实时叠加摄像头、鼠标高亮、系统声与麦克风分轨 | CameraOverlayer.swift / MousePointer.swift |
| 开发演示 / 操作复现 | 单窗口或单 App 隔离录制,可隐藏桌面文件与菜单栏 | RecordEngine.swift |
| 特效合成 | HEVC with Alpha 透明通道视频,可进 iMovie 与 FCPX | RecordEngine.swift |
| 移动端演示 | iOS 设备镜像画面录制 | iDeviceSelector.swift |
教学场景值得多说一句:macOS 14 的 Presenter Overlay 由系统直接合成摄像头画面,录出的就是最终画面,后期不用剪悬浮窗;低版本系统则退回悬浮窗模式。开发演示靠SCContentFilter精确过滤:只录指定窗口,桌面文件、通知中心、菜单栏逐项可关。
底层揭秘:核心技术拆解 ⚙️
录制链路被拆成"上下文、引擎、视图"三层,ScreenCaptureKit 的全部细节收在单一上下文文件里,状态不散落。
分层:SCContext.swift 是全局唯一的录制上下文——流、过滤器、AVAssetWriter、各路音频输入、暂停状态全部集中存放;RecordEngine.swift 只做状态机:选类型、构建过滤器、配流参数、启动采集;ViewModel/下的 SwiftUI 视图只负责选择与展示,换一层不牵连另一层。
帧率与节流:帧率通过minimumFrameInterval交给 SCK 做硬件级节流,而 SCK 本身只在屏幕内容变化时投递帧(源码注释明确引用了这一点),静态画面几乎不产生负载。
// RecordEngine.swift:帧率上限交给 SCK,而不是解码端自己丢帧 conf.minimumFrameInterval = CMTime(value: 1, timescale: frameRate >= 60 ? 0 : CMTimeScale(frameRate)) // 0 = 系统最大帧率 conf.showsCursor = showMouse // 是否录入系统光标 if #available(macOS 13, *) { conf.capturesAudio = recordWinSound || fastStart || audioOnly // 开启系统音频 conf.sampleRate = 48000; conf.channelCount = 2 // 48kHz 立体声 }编码策略:H.264 通过VTCompressionSession强制硬件编码器(RequireHardwareAcceleratedVideoEncoder: true),分辨率超出硬件能力时弹窗建议切 H.265——源码提示原文写明软件编码会显著增加 CPU 占用。目标码率按「分辨率 × 帧率 × 编码器系数 × 质量系数」动态计算,H.264 系数 0.9、H.265 系数 0.5,保底 200kbps。
实测与数据 📊
项目文档里没有跑分式宣传,能引用的都是源码与 README 中的硬指标,下表逐一列出。
| 指标 | 数值 / 选项 | 出处 |
|---|---|---|
| 应用体积 | 不到 10MB | README_zh.md |
| 默认输出 | 60fps + Retina 2 倍(highRes=2) | QuickRecorderApp.swift 默认注册表 |
| 系统音频 | 48000Hz / 2 声道 | RecordEngine.swift |
| 目标码率系数 | H.264 ×0.9 vs H.265 ×0.5(后者低约 44%) | RecordEngine.swift 码率公式 |
| HDR 队列深度 | queueDepth = 8,注释标注安全区间 4–8 | RecordEngine.swift 行内注释 |
| 最低码率 | 200kbps 保底 | RecordEngine.swift max(200000, targetBitrate) |
这张表读出的取舍逻辑:默认就开 Retina 与 60fps,赌的是 SCK 按需投递帧不会打满负载;而把 H.265 目标码率压到 H.264 的六成不到,同样时长下文件体积天然更小,README 也因此把它定位为专业制作选项。
进阶玩法:扩展与定制 🔧
录制流程被完整暴露成 AppleScript 命令,任何能跑 osascript 的入口——快捷指令、定时任务、键盘宏——都能直接驱动录屏。
Scriptable.sdef 定义了 6 条命令:record screen(可带屏幕序号)、record screen area、record application(按名称)、record window(按标题 + 应用)、record system audio(可带麦克风),外加一条configure修改 fps、quality、cursor、sound、microphone、hires、hdr。组合起来就是一段无人值守录屏脚本:
osascript <<'EOF' tell application "QuickRecorder" configure fps 30, quality 2, cursor false, hires true record screen numbered 1 end tell EOF配置同样分了层:所有选项都是@AppStorage(即 UserDefaults),默认值集中在 QuickRecorderApp.swift 的注册表中,界面、脚本、命令行改的是同一份状态。想加新的录制模式,ViewModel/目录本身就是模板——iDeviceSelector.swift 与 CameraOverlayer.swift 各自只负责一个能力,新增模块不需要动引擎层。
谁适合用 👥
选型不看热度看场景:它把 macOS 单机录屏做到「够用且干净」,但没有跨平台与云端能力。
- 教师与培训者:Presenter Overlay + 鼠标高亮 + 双音轨,录课素材基本免后期;
- 开发者与技术写作者:窗口隔离录制保证演示干净,AppleScript 接口让「录一遍操作」能进自动化流水线;
- 视频创作者:HEVC with Alpha 透明通道与 macOS 15 的 HDR 录制,是同类小工具里少见的专业位;
- 轻量工具控:不到 10MB 的 SwiftUI 原生应用,常驻菜单栏毫无压力。
选择建议:主力需求就是 macOS 录屏且要参数可控,QuickRecorder 值得放进工具箱;需要跨平台录制或自动上传分发,则应另选工具。
QuickRecorder 的价值不在功能堆料,而在把 ScreenCaptureKit 的用法拆到可以直接抄的粒度:上下文集中、帧率交给系统节流、编码按硬件能力选路、码率按公式动态计算。对想集成录屏能力或学习 SCK 实践的 macOS 开发者来说,它比任何教程都像一份活文档。随着 HDR 与透明通道这类特性逐步普及,这类小而准的原生工具仍将是屏幕录制赛道里最实用的参考样本。
【免费下载链接】QuickRecorderA lightweight screen recorder based on ScreenCapture Kit for macOS / 基于 ScreenCapture Kit 的轻量化多功能 macOS 录屏工具项目地址: https://gitcode.com/GitHub_Trending/qu/QuickRecorder
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考