Cap 开源录屏:从录制到分享链接只需 3 步
【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap
Cap 是一款开源录屏工具,定位是 Loom 的开源替代品:录屏、摄像头和麦克风,本地编辑后生成可分享链接,还能附带评论与转写。Cap 桌面端支持 macOS、Windows、Linux,另提供 Chrome 扩展。下次要给别人复现一个 Bug 时,发一条回放链接,比约会议口头描述要快得多。
一分钟看懂:这类工具适合谁
- 要异步讲清楚一件事的开发者与产品同学:录完即得链接,评论和转写直接挂在视频上,不用另起一轮沟通。
- 在意数据归属的团队:录像可以留在本地,也可以接自己的 S3 桶或整套自部署,不受制于单一托管服务。
- 从 Loom 迁移过来的用户:Cap 支持导入已有 Loom 视频,把库集中到一处。
安装与准备:环境要求与最短配置
日常使用只需安装桌面端;如果你要从源码跑起来或自部署,先按下表核对环境:
| 组件 | 最低版本 | 验证命令 |
|---|---|---|
| Node.js | 20 | node -v |
| pnpm | 10.5.2 | pnpm -v |
| Rust | 1.88 | rustc --version |
| Docker | 任意近期版本 | docker --version |
从源码运行桌面端的最短路径(桌面安装包可从官方下载页获取,按系统选.dmg、.exe或.deb):
git clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap pnpm install pnpm env-setup pnpm cap-setup pnpm dev:desktop这一步如果卡在cap-setup,不用慌,先确认 Docker 已启动,它需要拉起 MySQL 和 MinIO 等本地服务。官方安装说明见 installation.mdx,上手流程见 quickstart.mdx。
典型场景实操:先录 3 种 Cap
🚀 用 Instant 模式快速分享
适合 Bug 复现、异步站会这类"讲完就走"的场景。
- 打开 Cap 并登录,选择 Instant 模式。
- 选择要捕获的屏幕、窗口或区域,按需打开摄像头、麦克风或系统声音。
- 点击 Record,倒计结束后开始录制,Cap 会在录制同时上传。
- 点击 Stop,等待处理完成。
- 复制生成的分享链接直接发出,观看方无需登录账号即可看公开视频。
🎬 用 Studio 模式做需要编辑的演示
适合产品演示、教程和交付客户的内容,先录后修。
- 选择 Studio 模式并开始录制,录像先保存在本地。
- 用浮动控制条在需要时暂停、恢复或停止。
- 录完进入编辑器处理本地工程:裁剪、缩放、背景、字幕都在这里完成。
- 预览效果后,导出为文件或生成分享链接。
🧩 用 Chrome 扩展在浏览器里录
适合网页端操作演示,不用切到桌面端。
- 点击工具栏中的 Cap 扩展图标。
- 在弹出面板里选择捕获范围:全屏、窗口、当前标签页或仅摄像头。
- 按需打开摄像头、麦克风和系统声音开关。
- 点击 Start recording 开始录制。
- 停止后扩展完成上传,把分享链接发出去。
进阶配置:自部署与快捷键
默认配置对单人使用足够,以下三项只在特定需求下才需要动:
| 配置项 | 位置 | 什么时候需要改 |
|---|---|---|
| Cap Server URL | Settings > Cap Server URL | 要指向自己自部署的 Cap 实例时 |
| 全局快捷键 | Settings > Shortcuts | 想用热键启停录制时;Cap 默认不分配全局快捷键 |
| 公开访问地址 | 自部署环境变量 | 要把实例暴露到公网并用自己的域名时 |
自部署用 Docker Compose 一条命令拉起,服务起来后访问http://localhost:3000:
docker compose up -d未配置邮件时,登录链接会打印在服务日志里,用docker compose logs cap-web查看。生产环境部署前,按 self-hosting.mdx 配置公开地址并替换默认密钥:
CAP_URL=https://cap.yourdomain.com S3_PUBLIC_URL=https://s3.yourdomain.com避坑速查:录制常见 5 个问题
| 现象 | 原因 | 处理 |
|---|---|---|
| macOS 录屏黑屏或没有系统声音 | 未授予屏幕录制/音频权限 | 系统设置 > 隐私与安全性,为 Cap 开启对应项后重启 Cap |
| 全局快捷键没反应 | Cap 默认不分配全局热键 | 在 Settings > Shortcuts 里先配置再使用 |
| 自部署后找不到登录链接 | 未配置邮件时链接只输出到日志 | 执行docker compose logs cap-web查看 |
| Windows 下摄像头/麦克风不可用 | 桌面应用未获设备访问权 | Windows 10/11 设置 > 隐私中允许桌面应用访问所选设备 |
| 系统声音源缺失 | 音频可用性依赖系统版本与捕获路径 | 先更新系统并升级 Cap 到最新构建 |
项目结构:主要目录职责
- apps/desktop/:Tauri v2 桌面应用,SolidStart 前端加 Rust 后端
- apps/chrome-extension/:Chrome 扩展,在浏览器内直接录制并上传
- apps/web/:Next.js 应用,承载官网、文档、仪表盘、分享页与 API 路由
- crates/recording/:Rust 录制管线 crate,含测试与基准脚本
- packages/database/:Drizzle 数据库 schema 与访问层
先装好桌面端录一条 Instant 模式的视频,体感一下从录制到出链接的速度;遇到问题或想参与开发,先看 CONTRIBUTING.md,再提交 Issue 或 Pull Request。
【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考