caplo README

项目的 README,来自 github.com/icloudza/caplo。合并为一个 markdown 文件:README.md。

Caplo

Caplo

macOS 原生录屏与视频编辑工具。录完即进入编辑器,自动镜头、光标美化、画布与字幕处理后导出成片。

Release macOS 15+ Apple Silicon | Intel Swift 6 License

下载最新版

官网  ·  版本发布  ·  更新说明  ·  参与贡献


功能

环境

构建

cp Config/Local.xcconfig.example Config/Local.xcconfig   # 填写 DEVELOPMENT_TEAM
open Caplo.xcodeproj

签名用固定的开发证书,避免每次构建后屏幕录制授权失效。工程由 project.yml 生成,修改后执行 xcodegen generate。

命令行无签名构建:

xcodebuild -project Caplo.xcodeproj -scheme Caplo -configuration Debug \
  -destination 'platform=macOS' -derivedDataPath build \
  CODE_SIGNING_ALLOWED=NO CAPLO_APP_IDENTIFIER=com.caplo.buildcheck CAPLO_APP_NAME=CaploBuildCheck build

-derivedDataPath build 与改名参数用于隔离检查构建,不覆盖日常使用的 Caplo.app。

测试

Scripts/check.sh

依次执行:单元测试 → 颜色令牌检查 → 全部窗口实际创建并跑完显示周期 → 无签名构建。单独运行:

cd Packages/CaploKit
swift test                                              # 单元测试
swift run PreviewGallery ../../build/previews --windows # 窗口回归
swift run PreviewGallery ../../build/previews --demo    # 界面与渲染快照

多语言

界面文字的键是中文原文,英文翻译在 App/Localizable.xcstrings(权限说明等在 App/InfoPlist.xcstrings)。 代码里直接写在 Text / Button 中的字面量会自动本地化;其余显示文字用 String(localized:),枚举的原始值作为存档标识不翻译,另加 title。 改动界面文字后同步并检查未翻译条目:

Scripts/localize.sh

发布

推送 vX.Y.Z 标签后,GitHub Actions 自动完成签名、公证、制作 DMG、创建 GitHub Release,并上传到 Cloudflare R2,供官网下载和应用内更新(Sparkle)。配置与流程见 Scripts/release/README.md。

结构

App/                      应用入口、Info.plist、权限声明
Config/                   xcconfig(本机签名配置不入库)
Packages/CaploKit/
  Sources/
    CaptureKit            ScreenCaptureKit 采集、分段写入、设备会话
    EditingCore           编辑数据模型:时间线、镜头、光标轨迹、画布布局
    RenderKit             Core Image 合成、光标与玻璃渲染、Metal 内核
    ExportKit             播放项组装、导出、转写、语音处理
    ProjectKit            工程包读写与存储
    Features              SwiftUI / AppKit 界面:录制条、编辑器、项目中心、设置
    CaploDesignSystem     颜色、字体、材质令牌与通用控件
    PlatformSupport       系统版本兼容层
    CRNNoise              RNNoise 降噪(C)
    PreviewGallery        快照与窗口回归工具
  Shaders/                Metal 内核源码
Scripts/                  内核编译、资源生成、整体检查、发布(release/)
ReleaseNotes/             各版本更新说明

修改 Shaders/CaploKernels.metal 后执行 zsh Scripts/build-kernels.sh 重新生成 CaploKernels.metallib;LiquidGlass.swift 中的 CIKL 兜底实现需同步修改。

参与贡献

欢迎提交 PR!缺陷修复、体验打磨、翻译校对和文档补充都很有价值。

开发约定与贡献授权见 CONTRIBUTING.md。

LINUX DO — a new ideal community, where tech enthusiasts gather.

许可证

源码与官网发布的安装包均以 PolyForm Noncommercial 1.0.0 授权:允许个人学习、研究、爱好项目以及非营利机构使用、修改和分发;禁止任何商业用途,包括在公司或营利性工作中使用、出售,或作为商业产品与服务的一部分。商业授权请联系 [email protected]。

第三方组件保留各自的许可证:

caplo (icloudza/caplo)

正在搜索数据库…

325 ·GitHub
这是什么?Caplo 是一款原生 macOS 屏幕录制和视频编辑工具。停止录制后,它会直接进入自带的编辑器,让你在导出最终片段之前调整镜头缩放、光标、画布和字幕。
它只是个录屏工具,还是也能剪辑?两者兼备,录制和编辑是一个连贯的流程。停止录制后,Caplo 会直接打开内置编辑器,可以调整镜头/缩放、光标样式、画布、叠加层、字幕和音频清理,然后再导出。
怎么让 Caplo 跑起来?官方 DMG 安装包通过 GitHub Actions 发布到 Cloudflare R2 供下载,并通过 Sparkle 实现应用内更新。如果想自己构建,可以用 `xcodegen generate` 根据 project.yml 生成 Xcode 项目,然后在 Xcode 中构建。
构建或运行它需要什么?运行需要 macOS 15 或更高版本;从源码构建需要 Xcode 16+(Swift 6,并启用严格并发检查)。首次启动时,还需要授予屏幕录制、摄像头和麦克风权限。
从源码构建时有什么需要注意的坑吗?构建使用固定的开发证书签名,目的是避免 macOS 在每次重新构建后撤销屏幕录制权限。未签名的构建标志仅用于隔离的测试构建,不应用于日常使用的 Caplo.app。
自动镜头缩放是怎么工作的?Caplo 会分析点击和指针移动,自动生成对焦/缩放镜头。之后你可以在时间轴上添加、删除或调整每一个镜头。
可以导出为哪些格式?可以导出为 H.264 或 HEVC MP4、ProRes 422 MOV 或 GIF,分辨率最高可达 4K。
能否在录屏的同时录制摄像头、麦克风和系统音频?可以。它会将摄像头、麦克风和系统音频与屏幕一起录制到同一段录像中,而且自带的悬浮控制层不会出现在录制画面里。
按键会出现在录像里吗?按键捕获默认关闭,需要授予「输入监控」权限。开启后,按下的键会以键帽的形式显示在单独的时间轨道上,并且可以单独删除。
作者
icloudza
大小
9.1 MB
星标
325
时长
2个月
提交 · 90 天