subthis

Turns a video (or audio file) into an SRT subtitle file with short, accurately worded captions, at most three words per cue. Built for Hebrew with English tech terms mixed in: it transcribes twice through the OpenAI API (gpt-transcribe for wording, whisper-1 for word timing), aligns the two, and canonicalizes product names like OpenAI, Claude and ChatGPT.

Works on Linux, macOS and Windows. No Python dependencies outside the standard library.

Requirements

ffmpeg (ffmpeg and ffprobe on PATH). subthis setup tells you how to install it if it's missing.
An OpenAI API key.

Install

With uv (installs Python too if needed):

uv tool install subthis

Or with pipx:

pipx install subthis

Both pull subthis from PyPI and put a subthis command on your PATH on any OS. To try it without installing: uvx subthis video.mp4.

If the subthis command isn't found after installing, run uv tool update-shell (uv) or pipx ensurepath (pipx) and open a new terminal.

Setup

subthis setup

Checks for ffmpeg, asks for your OpenAI API key (input hidden), verifies it against the API, and stores it in the config directory:

Linux/macOS: ~/.config/subthis/
Windows: %APPDATA%\subthis\

It also creates terms.txt there, where you can add professional terms and spelling corrections:

MyCompany
DaVinci Resolve = דה וינצ'י ריזולב | Davinci Resolve

OPENAI_API_KEY in the environment overrides the stored key.

Use

subthis lecture.mp4                 # writes lecture.srt next to the input
subthis talk.mp4 -o subs/talk.srt   # explicit output path
subthis clip.mp4 --max-words 2      # shorter cues
subthis clip.mp4 --term "Omarchy"   # one-off extra term
subthis clip.mp4 --language he --language en

Long videos are chunked and merged automatically; uploads stay under OpenAI's 25 MB limit.

Tests

python -m unittest discover -s tests

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

subthis-1.3.0.tar.gz (16.6 kB view details)

Uploaded Sep 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

subthis-1.3.0-py3-none-any.whl (14.6 kB view details)

Uploaded Sep 2, 2026 Python 3

File details

Details for the file subthis-1.3.0.tar.gz.

File metadata

Download URL: subthis-1.3.0.tar.gz
Upload date: Sep 2, 2026
Size: 16.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for subthis-1.3.0.tar.gz
Algorithm	Hash digest
SHA256	`f3b47e332555c2f6723aafb78d56bcd6f752ba2144c1163c116c1ee54cc5bf56`
MD5	`9f49f85da6352aa97892cb32a6b6d3f9`
BLAKE2b-256	`6022ff396328753b54fc9511dd98ae90708f50f4f6e2fb2b88d438f45a392206`

See more details on using hashes here.

Provenance

The following attestation bundles were made for subthis-1.3.0.tar.gz:

Publisher: release.yml on ItayCohen-Prog/subthis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: subthis-1.3.0.tar.gz
- Subject digest: f3b47e332555c2f6723aafb78d56bcd6f752ba2144c1163c116c1ee54cc5bf56
- Sigstore transparency entry: 2685039225
- Sigstore integration time: Sep 2, 2026
Source repository:
- Permalink: ItayCohen-Prog/subthis@b427e07cfd43d66645465d67241add06b244f037
- Branch / Tag: refs/tags/v1.3.0
- Owner: https://github.com/ItayCohen-Prog
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@b427e07cfd43d66645465d67241add06b244f037
- Trigger Event: push