Skip to content

README.zh-CN.md

Latest commit

 

History

History
403 lines (268 loc) · 10.4 KB

README.zh-CN.md

File metadata and controls

403 lines (268 loc) · 10.4 KB

Recordly

语言: EN | 简中

Recordly logo

macOS Windows Linux AGPL 3.0 license

制作精致、专业级的屏幕录制内容。

Recordly 是一款开源屏幕录制器和编辑器，适合制作操作讲解、演示、产品视频等内容。

欢迎贡献。 赞助

output.mp4

Recordly 是什么？

Recordly 是一款桌面应用，用于录制并编辑屏幕内容，内置面向演示视频的动态呈现工具。你不需要先把原始素材交给动效设计师去补缩放、光标润色或样式化背景，Recordly 可以在一个地方免费完成整套流程。

Recordly 运行于：

  • macOS 14.0+
  • Windows 10 Build 19041+
  • Linux 现代发行版

平台说明：

  • macOS 使用原生的基于 ScreenCaptureKit 的捕获辅助程序。
  • Windows 在支持的系统版本上使用原生 Windows Graphics Capture（WGC）辅助程序，并支持原生 WASAPI 音频。
  • Linux 通过 Electron 捕获 API 录制。目前 Linux 还不支持隐藏真实光标。

核心功能

自动缩放、光标润色与样式化画面

Recordly 可以根据操作自动强调重点区域，平滑光标运动，添加动态效果，并将最终画面放进带有壁纸、纯色、渐变、模糊、留白和阴影的样式化边框中。

Recordly cursor and zoom demo video

动态摄像头气泡叠加

你可以把摄像头素材作为气泡叠加层加入画面，使用预设位置或自定义坐标摆放，支持镜像、阴影和圆角调节，也可以让它跟随缩放变化，保证动态镜头里整体视觉更协调。

Recordly webcam overlay demo video

为演示设计的时间线编辑

使用拖拽式时间线工具处理缩放、裁剪、变速区域、注释、额外音频区域以及裁切感知编辑，并将工作保存为 .recordly 项目文件，之后随时回来继续编辑。

Recordly timeline editor screenshot

扩展与市场

Recordly 拥有一个社区驱动的扩展系统。任何人都可以构建和发布扩展来为 Recordly 添加新功能——光标点击音效、设备边框、浏览器模拟外壳、壁纸、渲染钩子、设置面板等等。

浏览并安装社区扩展：Recordly 扩展市场。

全部功能

录制

  • 录制整个显示器或单个应用窗口
  • 录制完成后直接进入编辑器
  • 录制麦克风音频和系统音频
  • 在支持的平台上使用原生捕获后端
  • 从保存的 .recordly 项目文件继续编辑
  • 可在应用中打开已有录像或已有项目文件

时间线与编辑

  • 拖拽式时间线编辑
  • 裁掉不需要的片段
  • 添加手动缩放区域
  • 根据光标活动生成自动缩放建议
  • 添加加速和减速区域
  • 添加文本、图片和图形注释
  • 在时间线上添加额外音频区域
  • 裁切录制画面
  • 保存并重新打开项目，保留编辑状态

光标控制

  • 显示或隐藏渲染后的光标叠加层
  • 调整光标大小
  • 光标平滑
  • 光标运动模糊
  • 点击弹跳效果
  • 光标摆动效果
  • 光标循环模式，方便导出更自然的循环片段
  • 使用 macOS 风格的渲染光标素材

摄像头叠加

  • 启用或禁用摄像头叠加素材
  • 上传、替换或移除摄像头素材
  • 镜像摄像头画面
  • 调整尺寸
  • 使用预设位置或自定义 X/Y 坐标
  • 调整边距
  • 调整圆角程度
  • 调整阴影强度
  • 可选的缩放联动摄像头缩放效果

画面样式与背景

  • 内置壁纸
  • 运行时自动发现 wallpapers 目录中的壁纸
  • 上传自定义背景图片
  • 纯色背景
  • 渐变背景
  • 画面留白
  • 圆角
  • 背景模糊
  • 投影阴影
  • 最终画面的宽高比预设

导出

  • MP4 导出
  • GIF 导出
  • 导出质量选择
  • GIF 帧率选择
  • GIF 循环开关
  • GIF 尺寸预设
  • 宽高比和输出尺寸控制
  • 在系统文件管理器中定位导出文件

工作流与易用性

  • 可自定义键盘快捷键
  • 应用内快捷键说明
  • 在编辑器中直接打开反馈和问题链接
  • 编辑器偏好设置持久化
  • 导出后更快恢复预览

截图

Recordly editor screenshot

Recordly recording interface screenshot

Recordly timeline screenshot

