Clypra 是一个免费、开源（MIT 许可证）的专业级视频编辑器。它采用原生 Rust/Tauri v2 核心进行硬件加速视频处理，并结合 React 19 前端，提供跨平台（macOS、Windows、Linux）支持。

1. 系统要求

  • 操作系统：macOS (Apple Silicon & Intel)、Windows 10/11、Linux。
  • 硬件：建议至少 8GB 内存，支持 GPU 加速的显卡（用于提升解码和渲染性能）。
  • 网络：首次下载和后续更新需要网络连接。

2. 安装方式

2.1 下载预编译安装包（推荐）

从项目的 GitHub Releases 页面 下载适用于您操作系统的最新版本：

  • macOS：
    • 通过 Homebrew 安装：brew install AIEraDev/tap/clypra
    • 或下载 Clypra-universal.dmg 文件，打开后将 Clypra.app 拖入 Applications 文件夹。
  • Windows：下载 Clypra-x64.msi 文件，双击运行并按照向导完成安装。
  • Linux：下载 Clypra-x86_64.AppImage 文件，在终端中执行 chmod +x Clypra-x86_64.AppImage 使其可执行，然后运行该文件。

2.2 从源码构建（面向开发者）

如果您想从源码运行或贡献代码，请遵循以下步骤：

  1. 克隆仓库：

    1
    2
    git clone https://github.com/AIEraDev/clypra.git
    cd clypra

  2. 安装依赖：

    • Node.js 18+ 和 npm。
    • Rust 1.70+ 和 cargo（通过 rustup 安装）。
    • FFmpeg 6.0+ 及其开发头文件（Development headers）。
      • macOS：brew install ffmpeg
      • Ubuntu/Debian：sudo apt install ffmpeg libavcodec-dev libavformat-dev libavutil-dev libavdevice-dev
      • Windows：从 FFmpeg 官网 下载并配置环境变量。

  3. 安装项目依赖并启动开发模式：

    1
    2
    3
    npm install
    cp .env.example .env   # 如需配置环境变量
    npm run tauri dev      # 启动开发模式

3. 核心功能概览

Clypra 提供了专业视频编辑器所需的核心功能：

功能类别 具体特性
多轨道时间线 帧精确修剪、多层轨道排列、完整的撤销/重做历史。
硬件加速引擎 原生 Rust 实现，支持 GPU 解码（VideoToolbox、D3D11VA、VAAPI），解码延迟低于 10ms。
音频与波形 实时峰值和 RMS 波形渲染，帧精确的音视频同步，片段音量控制。
文本与视觉合成 自定义文本样式、动画叠加层、滤镜和实时画布预览。
多格式导入/导出 支持 MP4、MOV、WebM、MKV、MP3、WAV、PNG 等格式，并可导出高质量 ProRes/H.264 视频。

4. 开发与测试（供贡献者参考）

如果您希望参与开发，可以参考以下脚本：

  • 运行前端测试：npm test
  • 运行 Rust 后端测试：cd src-tauri && cargo test
  • TypeScript 类型检查：npx tsc --noEmit
  • 格式化代码：npm run format

5. 常见问题排查

问题 可能原因 解决方案
应用无法启动或闪退 系统缺少必要的运行时依赖 确保已安装 FFmpeg 并将其添加到系统 PATH。对于 Linux，可能需要安装额外的库（如 libasound2）。
导入视频后预览黑屏或卡顿 视频编码不受支持或硬件加速未启用 检查视频格式是否在支持列表中。尝试在设置中切换硬件加速选项（如从 Auto 改为特定 API）。
导出失败或提示编码错误 导出设置与输入素材不兼容，或输出路径无写入权限 检查导出格式、分辨率和码率设置。确保输出目录有足够的存储空间和写入权限。
macOS 提示“无法验证开发者” 应用未经过 Apple 公证 右键点击应用图标，选择“打开”，然后在弹出对话框中确认打开。
从源码构建时 FFmpeg 相关错误 FFmpeg 库未正确安装或未被系统找到 确保已安装 FFmpeg 开发包。在 Ubuntu/Debian 上安装 libavcodec-dev、libavformat-dev 等包。

6. 总结

Clypra 是一个充满潜力的开源视频编辑项目，其核心优势在于硬件加速性能和现代化的技术栈。

核心使用路径：

  1. 下载安装：从 Releases 页面获取适合您系统的安装包（.dmg、.msi 或 .AppImage）并安装。
  2. 启动应用：打开 Clypra，您将看到直观的时间线和预览界面。
  3. 导入素材：将视频、音频或图片文件拖入项目或通过菜单导入。
  4. 开始剪辑：在时间线上进行裁剪、排列、添加文本或滤镜等操作。
  5. 导出视频：完成编辑后，选择所需的格式和设置导出最终视频。

建议：

  • 对于初学者，建议先从下载预编译安装包开始，快速体验其功能。
  • 如果您是开发者，并希望贡献代码或进行深度定制，请仔细阅读项目根目录的 CONTRIBUTING.md 和 ARCHITECTURE.md 文档，以了解代码结构和开发规范。
  • 由于项目仍在积极开发中，遇到问题时可以查阅项目的 CHANGELOG.md 或提交 Issue。

项目地址：https://github.com/AIEraDev/Clypra