v2.0 — CLI + New Online Chrome Extension

Subtitles that know
where every word lands.

Use the VTT Chrome Extension for live online Persian & English subtitles on YouTube and any video playing in Chrome — or run the offline Whisper CLI to generate timestamped .vtt / .srt files.

⬇ Free Chrome Extension (.zip) 🧩 Extension Repo (vtt-extention) CLI on GitHub

$ pip install video-to-text-vtt

New: VTT Chrome Extension (Free Install)

Minimal online subtitles for YouTube and any video playing in Chrome. Built for Persian (FA) and English (EN) with calm, sentence-paced reading speed and 1-click .vtt / .srt export.

در این ویدیو دربارهٔ معماری سیستم و پردازش آنلاین زیرنویس صحبت می‌کنیم.

1

Download & Unzip

Grab vtt-chrome-extension.zip from momalekiii/vtt-extention (or click vtt-subtitles.user.js for 1-click Tampermonkey install).

2

Open chrome://extensions

Open chrome://extensions in Chrome, Brave, or Edge and toggle Developer mode ON in the top-right corner.

3

Drop Folder or Load Unpacked

Drag the unzipped folder onto chrome://extensions (or click Load unpacked) — Persian & English subtitles start automatically!

One command in, real captions out

Point the Python CLI at a file, a whole folder, or a link. It figures out the rest.

zsh

$ vtt_run lecture.mp4 -lang fa --model medium

Transcribing: lecture.mp4

-> lecture.vtt

WEBVTT

00:00:00.000 --> 00:00:03.240

در این جلسه دربارهٔ معماری سیستم صحبت می‌کنیم.

00:00:03.240 --> 00:00:07.010

شروع می‌کنیم با نمای کلی از جریان داده.

Built for the whole pipeline

From watching online videos in Chrome to transcribing a folder of local lectures, VTT handles the boring parts.

Chrome Extension

Live online subtitles in Persian (FA), English (EN), or bilingual mode on YouTube and any video in Chrome.

Real timestamps

Genuine .vtt and .srt files with per-segment timing — not a single block of raw text.

Batch & YouTube

Hand the CLI a folder and it works through every clip, or drop in a YouTube link and skip the download step.

~100 languages

Auto-detects the spoken language, or pin it yourself with -lang for faster, more reliable results.

CPU or GPU

Pick a model size and device that fit your machine, from a quick tiny pass to a large-v3 run on CUDA.

Free & Open Source

MIT licensed by @momalekiii. Install the Python CLI from PyPI or grab the Chrome Extension zip for free.

v1 wrote a text file. v2 writes subtitles.

The name always promised .vtt files — v2 is the first version that actually delivers them.

v1 · output.txt

در این جلسه دربارهٔ معماری سیستم صحبت می‌کنیم شروع می‌کنیم با نمای کلی از جریان داده

v2 · output.vtt

00:00:00.000 --> 00:00:03.240
در این جلسه دربارهٔ معماری سیستم صحبت می‌کنیم.

00:00:03.240 --> 00:00:07.010
شروع می‌کنیم با نمای کلی از جریان داده.

CLI Install & Reference

Available on PyPI, or clone the repo and run it straight from source.

install

$ pip install video-to-text-vtt

$ pip install "video-to-text-vtt[youtube]" # optional, for URL input

-lang, --languageLanguage code (e.g. fa, en) — omit to auto-detect

--modeltiny · base · small · medium · large-v3

--deviceauto · cpu · cuda

--formatvtt · srt · txt · all

--offset / --durationTranscribe just a slice of the file, in seconds

-o, --outputOutput file, or output folder when batching

Subtitles that knowwhere every word lands.