# Convert SRT subtitles to VTT

> Markdown version of https://stella.sh/how/video/convert-srt-to-vtt for agents and LLMs.
> Turn .srt subtitles into WebVTT for an HTML5 video player, with exact timings and accents that don't break: Subtitle Edit, ffmpeg, or Stella (stella.sh).

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.

- Checked: 13 November 2026
- Stella does it on: Windows, Mac, Linux

## Stella doing it

Recorded 13 November 2026 on Linux (Omarchy) with Claude Code with Opus, on a Claude plan.
Result: 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.

Video (42 s): https://stella.sh/media/proofs/video/convert-srt-to-vtt/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. Eight .srt subtitle files are in a Garden series folder in Videos.
- 0:01 The prompt: convert all eight to .vtt for a website player, timings exactly the same.
- 0:17 Stella notes episode 3 isn't valid UTF-8, probably an old Windows encoding, and checks it.
- 0:27 Done: eight .vtt files, all 260 timings compared and matching, episode 3's accents fixed.

What Stella does:

1. Finds the eight .srt files in the Garden series folder in Videos and reads them
2. 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
3. Writes a .vtt next to each .srt: the WEBVTT header, commas in timestamps changed to full stops, and nothing else in the text changed
4. Reads episode 3 in its real encoding, removes an invisible byte-order mark from episode 5, and makes line endings consistent
5. Compares every timestamp in all 260 subtitles against the originals, keeps italics, and leaves the .srt files unchanged

## The prompt to paste

```text
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.
```

## Convert them yourself

1. **One file in a text editor.** Open the .srt in a plain-text editor (TextEdit in plain-text mode, Notepad). Add `WEBVTT` and an empty line at the very top. In each timing line, change the comma before the milliseconds to a full stop (`00:00:01,250` becomes `00:00:01.250`). Leave commas in the dialogue alone. Save as UTF-8 with a .vtt extension.
2. **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.
3. **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 CP1252` before `-i` or the accents break.
4. **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.
5. **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 Stella 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](https://stella.sh/how/video/make-srt-subtitle-file). To burn them into the picture for social media, see [burn subtitles into a video](https://stella.sh/how/video/burn-subtitles-into-video-for-tiktok).

**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.

Sources: [W3C: WebVTT format](https://www.w3.org/TR/webvtt1/), [Subtitle Edit command line (seconv)](https://niksedk.github.io/subtitleedit-avalonia/reference/command-line.html), [MDN: the track element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/track).

## Related problems

- [Create an SRT subtitle file from a video](https://stella.sh/how/video/make-srt-subtitle-file.md)
- [Add burned-in subtitles to a video for TikTok](https://stella.sh/how/video/burn-subtitles-into-video-for-tiktok.md)
- [Convert MOV to MP4 so your phone videos play anywhere](https://stella.sh/how/video/convert-mov-to-mp4.md)
- [Cut silences out of a video automatically](https://stella.sh/how/video/cut-silences-from-video.md)
- [Compress a video for Discord](https://stella.sh/how/video/compress-video-for-discord.md)
- [Convert MKV to MP4 so your TV plays it](https://stella.sh/how/video/convert-mkv-to-mp4.md)

Get Stella: https://stella.sh/download. Free with the ChatGPT or Claude plan you already have.
