AutoSubs – 字幕制作，简单高效

只需一键即可创建高质量字幕。AutoSubs 在简洁直观的界面中提供快速、准确且完全可定制的字幕——既可以独立运行，也能与 DaVinci Resolve 集成。

📥 一键安装程序：Windows ✨ macOS (Apple Silicon) ✨ macOS (Intel)

🐧 Linux (.deb): 请参阅下方的安装命令

---

AutoSubs 的功能

AutoSubs 在您的本地机器上运行AI 转录模型——无需云端，无需订阅。只需导入任何音频或视频文件，它就能生成带有时间戳和发言者标签的精准字幕。

核心功能：

• 多种语言的快速、准确转录
• 发言人分离，并自动添加标签和颜色
• 支持翻译为英语（更多语言即将推出）
• 可导出为 SRT 格式、纯文本，或直接导入 DaVinci Resolve
• 使用 Resolve 时，支持按发言者自定义字幕样式（颜色、轮廓、边框）

生成字幕并标注发言者	高级设置

---

架构概览

AutoSubs 是一个基于 Tauri 的桌面应用——采用 React + TypeScript 前端，后端由 Rust 引擎驱动，打包成适用于 Windows、macOS 和 Linux 的原生应用。

graph TB
    subgraph Frontend ["前端 (React + TypeScript)"]
        UI[UI 组件]
        CTX[状态上下文\n转录内容 · 模型 · 进度 · 设置]
        UI <--> CTX
    end

    subgraph Tauri ["Tauri 桥接层"]
        IPC[IPC 命令与事件]
    end

    subgraph Backend ["Rust 后端"]
        API[命令处理器]
        AP[音频预处理模块]
        API --> AP
    end

    subgraph Engine ["转录引擎"]
        EM[引擎管理器]
        EM --> W[Whisper]
        EM --> P[Parakeet / Moonshine]
        EM --> D[Pyannote 发言人分离]
        EM --> FMT[格式化工具\n换行 · 时间对齐 · CPS]
        EM --> TR[翻译器]
    end

    subgraph External ["外部依赖"]
        FF[FFmpeg 辅助工具]
        HF[HuggingFace Hub\n模型下载]
    end

    subgraph Resolve ["DaVinci Resolve（可选）"]
        LUA[AutoSubs.lua 脚本]
    end

    Frontend <--> Tauri
    Tauri <--> Backend
    Backend --> Engine
    AP --> FF
    Engine --> HF
    LUA <-.->|IPC| Tauri

转录流程全链路：

1. 用户选择文件并点击“转录”
2. Rust 后端通过 FFmpeg 对音频进行预处理（归一化、格式转换）
3. 转录引擎在本地运行所选的 AI 模型（Whisper / Parakeet / Moonshine）
4. 可选地运行 Pyannote 进行发言人分离，以及 Google Translate 进行翻译
5. 格式化工具会应用换行、时间约束及特定语言规则
6. 结果实时回传至 UI，用户可编辑并导出

---

快速入门

1) 下载并安装

🪟 Windows + 🍎 macOS： 从上方链接下载适合您平台的安装程序，并按照提示完成安装。

🐧 Linux (.deb)：

wget https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-linux-x86_64.deb
sudo apt install ./AutoSubs-linux-x86_64.deb
# 如果出现依赖错误，请执行：
sudo dpkg -i AutoSubs-linux-x86_64.deb && sudo apt -f install

2) 选择工作流程

独立模式

1. 启动 AutoSubs，选择音频或视频文件。
2. 选择模型及语言/翻译选项。
3. 点击“转录”。根据需要编辑发言者和字幕。
4. 导出为 SRT 或文本，或将内容复制到剪贴板。

DaVinci Resolve 模式

1. 打开 DaVinci Resolve → 工作区 → 脚本 → AutoSubs。
2. 选择时间线/音频源及设置。
3. 点击“转录”。根据需要编辑发言者和字幕。
4. 将样式化的字幕发送回 Resolve。

[!WARNING] AutoSubs 不适用于 Mac App Store 版本的 DaVinci Resolve。如有需要，请从官方网站重新安装。

---

V3 新特性

