Skip to content

tmoroney/auto-subs

Repository files navigation

AutoSubs V2 – Subtitles Made Simple

Create high-quality subtitles effortlessly with one click. AutoSubs delivers fast, accurate, and fully customisable subtitles in a sleek, intuitive interface.

πŸ“₯ One-Click Installer: Windows ✨ MacOS (ARM)

πŸ’‘ 14,000+ downloads in under 2 months!

πŸš€ Key Features

⚑ Blazing Fast: Lightning-fast transcription in nearly any language.

πŸ—£οΈ Speaker Diarization: Detect different speakers & color-code subtitles automatically.

🌏 English Translation: Convert subtitles to English (more languages coming soon).

🎨 Modern UI: A clean, user-friendly designed for creators.

πŸ“¦ One-Click Installer: One-click installer for Mac (ARM) & Windows. (Linux & Intel Mac support coming soon!)

Generate Subtitles & Label Speakers Advanced Settings
Transcription Page Advanced Settings

Setup:

1. Download & Install

  • Click the download link for your operating system above.
  • Open the installer and follow the on-screen instructions.

2. Launch AutoSubs in DaVinci Resolve

  • Open DaVinci Resolve.
  • In the top menu, go to Workspace β†’ Scripts β†’ AutoSubs V2.

You’re all set! πŸš€ AutoSubs V2 is now ready to generate subtitles effortlessly.

Watch this helpful tutorial to get you started with AutoSubs: Watch Now

AutoSubs V1 (Legacy Version)

If your OS isn’t supported by AutoSubs V2, you can try AutoSubs V1 using manual installation. However, this requires basic experience with Python and the terminal, and this version is no longer supported so any errors you will have to fix yourself.

Warning

If using the free version, you must be on Resolve 19.0.3 or earlier, as Blackmagic removed the built-in UI manager in v19.1.

Contribute to AutoSubs

If you would like to contribute to the development of AutoSubs, follow the steps below.

Set Up for Development

  1. Clone this repository to whatever directory you wish.
  2. Copy the AutoSubs V2.lua file from the following directory within the repo: auto-subs/AutoSubs-App/src-tauri/resources
  3. Paste the AutoSubs V2.lua file inside one of the directories below so that Resolve can see it:
  • Windows: %appdata%\Blackmagic Design\DaVinci Resolve\Support\Fusion\Scripts\Utility
  • Mac: /Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility
  1. Open AutoSubs V2.lua and set the variable DEV_MODE to true at the top of the file. Since we will be running the Tauri app in dev mode, we must turn on dev mode which will prevent the Lua server from opening the main Tauri application when the script it is started.

Start Python Transcription Server

Open a new terminal in the repository and run the following commands to start the python transcription server. This python server is responsible for anything machine learning related such as Transcribing audio and Speaker Diarization.

Mac (ARM)

cd Transcription-Server
python -m venv .venv
source .venv/bin/activate
pip install -r requirements-mac.txt

Windows

cd Transcription-Server
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements-win.txt

Start LUA server

This LUA script is a server that runs in the background and waits to recieve a request from the frontend Tauri app. This script is responsable for any interaction with Resolve, such as adding Text+ subtitles to the timeline and exporting the timeline audio.

  1. Open Resolve
  2. Navigate to Scripts and open AutoSubs V2

Start Tauri App (Frontend UI)

cd AutoSubs-App
npm install
npm run tauri dev

Libraries Used

  1. Stable-TS
  2. MLX-Whisper
  3. Faster-Whisper