Download

Get Subtitld.

Free, for Linux, Windows, macOS and Haiku. No account, no ads, no paid tier. Pick the channel you already use; each one keeps Subtitld up to date.

26.11 stableWhat's new →

Linux

Any distribution
  • Snap StoreOpen
    sudo snap install subtitld
  • FlathubOpen
    flatpak install flathub org.subtitld.Subtitld
  • Arch Linux (AUR)Open
    yay -S subtitld

Windows

From the Microsoft Store, it updates by itself. Or take the installer, for you alone or for everyone on the computer, or the portable version that runs from any folder.

Windows 10 and 11, 64-bit.

macOS

Install from PyPI with Python 3.10 to 3.14 and FFmpeg on the PATH. Homebrew gives you both.

brew install python ffmpeg pip3 install subtitld subtitld

Not signed yet: the first time you open it, allow it in System Settings › Privacy & Security.

Haiku

Subtitld runs natively on Haiku, with its own icon and the system's window decorator. It isn't in HaikuPorts: its packages come from Subtitld's own repository.

Haiku

Subtitld on Haiku

Subtitld runs natively on Haiku, but it isn't in HaikuPorts. Why, and how to install it.

Subtitld runs natively on Haiku. It is the same program as on Linux, with Haiku's own touches: Deskbar and Tracker show it with its icon, and its projects (.usfx) have a file type of their own, so Tracker opens them in Subtitld. To draw its subtitles it uses QtWebEngine, so we ported QtWebEngine 6 to Haiku too. We wrote recipes for HaikuPorts, tested them on R1/beta6, and worked through the review.

They were not accepted. The Python modules Subtitld needed in newer versions were merged, and we are grateful for that. Subtitld itself was turned down: the reviewers felt it could be installed with pip, and that its code looked "vibecoded", written by AI. The QtWebEngine port said from its first line that it was made with an AI coding assistant, so the maintainers could decide with that in view. It was closed the same day: "We don't want vibecoded patches at HaikuPorts even if copyright wasn't an issue."

We won't hide that this is frustrating. Subtitld is maintained mostly by one person. The AI does most of the porting and packaging so that this person's time can go into the application itself, which is what brought them to Haiku in the first place. Every change was directed, run and tested by a person. Porting something the size of Chromium by hand, beside Subtitld, was never going to happen otherwise. And we would much rather not split the Haiku ecosystem with a repository of our own; we have simply been left no other route.

Still, Haiku is their project, and the call is theirs to make. Its developers have real concerns about where code comes from, and they have built something remarkable with very few hands. We respect that, even though we see it differently, and the door stays open from our side.

Install from our repository

Add Subtitld's repository once, and Subtitld gets its updates along with the rest of your system. The subtitld package brings Subtitld, the Python modules HaikuPorts doesn't have, and QtWebEngine; everything else, PySide6 included, comes from HaikuPorts. In Terminal:

pkgman add-repo https://hpkg.subtitld.org
pkgman install subtitld

Subtitld then appears in Deskbar's Applications menu. It needs 64-bit Haiku R1/beta6 or newer. The recipes are in packaging/haiku, and the QtWebEngine port, with its history, in qtwebengine-haiku.

Any system with Python

From PyPI

Python 3.10 to 3.14 and FFmpeg on the PATH. On Linux the audio also needs PortAudio: libportaudio2 on Debian and Ubuntu.

$ pip install subtitld
$ subtitld
For contributors

Run from source

The same requirements, in a virtual environment. Each test runs Qt off-screen with its own scratch settings.

$ git clone https://github.com/Subtitld/subtitld.git
$ cd subtitld
$ python3 -m venv .venv
$ .venv/bin/pip install -e .
$ .venv/bin/subtitld

Which channel?

Channel Updates Sandboxed Beta Good for
Snap Store Automatic Yes beta channel Ubuntu and most distributions
Flathub With your software centre Yes — Fedora, GNOME and KDE desktops
AUR With your AUR helper No — Arch and Manjaro
AppImage Download again No — Trying it without installing
Microsoft Store Automatic Yes — Most Windows users
PyPI pip install -U No — macOS, and Python users anywhere
After installing

Add the engines you need.

Transcription, translation and most voices are add-ons, installed from Settings › Add-ons. Many run fully offline.

First-video tutorial