Cap 开源录屏工具完整指南：免费录制、编辑并分享屏幕视频的实操手册

Cap 开源录屏工具完整指南：免费录制、编辑并分享屏幕视频的实操手册

【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap

需要把一段操作过程变成视频发给同事时，你大概率经历过：软件收费、导出带水印、文件太大传不动。Cap 是一个开源的 Loom 替代方案，支持屏幕、摄像头和麦克风录制，录完即可生成分享链接或直接导出文件，并且可以完全自托管。

Cap 录屏工具的定位与核心卖点

• 两种录制模式覆盖不同场景：Instant Mode 在录制过程中同步上传，停止录制的那一刻就能拿到分享链接；Studio Mode 本地录制后进入编辑器，支持背景替换、变焦、裁剪和字幕，再决定导出或分享。
• 存储方式四选一：用官方云、接入自己的 S3 兼容存储（AWS S3、Cloudflare R2、MinIO、Wasabi 等）、仅保存在本地，或用 Docker Compose 自托管整套平台。
• 隐私控制具体到参数：分享页可设密码、可挂自己的域名，敏感内容可以不经过任何托管基础设施。
• 异步协作内置：评论、表情回应、视频转写（transcripts）、观看者统计和团队工作区都直接挂在视频上，不用另开文档。
• 可迁移现有资产：支持把已有 Loom 视频导入 Cap，库不用分散在两处。

5 分钟快速上手：环境要求与安装命令

环境要求

验证已装版本：

node -v pnpm -v cargo --version

安装步骤

1. 克隆仓库并进入目录：

git clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap

2. 安装依赖并初始化配置：

pnpm install pnpm env-setup pnpm cap-setup

pnpm env-setup会交互式生成.env文件，过程中会询问你要启动哪些应用、是否用 Docker 跑 MySQL 和 MinIO；pnpm cap-setup负责安装 FFmpeg 等原生依赖。Windows 上还需预先装好 LLVM、Clang 和 VCPKG，macOS 上需要 CMake，这两步安装脚本不会代劳。

首次运行注意

• 用pnpm dev:desktop启动桌面端、pnpm dev:web只启动 Web 端、pnpm dev两者一起启动。
• 首次录制时系统会请求屏幕录制和麦克风权限，务必允许；在 macOS 终端里跑开发模式时，权限要授予运行命令的终端（如 Terminal.app），而不是 Cap 应用本身，这是新手最常踩的坑。
• 自托管部署（docker compose up -d）默认服务在http://localhost:3000，未配置邮件时，登录链接会打印在服务日志里，可用docker compose logs cap-web查看。

核心用法：从第一次全屏录制到导出分享

第一次完成全屏录制

启动桌面端后选择录制区域（整个显示器或指定目标），点击录制按钮即可开始，倒计时结束后画面开始被捕获。录制中可以通过托盘菜单暂停/继续、静音，并实时看到时长。停止后，这条录制会出现在本地库中。

💡 小技巧：开发模式下 macOS 的录制文件存放在~/Library/Application Support/so.cap.desktop.dev/recordings，Windows 在%programfiles%/so.cap.desktop.dev/recordings，找不到文件时先来这里翻。

用 Instant Mode 拿到即停即用的分享链接

适合报 bug、异步同步这类"越快越好"的场景。选择 Instant Mode 后，Cap 会在你录制的同时把数据传上去，停止录制的瞬间链接就可用——对方点开就能看，不需要等上传完成。

用 Studio Mode 精修后再发布

产品演示、教程、客户交付这类对成片质量有要求的场景走 Studio Mode：录完后自动进入编辑器，可以裁剪片段、加变焦、换背景、生成字幕，确认无误后选择导出文件或生成分享链接。

分享与权限管理

生成链接后，按需设置公开或私有、加密码，团队可以把分享页放到自己的域名下。视频上的评论和转写文本会一直留在视频页面，后续讨论不用翻聊天记录。

常见问题排查

进阶：源码结构文档入口

想改录制逻辑而不是只是用的话，从这几个入口开始看：桌面端 Rust 实现在 apps/desktop/src-tauri/（录制、摄像头、导出、托盘各是一个模块）；录屏、编码、渲染等底层能力在 crates/ 下的 recording、enc-ffmpeg、rendering 等 crate；自托管部署的编排文件是 docker-compose.yml。贡献前请先阅读 CONTRIBUTING.md，摄像头与屏幕捕获相关 crate 采用 MIT 许可，其余代码为 AGPLv3。

Cap 录屏工具把"录完就能发"和"数据归自己"两件事同时做到了：免费开源、双录制模式、存储可自选。下一步建议：先按上面的步骤跑通pnpm dev:desktop录一条 30 秒的全屏视频，再用 Instant Mode 把链接发给同事验证整条链路。

【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap