Recordly 详细部署教程

项目概述

Recordly 是一款开源、跨平台的屏幕录制与编辑工具，专为制作产品演示、教程和演示视频而设计。它将录屏、剪辑和美化功能整合在一个桌面应用中，让你无需专业剪辑技能即可制作出精美的演示视频。

核心功能：

功能模块 说明
录制 录制整个屏幕或单个应用窗口，支持麦克风和系统音频
自动缩放 基于光标活动自动建议缩放区域，平滑光标移动
时间线编辑 拖放式时间线，支持裁剪、缩放、变速、标注等
光标控制 显示/隐藏光标、大小调整、平滑、运动模糊、点击弹跳
摄像头叠加 添加网络摄像头气泡覆盖，支持预设位置和自定义坐标
画面美化 内置壁纸、纯色/渐变背景、模糊、内边距、圆角、阴影
导出 MP4 和 GIF 导出，支持质量和尺寸选择
扩展系统 社区驱动的扩展市场，可添加新功能

支持平台：

  • macOS 14.0 (Sonoma) 及以上
  • Windows 10 Build 19041+
  • Linux 现代发行版（系统音频通常需要 PipeWire）

部署前准备

系统要求

平台 最低版本 说明
macOS macOS 14.0 (Sonoma) ScreenCaptureKit 音频和麦克风捕获所必需
Windows Windows 10 20H1 (Build 19041) 原生 Windows Graphics Capture (WGC) 所需
Linux 任何现代发行版 通过 Electron 捕获 API 录制，系统音频通常需要 PipeWire

注意：在 Windows Build 19041 之前的版本上，录制仍可通过回退捕获工作，但真实操作系统光标可能保留在录制中。

方案一：下载预构建版本（推荐）

这是最简单的部署方式，适合大多数用户。

步骤 1：访问 Releases 页面

前往 GitHub Releases 页面下载对应系统的安装包：

text

1
https://github.com/webadderallorg/Recordly/releases

步骤 2：下载对应平台的安装包

根据你的操作系统选择：

平台 安装包
Windows Recordly-windows-x64.exe
macOS (Intel) Recordly-x64.dmg
macOS (Apple Silicon) Recordly-arm64.dmg
Linux Recordly-linux-x64.AppImage

步骤 3：安装并运行

Windows：双击 .exe 文件按照向导安装。

macOS：打开 .dmg 文件，将 Recordly 拖入应用程序文件夹。

Linux：赋予执行权限后运行：

1
2
chmod +x Recordly-linux-x64.AppImage
./Recordly-linux-x64.AppImage

macOS 用户特别注意

如果打开时提示”应用无法打开”（本地构建的应用可能被 macOS 隔离），在终端执行：

1
xattr -rd com.apple.quarantine /Applications/Recordly.app

方案二：Arch Linux / Manjaro 安装

如果你使用 Arch Linux 或 Manjaro，可以通过 AUR 安装：

使用 yay 安装

1
yay -S recordly-bin

PKGBUILD、桌面入口、发布同步和可选的本地源码打包位于 recordly-aur 仓库中。

方案三：从源码构建

如果你需要最新开发版本或进行二次开发，可以从源码构建。

步骤 1：安装前置依赖

macOS：

1
xcode-select --install

Linux (Ubuntu/Debian)：

1
sudo apt install build-essential cmake libx11-dev libxtst-dev libxrandr-dev libxt-dev

Windows：

安装 Visual Studio 2022（或 Build Tools），需包含 C++ 工作负载和 CMake。

步骤 2：克隆仓库

1
2
git clone https://github.com/webadderallorg/Recordly.git recordly
cd recordly

步骤 3：安装依赖

1
npm install

步骤 4：开发模式运行

1
npm run dev

步骤 5：构建打包版本

1
npm run build

平台特定构建命令：

1
2
3
npm run build:mac    # macOS
npm run build:win    # Windows
npm run build:linux  # Linux

使用指南

录制

  1. 启动 Recordly
  2. 选择要录制的屏幕或窗口
  3. 选择麦克风和系统音频选项
  4. 开始录制
  5. 停止录制后自动打开编辑器

编辑

在编辑器中你可以：

  • 添加裁剪、缩放、变速区域和标注
  • 调整光标行为和预览音量
  • 用壁纸、颜色、渐变、模糊、内边距和圆角美化画面
  • 添加或调整网络摄像头叠加素材
  • 添加额外音频区域
  • 裁剪画面并选择宽高比

随时将工作保存为 .recordly 项目文件。

导出

导出选项包括：

  • MP4：标准视频输出
  • GIF：轻量级分享和循环

导出前可调整格式特定设置，如质量、GIF 帧率、GIF 循环和输出尺寸。

平台限制说明

光标捕获

Recordly 在录制内容上渲染精美的光标叠加层。平台光标隐藏行为仍取决于操作系统支持：

平台 光标隐藏支持
macOS ScreenCaptureKit 可以干净地排除真实光标
Windows 最佳效果需要 Windows 10 Build 19041+ 和原生捕获助手
Linux Electron 桌面捕获目前不支持光标隐藏

常见问题排查

问题 解决方案
macOS 提示”应用无法打开” 执行 xattr -rd com.apple.quarantine /Applications/Recordly.app
Windows 录制光标可见 确认系统版本为 Build 19041+，使用原生捕获助手
Linux 系统音频无法录制 确保系统使用 PipeWire
构建失败，缺少依赖 检查是否安装了所有前置依赖（CMake、C++ 工具链等）
npm install 失败 检查 Node.js 版本，确保网络可访问 npm registry
导出时预览崩溃 更新到最新版本，v1.4.0 修复了多个稳定性问题

项目结构说明

text

1
2
3
4
5
6
7
8
9
10
Recordly/
├── electron/          # Electron 主进程代码
├── src/               # 前端源码
├── public/            # 公共资源
├── icons/             # 图标资源
├── build/             # 构建配置
├── docs/              # 文档
├── scripts/           # 脚本
├── package.json       # 项目配置
└── vite.config.ts     # Vite 配置

更新与维护

检查更新

Recordly 内置更新检查功能。v1.4.0 版本修复了不可见的更新提示问题，Windows/Linux 用户建议手动安装此版本。

更新方式

  • 预构建版本：从 Releases 页面下载最新版本覆盖安装
  • AUR 安装：yay -Syu recordly-bin
  • 源码构建：git pull 后重新构建

总结

部署方式 适用场景 难度 推荐度
下载预构建版本 大多数用户 ⭐ ⭐⭐⭐⭐⭐
AUR 安装 Arch Linux 用户 ⭐ ⭐⭐⭐⭐⭐
源码构建 开发/定制需求 ⭐⭐⭐ ⭐⭐

对于大多数用户，下载预构建版本是最简单直接的选择：

text

1
2
3
4
5
6
7
# 访问 Releases 页面
https://github.com/webadderallorg/Recordly/releases

# 下载对应平台的安装包
# Windows: Recordly-windows-x64.exe
# macOS: Recordly-x64.dmg / Recordly-arm64.dmg
# Linux: Recordly-linux-x64.AppImage

安装完成后，你可以直接开始录制屏幕、编辑视频并导出精美的演示视频。所有编辑功能都内置于应用中，无需额外的剪辑软件。

Recordly 使用 AGPL 3.0 许可证开源，可免费使用。如需扩展功能，可以浏览 Recordly Marketplace 安装社区扩展。