tmoroney/auto-subs

★ 4,207⑂ 0

On-device subtitle generation that connects directly to DaVinci Resolve, Premiere, and After Effects.

4,207Star
0Fork
0Watch
0Issue
TypeScriptLanguage
-License
Created · last push · repository size 0 KB · default branch -

README

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.

Downloads Weekly App Opens New Downloads / Week Ask DeepWiki

https://github.com/tmoroney/auto-subs/blob/HEAD/AutoSubs UI

---

Download

| Platform | Installer | |---|---| | 🪟 Windows | AutoSubs-windows-x86_64.exe | | 🍎 macOS (Apple Silicon) | AutoSubs-Mac-ARM.pkg | | 🍎 macOS (Intel) | AutoSubs-Mac-Intel.pkg | | 🐧 Linux (Debian/Ubuntu) | AutoSubs-linux-x86_64.deb | | 🐧 Linux (Fedora/openSUSE) | AutoSubs-linux-x86_64.rpm |

macOS Homebrew

macOS users can also install AutoSubs with Homebrew:

brew install --cask auto-subs

Linux install

Debian/Ubuntu (.deb):

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 and open it with your package manager.

https://github.com/tmoroney/auto-subs/blob/HEAD/Buy Me A Coffee

---

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 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 with complete reference, examples, and troubleshooting.

---

Documentation

[!TIP]
I highly recommend checking out DeepWiki for asking questions and understanding the codebase.
> Ask DeepWiki

---

Supported Models

AutoSubs ships with several local transcription model families. All run fully on-device — nothing is sent to the cloud. Models are downloaded on demand from the in-app Model Manager.

Accuracy is a relative 1–4 rating within AutoSubs (higher is better). Sizes and RAM figures are approximate.

Whisper

OpenAI's Whisper, via whisper-rs (GGML). Each size is available in a multilingual variant and an .en English-only variant (the .en models are slightly more accurate on English audio).

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | tiny / tiny.en | 80 MB | 1 GB | Multilingual / English | ★ | | base / base.en | 150 MB | 1 GB | Multilingual / English | ★ | | small / small.en | 480 MB | 2 GB | Multilingual / English | ★★ | | medium / medium.en | 1.5 GB | 5 GB | Multilingual / English | ★★★ | | large-v3-turbo | 1.6 GB | 6 GB | Multilingual | ★★★ | | large-v3 | 3.1 GB | 10 GB | Multilingual | ★★★★ |

Moonshine

Useful Sensors' Moonshine, via ONNX Runtime. The tiny English model is quantized; the language-specific tiny variants and the base model are float-precision.

| Model | Size | RAM | Language | Accuracy | |---|---|---|---|---| | moonshine-tiny | 60 MB | 1 GB | English | ★ | | moonshine-tiny-ar | 120 MB | 1 GB | Arabic | ★★★ | | moonshine-tiny-zh | 120 MB | 1 GB | Chinese | ★★★ | | moonshine-tiny-ja | 120 MB | 1 GB | Japanese | ★★★ | | moonshine-tiny-ko | 120 MB | 1 GB | Korean | ★★★ | | moonshine-tiny-uk | 120 MB | 1 GB | Ukrainian | ★★ | | moonshine-tiny-vi | 120 MB | 1 GB | Vietnamese | ★★★ | | moonshine-base | 200 MB | 1 GB | English | ★★ |

Parakeet

NVIDIA's Parakeet-TDT-0.6B-v3 (int8 ONNX). Fast and accurate, with support for 25 European languages plus Russian and Ukrainian.

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | parakeet | 700 MB | 2 GB | 25 languages (EU + RU + UK) | ★★★★ |

SenseVoice

Alibaba's SenseVoice (int8 ONNX). Compact and well-suited to CJK audio.

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | sense-voice | 230 MB | 1 GB | Chinese, English, Japanese, Korean, Cantonese | ★★★ |

Canary

NVIDIA's Canary-1B-v2 (int8 ONNX). A multilingual encoder-decoder model that also supports native translation.

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | canary | 1 GB | 3 GB | 25 languages (EU + RU + UK) | ★★★★ |

Cohere

Cohere Transcribe (int4 ONNX). The highest-accuracy option for a focused set of 14 widely-spoken languages.

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | cohere | 2 GB | 4 GB | Arabic, German, Greek, English, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Portuguese, Vietnamese, Chinese | ★★★★ |

GigaAM

Sber's GigaAM v3 (int8 ONNX). A Conformer model trained on 700k hours of Russian speech — the most accurate option for Russian audio. The end-to-end CTC variant outputs punctuated, normalized text.

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | gigaam-v3 | 225 MB | 2 GB | Russian, English | ★★★★ |

GigaAM Multilingual (600M, int8 ONNX) covers Central Asian languages that the other models handle poorly — Whisper large v3 scores 58–110% WER on Kazakh, Kyrgyz and Uzbek. It uses a character-wise CTC head, so unlike GigaAM v3 its output has no punctuation or capitalization.

| Model | Size | RAM | Languages | Accuracy | |---|---|---|---|---| | gigaam-multilingual | 592 MB | 3 GB | Russian, Kazakh, Kyrgyz, Uzbek, English | ★★★★ |

Diarization & VAD

In addition to transcription models, AutoSubs downloads a speaker diarization model (~40 MB, user-selectable from the Model Manager) and a Silero VAD model (auto-downloaded for voice activity detection during transcription).

---

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 :-------------------------:|:-------------------------: https://github.com/tmoroney/auto-subs/blob/HEAD/Transcription Page | https://github.com/tmoroney/auto-subs/blob/HEAD/Advanced Settings

---

Contributing

PRs are welcome! See CONTRIBUTING.md for how to get started, including the dev setup and a full codebase walkthrough via AutoSubs DeepWiki.

For detailed information about the DaVinci Resolve integration architecture, Lua server, Fusion macro system, and development workflow, see Resolve-Integration/README.md.

---

Model licensing

AutoSubs code is MIT-licensed. The optional MMS forced-alignment weights are downloaded separately and licensed under CC BY-NC 4.0 for noncommercial use. Users are responsible for ensuring their use complies with the model license.

The forced-aligner weights originate from Meta's MMS model, with forced-alignment conversion work by MahmoudAshraf and ONNX/INT8 conversion by onnx-community. Conversion and quantization changes were made by those respective projects; no endorsement is implied.

While MMS supports over a thousand languages, word-level alignment relies on romanizing the transcript with uroman. uroman covers the major world scripts (Latin, Cyrillic, Arabic, CJK, most Indic scripts, etc.), but very low-resource minority languages whose scripts are not included in its data may produce degraded or missing word timestamps.

Acknowledgments

AutoSubs is built on top of excellent open-source projects:

More Video Trending projects

1

Genymobile / scrcpy

C★ 149,650⑂ 0
2

harry0703 / MoneyPrinterTurbo

Python★ 123,776⑂ 0
3

obsproject / obs-studio

C★ 76,223⑂ 0
4

FFmpeg / FFmpeg

C★ 64,235⑂ 0
5

calesthio / OpenMontage

Python★ 59,205⑂ 0
6

heygen-com / hyperframes

TypeScript★ 50,163⑂ 0