# AutoSubs
Local-first AI subtitles. No cloud, no subscription, no data leaving your machine.
Use it as a standalone app, or connect to **DaVinci Resolve**, **Adobe Premiere Pro**, and **After Effects**.
- 🎙️ **Transcription:** Whisper, Moonshine, and Parakeet models via whisper-rs and ONNX Runtime
- 👥 **Speaker Diarization:** Identifies and labels different speakers in the transcript, enabling per-speaker styling
- 🌍 **100+ Languages:** Transcription and translation across a wide range of languages
- 💻 **Cross-Platform:** macOS (Apple Silicon/Intel), Windows (Vulkan/DirectML), Linux
[](https://tom-moroney.com/release-tracker/)
[](https://tom-moroney.com/release-tracker/)
[](https://tom-moroney.com/release-tracker/)
[](https://deepwiki.com/tmoroney/auto-subs)
---
## Download
| Platform | Installer |
|---|---|
| 🪟 Windows | [AutoSubs-windows-x86_64.exe](https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-windows-x86_64.exe) |
| 🍎 macOS (Apple Silicon) | [AutoSubs-Mac-ARM.pkg](https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-Mac-ARM.pkg) |
| 🍎 macOS (Intel) | [AutoSubs-Mac-Intel.pkg](https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-Mac-Intel.pkg) |
| 🐧 Linux (Debian/Ubuntu) | [AutoSubs-linux-x86_64.deb](#linux-install) |
| 🐧 Linux (Fedora/openSUSE) | [AutoSubs-linux-x86_64.rpm](https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-linux-x86_64.rpm) |
### macOS Homebrew
macOS users can also install AutoSubs with Homebrew:
```bash
brew install --cask auto-subs
```
### Linux install
**Debian/Ubuntu (.deb):**
```bash
wget https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-linux-x86_64.deb
sudo apt install ./AutoSubs-linux-x86_64.deb
```
**Fedora/openSUSE (.rpm):**
Download [AutoSubs-linux-x86_64.rpm](https://github.com/tmoroney/auto-subs/releases/latest/download/AutoSubs-linux-x86_64.rpm) and open it with your package manager.
---
## Quick Start
### Standalone Mode
1. Launch AutoSubs and select an audio or video file.
2. Pick your model and language/translation options.
3. Click **Transcribe**. Edit speakers and subtitles as needed.
4. Export as SRT, text, or copy to clipboard.
### DaVinci Resolve Mode
1. Open DaVinci Resolve → **Workspace → Scripts → AutoSubs**.
2. Select your timeline/audio source and settings.
3. Click **Transcribe**. Edit speakers and subtitles as needed.
4. Send styled subtitles back to Resolve.
> [!WARNING]
> Mac App Store version not supported - download DaVinci Resolve from [blackmagicdesign.com](https://www.blackmagicdesign.com/products/davinciresolve/) instead.
### Adobe Premiere Pro / After Effects Mode
1. Launch AutoSubs and open Premiere Pro or After Effects (the CEP extension loads automatically).
2. Select the Adobe integration from AutoSubs to export timeline audio for transcription, or import generated subtitles into your project.
3. In Premiere Pro, subtitles are imported as caption tracks; in After Effects, SRT entries are created as text layers.
### Command Line Interface
For command-line usage, see the **[CLI Guide](CLI.md)** with complete reference, examples, and troubleshooting.
---
## Documentation
- **[CLI Guide](CLI.md)** - Command-line interface reference
- **[Contributing Guide](CONTRIBUTING.md)** - Development setup and contribution workflow
- **[AutoSubs-App README](AutoSubs-App/README.md)** - Technical architecture and code organization
- **[Resolve Integration](Resolve-Integration/README.md)** - DaVinci Resolve integration architecture and development
- **[Adobe Extension](Adobe-Extension/README.md)** - Adobe Premiere Pro/After Effects integration details
> [!TIP]
> I highly recommend checking out **[DeepWiki](https://deepwiki.com/tmoroney/auto-subs)** for asking questions and understanding the codebase.
>
> [](https://deepwiki.com/tmoroney/auto-subs)
---
## Integrations
AutoSubs can run as a standalone subtitle generator, connect directly to DaVinci Resolve, or communicate with Adobe Premiere Pro and After Effects through the bundled CEP extension.
Select a Preset Style | Or create your own
:-------------------------:|:-------------------------:
| 
---
## What's New in v3.5
**Transcription:** Voice Activity Detection, multiple models (Whisper/Parakeet/Moonshine), improved speaker diarization, and built-in translation.
**Editing & UI:** Free-text subtitle editing with auto-timing, transcript history, 6 new UI languages, and custom titlebar.
**DaVinci Resolve:** Animated caption macro with per-word highlighting, preset system, marker-based word timing, and instant conflict detection.
**Bug Fixes (v3.5.1):** Formatting improvements, Resolve export corrections, Model Manager recovery, and Linux stability fixes.
---
## Contributing
PRs are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get started, including the dev setup and a full codebase walkthrough via **[AutoSubs DeepWiki](https://deepwiki.com/tmoroney/auto-subs)**.
For detailed information about the DaVinci Resolve integration architecture, Lua server, Fusion macro system, and development workflow, see [Resolve-Integration/README.md](Resolve-Integration/README.md).
---
## Acknowledgments
AutoSubs is built on top of excellent open-source projects:
- [whisper-rs](https://codeberg.org/tazz4843/whisper-rs) - Rust bindings for Whisper C++ library
- [transcribe-rs](https://github.com/cjpais/transcribe-rs) - ONNX Runtime transcription with Moonshine and Parakeet models
- [pyannote-rs](https://github.com/thewh1teagle/pyannote-rs) - Rust implementation of Pyannote for speaker diarization (integrated into app code for improvements)