Convert SRT subtitles to VTT
Eight subtitle files as .vtt with every timing identical and the accents fixed.
A real run on 13 November 2026, on a Linux computer, using Claude Code with Opus, on a Claude plan.
The short answer.
WebVTT is SRT with a WEBVTT line at the top and full stops instead of commas in the timestamps. For one file, a text editor will do; for a folder, the free Subtitle Edit batch-converts, and ffmpeg converts one file per command. The trap is old SRTs saved in a Windows encoding, whose accents turn to garbage. Stella (stella.sh) converted eight SRTs, kept all 260 timings exactly, and fixed one file's broken encoding.
Stella does this on Windows, Mac and Linux.
What happened.
Eight .vtt files in about 1 minute. Checked afterwards against an answer key written before the run: 8 files that start with WEBVTT and keep every cue's exact timing and text, the Windows-encoded episode's accents (café, jardín, crème) right, italic tags kept, no byte-order mark, and the .srt files unchanged.
The subtitles were written for this run, with three files saved the awkward ways real ones often are. The recording plays at normal speed.
How Stella does it.
- Finds the eight .srt files in the Garden series folder in Videos and reads them
- Notices episode 3 isn't valid UTF-8 and checks it: it was saved in an older Windows encoding, so accents like café and jardín would break
- Writes a .vtt next to each .srt: the WEBVTT header, commas in timestamps changed to full stops, and nothing else in the text changed
- Reads episode 3 in its real encoding, removes an invisible byte-order mark from episode 5, and makes line endings consistent
- Compares every timestamp in all 260 subtitles against the originals, keeps italics, and leaves the .srt files unchanged
The prompt.
The subtitle files in the Garden series folder in my Videos are .srt, but my website's video player needs .vtt. Convert all eight and keep the timings exactly the same.
This is the exact prompt from the recording. If your files are somewhere else, say where.
Do it yourself.
One file in a text editor
Open the .srt in a plain-text editor (TextEdit in plain-text mode, Notepad). Add
WEBVTTand an empty line at the very top. In each timing line, change the comma before the milliseconds to a full stop (00:00:01,250becomes00:00:01.250). Leave commas in the dialogue alone. Save as UTF-8 with a .vtt extension.A folder: Subtitle Edit
In the free Subtitle Edit (Windows, with a newer cross-platform build for Mac and Linux), open Tools, Batch convert, add the .srt files, set Format to WebVTT and press Convert. If accents look wrong, set the input encoding to Windows-1252 and try again.
ffmpeg
ffmpeg -i "Garden series E01.srt" "Garden series E01.vtt"converts one file. For a file in an old Windows encoding, add-sub_charenc CP1252before-ior the accents break.Check the encoding
If you see é where é should be, or a question mark in a diamond, the file was read in the wrong encoding. Reopen it as Windows-1252 (or Latin-1) and save it as UTF-8 before converting.
Hook it up on the page
In HTML, add
<track kind="subtitles" src="E01.vtt" srclang="en" label="English">inside the<video>element. The .vtt must be served from the same site, or with CORS allowed.
Where it stops.
- It converts files; it doesn't upload them to your site or edit your player's code unless you ask.
- Styling beyond italics and bold may not show the same in every player.
- The subtitle text was read by the AI model you use in Stella to work out encodings and check the conversion. Fine for most subtitles; keep in mind for unreleased material.
- Recorded on Linux. The conversion used Stella's built-in scripting, nothing installed, so it works the same on a Mac or Windows PC.
Questions.
What's the difference between SRT and VTT?
Almost nothing for plain subtitles: VTT starts with a WEBVTT line and uses full stops in timestamps. VTT also supports positioning and styling, and it's the format HTML5 video players read.
Will converting change my subtitle timings?
It shouldn't. Only the separator character changes. Stella compared all 260 timestamps after converting and every one matched.
Can I convert VTT back to SRT?
Yes, the same way in reverse, or with ffmpeg -i in.vtt out.srt. Ask Stella and it will do the folder.
Can it make subtitles from scratch?
Yes: see make an SRT subtitle file. To burn them into the picture for social media, see burn subtitles into a video.
Is Stella free for this?
Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.
Can I control what Stella changes on my computer?
Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.
Checked against these sources on 13 November 2026.