安装

下载构建版本

预构建发布版本请见：

https://github.com/webadderall/Recordly/releases

Arch Linux / Manjaro（yay）

可通过 AUR 安装（recordly-bin）：

yay -S recordly-bin

PKGBUILD、桌面入口、发布同步，以及可选的本地源码打包都维护在 recordly-aur 中，因此这个仓库本身不需要承担 Arch 发布维护工作。关于维护者联系方式和软件包更新方式，请查看该仓库或 AUR 软件包页面。

从源码构建

前置依赖

macOS： 安装 Xcode Command Line Tools（xcode-select --install）。

Linux（Ubuntu / Debian）：

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

Windows： 安装 Visual Studio 2022（或 Build Tools），并勾选 C++ 工作负载和 CMake。

步骤

git clone https://github.com/webadderall/Recordly.git recordly
cd recordly
npm install
npm run dev

如果需要打包构建：

npm run build

也可以使用平台专用构建命令：

  • npm run build:mac
  • npm run build:win
  • npm run build:linux

macOS：“App cannot be opened”

本地构建的应用可能会被 macOS 隔离。

可以用以下命令移除隔离标记：

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

系统要求

平台 最低版本 说明
macOS macOS 14.0 (Sonoma) 使用 ScreenCaptureKit 捕获音频和麦克风所必需。
Windows Windows 10 20H1（Build 19041，2020 年 5 月） 原生 Windows Graphics Capture（WGC）辅助程序及最佳光标隐藏行为所必需。
Linux 任意现代发行版 通过 Electron 捕获录制。系统音频通常需要 PipeWire。

Important

在 Windows 19041 之前的版本上，录制仍可能通过回退捕获方式工作，但真实系统光标可能仍会出现在视频中。

使用方法

录制

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

编辑

在编辑器中，你可以：

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

你可以随时将工作保存为 .recordly 项目。

导出

支持以下导出格式：

  • MP4，适合常规视频输出
  • GIF，适合轻量分享和循环片段

你可以在导出前调整格式相关设置，例如质量、GIF 帧率、GIF 循环方式和输出尺寸。

限制

光标捕获

Recordly 会在录制画面上渲染一个经过美化的光标叠加层，但真实系统光标是否能被隐藏仍取决于平台能力。

macOS

  • ScreenCaptureKit 可以较干净地排除真实光标。

Windows

  • 最佳效果需要 Windows 10 Build 19041+ 和原生捕获辅助程序。
  • 较旧版本会回退到 Electron 捕获，因此真实光标可能仍会显示。

Linux

  • Electron 桌面捕获目前不支持隐藏真实光标。
  • 如果同时启用渲染光标叠加，导出中可能会同时看到真实光标和样式化光标。

系统音频

系统音频支持因平台而异。

Windows

  • 原生 WASAPI 支持

Linux

  • 通常需要 PipeWire

macOS

  • 需要 macOS 14.0+ 和基于 ScreenCaptureKit 的工作流

工作原理

Recordly 将平台相关的捕获层与基于渲染器的编辑、导出流程结合在一起。

捕获

  • Electron 负责录制流程和应用级控制
  • macOS 使用原生的 ScreenCaptureKit 辅助程序
  • Windows 在可用时使用原生 Windows Graphics Capture（WGC）以及原生音频辅助程序

编辑

  • 时间线区域定义缩放、裁剪、变速、音频叠加和注释
  • 光标和摄像头样式由编辑器状态统一控制

渲染

  • 场景合成由 PixiJS 负责

导出

  • 预览使用的同一套场景逻辑会被用于导出 MP4 或 GIF

项目

  • .recordly 文件会保存源媒体路径和编辑器状态，方便后续继续编辑

贡献

欢迎贡献。

特别需要帮助的方向包括：

  • Linux 录制与光标行为改进
  • 导出性能与稳定性优化
  • UI 和 UX 打磨
  • 本地化工作
  • 更多编辑工具与工作流优化

请尽量让 Pull Request 保持聚焦，测试录制、编辑、导出流程，并避免无关重构。

请参阅 CONTRIBUTING.md 了解具体指南。

社区

问题反馈和功能建议：

https://github.com/webadderall/Recordly/issues

欢迎提交 Pull Request。

支持者名单

Ko-Fi

  • Tadees
  • buildwithfur
  • Tobias
  • Anonymous Supporter
  • Roberto Marcelino
  • Rajan RK
  • Francesco
  • Erwan
  • Anonymous supporter

许可证

Recordly 基于 AGPL 3.0 发布。

致谢

鸣谢

Recordly 最初是从 OpenScreen 分叉而来，之后已逐步演变为不同的项目。

创建者
@webadderall