• 全新、更简洁的界面——使用更方便，风格更统一
• 更快、更轻量——基于全新 Rust 后端，空闲内存占用降低约 3 倍
• 更智能的模型——选项更多，删除更便捷，状态徽章清晰易懂
• 更好的时间对齐——即使帧率不固定或存在丢帧情况，也能精准对齐
• 独立模式——可转录任意文件，无需 Resolve
• 强大的编辑工具——现代化的字幕编辑器及高级的按发言者样式定制功能

---

贡献代码

欢迎提交 PR！在深入参与之前，可先查看完整的代码库解析：AutoSubs DeepWiki。

开发环境搭建

1. 克隆仓库。

2. 安装前置条件：Node.js 和 Rust 工具链——详情请参阅 tauri.app。

3. 在开发模式下启动应用：

   cd AutoSubs-App
   npm install
   npm run tauri dev
   

4. 若需在开发过程中测试与 Resolve 的集成，可将 AutoSubs-App/src-tauri/resources/Testing-AutoSubs.lua 文件复制到 Resolve 的脚本目录中：

   • Windows: %appdata%/Blackmagic Design/DaVinci Resolve/Support/Fusion/Scripts/Utility
   • macOS: /Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility

   然后修改 Testing-AutoSubs.lua 中的路径，指向您本地的 AutoSubs 安装位置，并通过 Resolve 的 工作区 → 脚本 → Testing-AutoSubs 来打开该脚本。

后端代码位于 AutoSubs-App/src-tauri/ 目录下。

---

深度解析

如需详细的架构文档、组件拆解以及关于代码库各部分的答疑交流，请访问 AutoSubs on DeepWiki。

AutoSubs 快速上手指南

AutoSubs 是一款基于本地 AI 模型的字幕生成工具，支持一键生成高精度、带说话人标签的字幕。它采用 Rust + React 架构，可独立运行或集成至 DaVinci Resolve，无需云端服务或订阅。

环境准备

系统要求

• 操作系统：Windows 10/11、macOS (Intel 或 Apple Silicon)、Linux (Debian/Ubuntu 系列)
• 硬件建议：具备 GPU 加速可显著提升转录速度（非强制，CPU 亦可运行）
• 前置依赖：
  • 独立运行模式：无需额外安装依赖，安装包已内置 FFmpeg 等必要组件。
  • 开发模式：需安装 Node.js 和 Rust 工具链。

注意：若需与 DaVinci Resolve 集成，请确保安装的是官网版本，不支持 Mac App Store 版本的 Resolve。

安装步骤

Windows & macOS

直接下载对应平台的安装包并运行：

• Windows 安装包 (.exe)
• macOS Apple Silicon 安装包 (.pkg)
• macOS Intel 安装包 (.pkg)

Linux (.deb)

在终端执行以下命令下载安装：

wget https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-linux-x86_64.deb
sudo apt install ./AutoSubs-linux-x86_64.deb
# 若遇到依赖错误，请运行：
sudo dpkg -i AutoSubs-linux-x86_64.deb && sudo apt -f install

基本使用

模式一：独立运行 (Standalone Mode)

适用于快速处理任意音视频文件。

1. 启动软件：打开安装好的 AutoSubs 应用程序。
2. 导入文件：拖入或选择需要处理的音频/视频文件。
3. 配置选项：
   • 选择转录模型（如 Whisper, Parakeet, Moonshine）。
   • 设置源语言及是否翻译为英语。
   • 开启“说话人区分”(Speaker Diarization) 以自动标记不同说话人。
4. 开始转录：点击 Transcribe 按钮。
5. 导出结果：转录完成后，可在线编辑字幕，随后导出为 .srt 文件、纯文本或直接复制到剪贴板。

模式二：集成 DaVinci Resolve

适用于视频剪辑工作流，可直接将带样式的字幕送回时间线。

1. 加载脚本：打开 DaVinci Resolve，点击菜单栏 Workspace → Scripts → AutoSubs。

   首次使用若未看到菜单，请确保已将资源文件夹中的 AutoSubs.lua 复制到 Resolve 的脚本目录：

   • Windows: %appdata%/Blackmagic Design/DaVinci Resolve/Support/Fusion/Scripts/Utility
   • macOS: /Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility

2. 选择素材：在脚本界面中选择当前时间线或特定音频源。
3. 执行转录：调整设置后点击 Transcribe。
4. 应用字幕：编辑确认后，字幕将自动以带颜色区分的样式应用到 Resolve 时间线上。