Cap 开源录屏工具完整上手指南从本地运行到自建服务器【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/CapCap 是一个开源的录屏工具定位类似 Loom录制屏幕、摄像头和麦克风然后生成可分享的链接、导出视频或者把文件留在本地。它提供即时模式边录边上传停止即得链接和工作室模式本地录制、进编辑器精修后再导出并支持把整套服务自托管到自己的服务器上。本文按先跑起来再录视频最后自建环境的顺序带你走通开发者和普通用户都能复现的完整路径。一、在本地跑起 Cap最短路径是四条命令这一节解决如何从零把 Cap 桌面应用跑起来的问题。Cap 是一个 Turborepo 单仓项目包含 Rust、TypeScript 和 Tauri 桌面应用所以环境比一般项目多两样Rust 工具链和 Docker用于本地数据库和对象存储。环境要求如下依赖项版本要求Node.js20pnpm10.5.2Rust1.88Docker任意主流发行版安装步骤克隆代码git clone https://gitcode.com/GitHub_Trending/cap1/Cap进入目录并安装前端依赖cd Cap pnpm install生成本地环境配置pnpm env-setup安装 FFmpeg 等原生依赖pnpm cap-setuppnpm env-setup是一个交互式向导会询问你要运行哪些应用桌面端或 Web 端、是否用 Docker 跑 MySQL 和 MinIO并在target/env-profiles/下生成对应配置。注意它不是复制.env.example不要手动建.env文件。安装完依赖后只跑桌面应用用pnpm dev:desktop桌面和 Web 一起跑用pnpm dev会自动先起 Docker 服务。桌面应用首次启动会要求授予屏幕录制和麦克风权限这是系统层面的必要步骤。二、录制第一条视频先分清即时模式和工作室模式这一节解决开始录制前该选哪个模式的问题。Cap 的两种模式对应两种完全不同的诉求选错模式会浪费后面所有步骤。即时模式Instant Mode边录边上传停止的瞬间就能拿到分享链接。适合 bug 反馈、异步站会、快速演示。工作室模式Studio Mode先在本地完整录制然后打开内置编辑器可以调背景、加缩放、裁剪片段、加字幕最后导出或分享。适合产品演示、教程和交付给客户的内容。录制开始后主窗口会自动隐藏取而代之的是一个悬浮控制条上面有实时计时器、暂停/继续、重新开始、删除和麦克风指示器。控制条不会出现在画面里也不需要你切换窗口去操作这正是它设计为非激活面板的原因。录制引擎本身是 Rust 实现的屏幕捕获、音频采集、编码和封装分别由 crates/recording/ 下的独立 crate 承担这也是它能做到低延迟边录边上传的原因。对你来说只需记住一点工作室模式的产物是一个可编辑的工程即时模式的产物是一个立刻可用的链接。三、选对录制目标显示器、窗口和摄像头叠加这一节解决录什么画面、如何把自己也录进去的问题。Cap 支持四类目标整个显示器、单个窗口、矩形区域、以及纯摄像头。多显示器环境下每个屏幕都会出现一个独立的透明选择浮层光标走到哪个屏幕就在哪个屏幕上点选选中的窗口可以点一下固定住。摄像头部分是独立于录制的一个悬浮预览窗选中摄像头后预览气泡立即弹出不用等开始录制。预览窗支持圆形、方形、全屏三种形状可以拖动和缩放还能开启实时背景虚化。需要注意的是虚化不会烧录进视频而是写进工程配置之后在编辑器里仍然可以调整或关闭画面始终是原始素材。如果摄像头只枚举出来但打不开常见于蓝牙设备切换或系统连续性设备Cap 会降级为不带麦克风的录制而不是让录制直接失败这个行为符合宁可少一条轨也不要整段作废的思路。四、视频存哪里本地目录、编辑器和浏览器扩展这一节解决录完之后的文件在哪、怎么二次处理的问题。开发模式下macOS 的录制文件位于~/Library/Application Support/so.cap.desktop.dev/recordingsWindows 位于%programfiles%/so.cap.desktop.dev/recordings。正式发布的安装包使用不带.dev的对应目录。每条录制是一个文件夹内含recording-meta.json和按片段切分的媒体文件编辑器直接读这个工程来播放和剪辑。工作室模式的录制动画完成后会自动进入编辑器时间线支持裁剪、移动、拆分、删除和撤销右侧配置栏分六个标签页颜色、缩放、裁剪等参数都会防抖写回工程文件关掉再打开不丢状态。如果你的场景集中在浏览器里apps/chrome-extension/ 下是一个 Chrome 扩展版本可以只录当前标签页、整个浏览器窗口、全屏或纯摄像头。扩展走的就是即时模式的逻辑停止即上传链接直达你的 Cap 空间。团队侧的能力都在 Web 端评论、点赞、观看统计、字幕转写、密码保护分享以及自动生成的标题、摘要和章节。这些功能对自建实例同样可用只是 AI 相关项需要配置对应的服务商密钥。五、自建一套 CapDocker Compose 三条命令这一节解决数据不想放官方云端怎么办的问题。Cap 支持四种存储方式官方托管、接入任意 S3 兼容服务AWS、R2、MinIO、Wasabi 等、纯本地存储以及完整自托管。完整自托管是最彻底的一档官方给的就是 Docker Compose 一条路git clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap docker compose up -d服务起来后在http://localhost:3000可以访问 Web 端。一个容易踩的坑是登录方式没有配置邮件服务时登录链接不会发到邮箱而是打印在服务日志里用docker compose logs cap-web查看并打开即可。桌面端指向自建实例只需要一步打开设置在Cap Server URL里填入你的服务器地址。生产部署前记得配置公网地址并替换默认密钥相关环境变量包括CAP_URL和S3_PUBLIC_URL。六、新手最常卡住的三个问题这一节集中回答跑起来之后最容易被卡住的几件事每个都给出验证方式。macOS 权限给了错误的进程。从终端运行pnpm dev:desktop时屏幕录制和麦克风权限要授予终端应用比如 Terminal而不是 Cap 应用本身。验证方式开始录制时若画面黑屏或无声先去系统设置的隐私与安全性里确认权限归属。首次构建很慢、占空间很大。前端依赖走 pnpmRust 侧首次编译需要拉取大量 crate桌面应用的target/目录可能达到数 GB首编十几分钟属于正常现象之后的增量编译很快。如果卡死不动检查网络而不是强行杀进程。依赖安装失败。最常见的解法是删掉node_modules后重新pnpm installRust 侧编译报错则先执行rustup update对齐工具链版本。Windows 还需要提前装好 llvm、clang 和 VCPKGmacOS 需要 cmakepnpm cap-setup不会替你装这些。跑通桌面应用只是起点。下一步建议录一条三十秒的工作室模式视频走完进编辑器加一个缩放、导出、拿分享链接给同事看的完整闭环把编辑器、导出和分享三条链路都摸一遍。【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Cap 开源录屏工具完整上手指南：从本地运行到自建服务器
Cap 开源录屏工具完整上手指南从本地运行到自建服务器【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/CapCap 是一个开源的录屏工具定位类似 Loom录制屏幕、摄像头和麦克风然后生成可分享的链接、导出视频或者把文件留在本地。它提供即时模式边录边上传停止即得链接和工作室模式本地录制、进编辑器精修后再导出并支持把整套服务自托管到自己的服务器上。本文按先跑起来再录视频最后自建环境的顺序带你走通开发者和普通用户都能复现的完整路径。一、在本地跑起 Cap最短路径是四条命令这一节解决如何从零把 Cap 桌面应用跑起来的问题。Cap 是一个 Turborepo 单仓项目包含 Rust、TypeScript 和 Tauri 桌面应用所以环境比一般项目多两样Rust 工具链和 Docker用于本地数据库和对象存储。环境要求如下依赖项版本要求Node.js20pnpm10.5.2Rust1.88Docker任意主流发行版安装步骤克隆代码git clone https://gitcode.com/GitHub_Trending/cap1/Cap进入目录并安装前端依赖cd Cap pnpm install生成本地环境配置pnpm env-setup安装 FFmpeg 等原生依赖pnpm cap-setuppnpm env-setup是一个交互式向导会询问你要运行哪些应用桌面端或 Web 端、是否用 Docker 跑 MySQL 和 MinIO并在target/env-profiles/下生成对应配置。注意它不是复制.env.example不要手动建.env文件。安装完依赖后只跑桌面应用用pnpm dev:desktop桌面和 Web 一起跑用pnpm dev会自动先起 Docker 服务。桌面应用首次启动会要求授予屏幕录制和麦克风权限这是系统层面的必要步骤。二、录制第一条视频先分清即时模式和工作室模式这一节解决开始录制前该选哪个模式的问题。Cap 的两种模式对应两种完全不同的诉求选错模式会浪费后面所有步骤。即时模式Instant Mode边录边上传停止的瞬间就能拿到分享链接。适合 bug 反馈、异步站会、快速演示。工作室模式Studio Mode先在本地完整录制然后打开内置编辑器可以调背景、加缩放、裁剪片段、加字幕最后导出或分享。适合产品演示、教程和交付给客户的内容。录制开始后主窗口会自动隐藏取而代之的是一个悬浮控制条上面有实时计时器、暂停/继续、重新开始、删除和麦克风指示器。控制条不会出现在画面里也不需要你切换窗口去操作这正是它设计为非激活面板的原因。录制引擎本身是 Rust 实现的屏幕捕获、音频采集、编码和封装分别由 crates/recording/ 下的独立 crate 承担这也是它能做到低延迟边录边上传的原因。对你来说只需记住一点工作室模式的产物是一个可编辑的工程即时模式的产物是一个立刻可用的链接。三、选对录制目标显示器、窗口和摄像头叠加这一节解决录什么画面、如何把自己也录进去的问题。Cap 支持四类目标整个显示器、单个窗口、矩形区域、以及纯摄像头。多显示器环境下每个屏幕都会出现一个独立的透明选择浮层光标走到哪个屏幕就在哪个屏幕上点选选中的窗口可以点一下固定住。摄像头部分是独立于录制的一个悬浮预览窗选中摄像头后预览气泡立即弹出不用等开始录制。预览窗支持圆形、方形、全屏三种形状可以拖动和缩放还能开启实时背景虚化。需要注意的是虚化不会烧录进视频而是写进工程配置之后在编辑器里仍然可以调整或关闭画面始终是原始素材。如果摄像头只枚举出来但打不开常见于蓝牙设备切换或系统连续性设备Cap 会降级为不带麦克风的录制而不是让录制直接失败这个行为符合宁可少一条轨也不要整段作废的思路。四、视频存哪里本地目录、编辑器和浏览器扩展这一节解决录完之后的文件在哪、怎么二次处理的问题。开发模式下macOS 的录制文件位于~/Library/Application Support/so.cap.desktop.dev/recordingsWindows 位于%programfiles%/so.cap.desktop.dev/recordings。正式发布的安装包使用不带.dev的对应目录。每条录制是一个文件夹内含recording-meta.json和按片段切分的媒体文件编辑器直接读这个工程来播放和剪辑。工作室模式的录制动画完成后会自动进入编辑器时间线支持裁剪、移动、拆分、删除和撤销右侧配置栏分六个标签页颜色、缩放、裁剪等参数都会防抖写回工程文件关掉再打开不丢状态。如果你的场景集中在浏览器里apps/chrome-extension/ 下是一个 Chrome 扩展版本可以只录当前标签页、整个浏览器窗口、全屏或纯摄像头。扩展走的就是即时模式的逻辑停止即上传链接直达你的 Cap 空间。团队侧的能力都在 Web 端评论、点赞、观看统计、字幕转写、密码保护分享以及自动生成的标题、摘要和章节。这些功能对自建实例同样可用只是 AI 相关项需要配置对应的服务商密钥。五、自建一套 CapDocker Compose 三条命令这一节解决数据不想放官方云端怎么办的问题。Cap 支持四种存储方式官方托管、接入任意 S3 兼容服务AWS、R2、MinIO、Wasabi 等、纯本地存储以及完整自托管。完整自托管是最彻底的一档官方给的就是 Docker Compose 一条路git clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap docker compose up -d服务起来后在http://localhost:3000可以访问 Web 端。一个容易踩的坑是登录方式没有配置邮件服务时登录链接不会发到邮箱而是打印在服务日志里用docker compose logs cap-web查看并打开即可。桌面端指向自建实例只需要一步打开设置在Cap Server URL里填入你的服务器地址。生产部署前记得配置公网地址并替换默认密钥相关环境变量包括CAP_URL和S3_PUBLIC_URL。六、新手最常卡住的三个问题这一节集中回答跑起来之后最容易被卡住的几件事每个都给出验证方式。macOS 权限给了错误的进程。从终端运行pnpm dev:desktop时屏幕录制和麦克风权限要授予终端应用比如 Terminal而不是 Cap 应用本身。验证方式开始录制时若画面黑屏或无声先去系统设置的隐私与安全性里确认权限归属。首次构建很慢、占空间很大。前端依赖走 pnpmRust 侧首次编译需要拉取大量 crate桌面应用的target/目录可能达到数 GB首编十几分钟属于正常现象之后的增量编译很快。如果卡死不动检查网络而不是强行杀进程。依赖安装失败。最常见的解法是删掉node_modules后重新pnpm installRust 侧编译报错则先执行rustup update对齐工具链版本。Windows 还需要提前装好 llvm、clang 和 VCPKGmacOS 需要 cmakepnpm cap-setup不会替你装这些。跑通桌面应用只是起点。下一步建议录一条三十秒的工作室模式视频走完进编辑器加一个缩放、导出、拿分享链接给同事看的完整闭环把编辑器、导出和分享三条链路都摸一遍。【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考