Subtitles - KuchiSofts/vlc-redesign GitHub Wiki

Subtitles

VLC Redesign shows subtitles in your language by itself: from the video, from a file next to it, or found online. It learns the languages you pick, remembers the subtitle of each file and the timing of each series, and lets you fix early or late subtitles, and move or resize them, while you watch.

English, Hebrew, Japanese and Arabic subtitles in turn with the V key

English, Hebrew, Japanese and Arabic subtitles in turn with V: sharp, and Hebrew and Arabic in the right order, with their brackets and punctuation. Click for the MP4 · every clip: Feature tour.

Everything here happens in the Subtitles tab of the Languages and tracks panel. The look of the subtitles (font, colours, outline, shadow, box) and the languages are also in Settings: Subtitles.

Your languages

Three languages decide which subtitles show by themselves:

Language Where it is set Until you choose
Default Preferred language in Settings: Subtitles, the installer and the first-run setup The language of Windows
Second Second language (when there are none in the preferred one), same places English (none when the default one is English)
Learned Nothing to set: the language you pick most by hand (see Learning your languages) None

When a video opens, VLC shows its track in the default language; if it has none, in the second one; if it has neither, in the learned one. When the video has none of them, the online search looks for them (see Subtitles found online).

Before you choose any subtitle language, a video's own track in the language of Windows is shown, except for English: an English film would otherwise always show its English subtitles.

The Subtitles tab

The tracks panel: Video, Audio and Subtitles tabs, the subtitle languages with their own names, Hebrew picked

The Video, Audio and Subtitles tabs of the panel; the subtitle languages of the video, each in its own language; Hebrew picked. Click for the MP4 · every clip: Feature tour.

Languages and tracks in the control bar opens a panel above the button with three tabs, Video, Audio and Subtitles; it opens on Subtitles. A second click on the button, a click outside the panel or Esc closes it, without pausing the video.

The Subtitles tab: the header Subtitles of this video with its four buttons, the languages Off, English (Default), German (Deutsch, Often used), French (Français) and Spanish (Español de España), each with its count, the German track chosen with Next to the video · clip1.de.srt under it, and Subtitle timing with Mark voice heard, Mark text seen and Reset

From top to bottom:

  1. The header: what the online search is doing or found (Subtitles of this video, Identifying the video…, Searching OpenSubtitles, Wizdom…, Breaking Bad · S01E02 · 24 found), and four buttons:

    Button What it does
    Magnifier (The video is another one: search by its title) Opens the title search (see Wrong title).
    Arrows (Search subtitles online / Search subtitles online again) Runs the online search now.
    Pencil (Add subtitles to the library) The subtitle window of the library (see Attach subtitles for good). Dimmed for a stream or without the media library: Library association needs a local media file and media library.
    + (Load a subtitle file for playback) Opens a subtitle file for this playback only.
  2. The languages on the left, and the subtitles of the language chosen on the right.

  3. Subtitle timing: the delay slider and the sync buttons, then Series preset.

  4. Position and size.

A language or a subtitle you click shows at once on the video.

The languages

The list starts with Off (no subtitles). Then come the languages this video has, in its own tracks or among the subtitles found online, in this order:

Order Marker Which languages
1 Default Your default language.
2 Second Your second language.
3 Often used The languages you pick yourself, the most picked first. A language rises here from the first pick; the marker shows from the second pick in a row.
4 The other languages of the video's own tracks, by name.
5 The other languages found online, by name.
last Unknown language: tracks that name no language.

Each row shows the language's name in the language of the interface, its own name for itself (Deutsch, Français), and how many subtitles it has. A language you have no subtitle in does not show: there is nothing to pick.

The subtitles of a language

The list on the right holds the subtitles of the language chosen: the video's own first, then those found online. The one showing has a check. Under each, where it comes from:

Label Where it comes from
In the video A track of the file itself.
Next to the video · file A subtitle file VLC found next to the video, or in the folders of Load subtitles from these folders.
Opened · file (or Opened file) A file you opened yourself.
Downloaded from service A subtitle downloaded earlier: from the cache.
service · downloads A subtitle found online, not downloaded yet: its service and how many times it was downloaded (12k downloads).

Badges: For this file (made for this very file: the same fingerprint), HI (For the hearing impaired), Foreign parts only (only the lines of foreign speech).

Click a subtitle to show it. One found online is downloaded first (Downloading…).

Learning your languages

Each time you pick a subtitle language by hand (a language row or one of its subtitles), it counts for that language, once per video. Every pick is worth 1, and each pick also makes the earlier ones fade: all the scores are multiplied by 0.9 first. So what you picked recently counts most.

  • It rises. A language you pick moves up the list, under your default and second languages.
  • It is marked. From a score of 1.5 (two picks in a row) it reads Often used.
  • It is chosen for you. From a score of 2.5 (three picks in a row) it becomes the learned language, the third automatic one. A video with no track in your default or second language shows its track in the learned language by itself; and when the online search finds nothing in your default or second language either, it loads the best subtitle in the learned one.
  • It fades. If you stop picking it, other picks make it fade, and the language you pick now takes its place. Only one language is learned at a time: the one with the highest score.

Your default and second languages never count as learned: they already come first.

Example: you watch with German subtitles three times. German is now marked Often used and is chosen for a film that has no subtitles in your default or second language.

Subtitles that come with a download

Films often come in a folder with subtitle files of their own. VLC Redesign uses them, and is not fooled by the files that are not really subtitles:

  • A Subs or Subtitles folder. When the video is the only one in its folder, a file in your language in its Subs or Subtitles folder (Hebrew.heb.srt, English (SDH).eng.srt, named by language rather than after the film) shows by itself, and nothing is searched online for that language. The plain one comes before the one for the hearing impaired (SDH, HI, CC).
  • An advert or forced lines are not your subtitles. Some sites put a small .srt named after the film next to it, with only their advert ("Downloaded from ...") or a line or two; files of only the forced lines (signs and foreign words) are common too. Such a file, a subtitle with under one line per five minutes of a film of 20 minutes or more, or with forced in its name, does not count as your language: the online search still runs. A short film's own small subtitle always counts.
  • Hebrew and Arabic punctuation in its place. Many subtitle sites write a line's final punctuation first and its dialogue dash last (.שלום, ?מה-), for players that lay every line out left to right. VLC Redesign moves them back (שלום., -מה?), only in the files written that way. With Text direction set to Left to right, lines stay as their file has them.

The same on Android and on the Samsung TV app.

Subtitles found online

When a video opens with no subtitles in your languages, VLC Redesign looks for some online (once its picture shows, a moment after it starts) and loads the best one: in your default language, else the second one, else the learned one. This is Find subtitles online when a video has none in these languages (Settings: Subtitles), asked by the installer and the first-run setup. With it off, the search runs only when you click the search button of the header.

How it works:

  1. The video is identified. Its file name gives the title, the year, and the season and episode (S01E02, 1x02, Season 1 Episode 2; the folder too, as in Show Name/Season 1/02.mkv). IMDb's suggestions, then Wikidata, then Stremio's Cinemeta give its IMDb id. The header shows Identifying the video…, then the title found (Breaking Bad · S01E02).
  2. The services are asked together (Searching OpenSubtitles, Wizdom…), for the languages to search (below). Their subtitles are listed as they come, those made for this very file first (3 found for this file); the line under the title says what each service found (OpenSubtitles 7 · SubSource 3 · Wizdom 4), a dash for one that didn't answer or refused your key (the reason in its tooltip).
  3. A click loads one. It is downloaded, unpacked (only its subtitles, 16 MB at most), converted to UTF-8, kept in the cache and remembered for the file (Downloading…).

The services, in the order of Settings › Subtitles › Subtitle services. The four without an account are on at first; the others are off until you give them your own free key (they turn on by themselves the first time Test finds it works):

Service What it has Needs
OpenSubtitles All languages, movies and series; finds those made for your very file. nothing
OpenSubtitles.com All languages, movies and series (the newer OpenSubtitles). your free key; your account for more downloads a day
SubSource Many languages, strong in Arabic (#70). your free key
SubDL Many languages: the archive of Subscene. your free key
Wizdom Hebrew, movies and series. Asked only when Hebrew is one of your languages to search. nothing
Addic7ed Series, many languages (through Gestdown). nothing
YIFY Subtitles Movies, many languages. nothing
Titlovi Croatian, Serbian, Bosnian, Slovenian, Macedonian. your free account
Assrt Chinese (simplified and traditional). your free token
Jimaku Anime, Japanese. your free key
BetaSeries Series, French. your free key
Subs.ro Romanian. your free key
Napisy24 Polish; finds those made for your very file. your free account
Legendas.net Portuguese (Brazil). your free account (its email)

The services of one language (Wizdom, Titlovi, Assrt, Jimaku, BetaSeries, Subs.ro, Napisy24, Legendas.net) are asked only when one of their languages is one of your languages to search; each row says which.

Checked and not added: Podnapisi (its address is gone), Subscene (closed: SubDL and SubSource keep its archive), Subf2m (hides its subtitle links from programs), BSPlayer (plain HTTP only, and it failed), Ktuvit (Hebrew: it didn't answer on 2026-11-08), Titulky and Legendas.tv (pages behind a sign-in, no interface for programs).

Languages to search

Settings › Subtitles › Languages to search lists the languages the services are asked for, in the order of the results: your preferred and second languages (always there, the preferred one always on), and those you add with Add a language (a list to type in: a language's name in English, in its own language, or its code). Each has a switch, Move up and Move down, and Remove (not the preferred one). The languages you often pick by hand are added off, for you to turn on.

Every other language too (off at first) asks the services for every language as well; off, they are asked only for the languages on, which makes the search faster (Fewer languages: a faster search). The search that runs by itself when a video has none in your languages uses the same list.

The services page

Settings › Subtitles › Subtitle services: each service with what it has and its switch.

  • A service that takes a key or an account shows its fields when it is on or has them: Your free key (hidden, with Show), User name and Password where it takes them ((optional) when the key alone is enough). Test (or Sign in) asks it once: Key works, Signed in as …, Key refused, Wrong user name or password, Busy: try again in a minute or No answer, try again. Clear (or Sign out) forgets them. Get a free key (or Create a free account) opens the page where it is made. Turning one on without them puts you in its first field.
  • A service of one language says so: Asked only when Hebrew is one of your subtitle languages.
  • What a search found shows on its row until it changes: Key refused: check it, Sign-in refused: check it (until the key or the account changes, or a search works), Busy: try again in a minute (a minute).
  • Remove (the ✕ of a row) takes a service out of the list: it is never asked. Add a service lists the ones removed, to bring them back. Off is not removed: a service off stays in the list.

The keys and passwords stay on the computer, in the settings of VLC Redesign (on Windows sealed for your user on this PC, so a copy of the settings elsewhere can't read them), and are sent only to their own service. They are never written to the log.

Free keys

Service How to get it
OpenSubtitles.com See A free OpenSubtitles.com key.
SubSource Sign up on subsource.net, then on your dashboard's API tab choose Create an API key and copy it into Your free key. A free key asks up to 60 times a minute, 7,200 a day.
SubDL Sign up on subdl.com, then open subdl.com/panel/api (API in your panel) and copy your API key into Your free key.
Titlovi Create an account on titlovi.com and confirm it; then Sign in with its user name and password.
Assrt Sign up on assrt.net; your API token is in your user panel (assrt.net/usercp.php). Copy it into Your free key.
Jimaku Sign in on jimaku.cc and open your account page (jimaku.cc/account): generate an API key there.
BetaSeries Create an account on betaseries.com, then ask for an API key at betaseries.com/api (free for personal use).
Subs.ro Create an account on subs.ro, then get your API key at subs.ro/api.
Napisy24 Create an account on napisy24.pl; then Sign in with its user name and password.
Legendas.net Create an account on legendas.net; then Sign in with its email and password.

What is sent: the video's title, its IMDb id, its file name and a fingerprint of the file (its size and its first and last 64 KB), nothing else. The cache keeps the subtitles of the last 500 media and drops those not used for 60 days.

When the title found is wrong

Click the magnifier of the header (The video is another one: search by its title): a field opens, Title of the movie or series, with the titles that match as you type. Pick the right one; the search runs again for it, and the choice is remembered for the file.

Subtitle timing (sync timeline)

Subtitle timing shows the delay (+250 ms) and a slider from −10 s to +10 s in steps of 50 ms: earlier on the left, later on the right. Then three buttons fix a delay by ear:

  1. Mark voice heard: click it when you hear a line spoken (it reads Voice marked).
  2. Mark text seen: click it when you see that line's text (it reads Text marked).
  3. Once both are marked, in either order, the subtitles move by the time between the two clicks.

Click a marked button again to unmark it. Reset puts the delay back to 0.

The keys do the same: Shift+H (the voice), Shift+J (the text), Shift+K (apply), Ctrl+Shift+K (reset). H and G move the subtitles later or earlier step by step. A delay for every video is Subtitle delay in Settings: Subtitles.

Presets per series

Series preset, under the timeline, keeps the choices of a series for its other episodes.

  • Save keeps, from the episode playing: the audio track, the subtitle track (or Off), the subtitle delay, the delay of the second subtitles and the subtitle speed. The panel reads Saved for episodes of breaking bad., then Applies to episodes of breaking bad.
  • The next episodes of the series apply it by themselves (Series preset applied.). If a track it names is not in an episode: A saved audio or subtitle track is unavailable in this episode.
  • Remove forgets it (Series preset removed.).

A series is the folder of the file plus the name before its S01E02 (in lower case, dots and dashes read as spaces). A file without such a name counts its whole folder as the series. Presets need a local file: Play a local episode to save its track and timing choices.

Position and size

Ctrl and the mouse wheel over the video change the subtitle size, up to 200 % and down to 50 %

Ctrl + mouse wheel over the video: the subtitle size up to 200 %, then down to 50 %, from the next line on. Click for the MP4 · every clip: Feature tour.

The panel faded while the subtitles are adjusted: Position +12 % and Size 130 % with their − and + buttons and Reset, the subtitle line visible through the panel

Position and size, at the end of the Subtitles tab:

Row − / + Range Reset
Position Move the subtitles down / Move the subtitles up, 1 % of the picture's height a click −20 % (lower) to +60 % (higher); Usual at 0 Back to Usual
Size Smaller subtitles / Larger subtitles, 10 % a click near 100 %, then 25 % (the steps of Ctrl+wheel) 25 % to 500 %; 100 % as usual Back to 100 %
  • The buttons repeat while held.
  • The subtitles move and grow on the video as you click, and the panel fades meanwhile so you see them behind it.
  • The change stays for the next videos and the next starts.

The video after the change: the subtitle line sits higher in the picture than usual

Keys: Shift+Up / Shift+Down move them (1 % a press, same range); Ctrl+wheel over the video makes them larger or smaller, as in classic VLC: 10 % a turn near 100 %, then 25 %, from 25 % to 500 %, with a short Subtitle size 120% message; Ctrl+0 goes back to 100 %. Elsewhere in the window Ctrl+wheel zooms the whole interface. ASS/SSA subtitles follow the size while they play. The same position is Vertical position in Settings: Subtitles.

While the Continue where you left off? card shows, the subtitles rise above it and the controls, and go back down when it closes.

Font and style

Settings: Subtitles › Appearance: the font (a list of the fonts installed), the size (relative or in pixels), bold, the text colour and opacity, the outline, the shadow, a box behind the text, and the vertical position. A change reaches the video playing from its next line.

Dual subtitles

With Show both languages at once (dual subtitles) (Settings: Subtitles, once a second language is chosen), the subtitles of the default language and those of the second one show together; the second one is found online too when the video lacks it. Ctrl+Shift+V (Toggle secondary subtitle control) makes the subtitle keys (delay, position) act on the second subtitles; the series preset keeps their delay too.

Attach subtitles for good

The pencil of the header (Add subtitles to the library), or Add Subtitle Tracks in the right-click menu of a video, folder or playlist of the library, opens the subtitle window of the library:

  • From Computer (files you choose), From Link (a Direct HTTPS link to a subtitle file) or From OpenSubtitles (a search with your own OpenSubtitles API key, Username and Password: see A free OpenSubtitles.com key).
  • To This File, To This Folder or To This Playlist.

The subtitles attached play with the media every time. Add Audio Tracks does the same for audio files. It needs a local file and the media library.

A free OpenSubtitles.com key

The online search of the player needs no account. OpenSubtitles.com, the newer OpenSubtitles, asks for a key of your own; it is free:

  1. Sign up on opensubtitles.com (a free account).
  2. Open API consumers: opensubtitles.com/en/consumers.
  3. Choose New consumer, give it a name (VLC Redesign) and save it.
  4. Copy its API key into VLC Redesign, with the account's username and password: they raise how many subtitles you can download a day (a free account has a daily limit).

Where it goes:

App Where
Windows, Linux, macOS Settings › Subtitles › Subtitle services › OpenSubtitles.com: Your free key, User name (optional), Password (optional), Test and Get a free key. Add subtitles to the library › From OpenSubtitles uses the same key and account (one key for both).
Android (phone, tablet, Android TV) Settings › Subtitles › Subtitle services: OpenSubtitles API key, Username, Password, and How to get a free key (Open goes to the page). With a key, OpenSubtitles.com is asked too in the online search.
Samsung TV (Juxto Media Player) Settings › Subtitles: the same fields and the same steps (the address is shown as text)

The key and the account stay on the device, in the app's own settings (on Windows sealed for your user on this PC); they are sent only to OpenSubtitles.com.

Online subtitles on Android and on Samsung TVs

The Android app (phones, tablets, Android TV) and the Samsung TV app find subtitles online as the desktop does (#67): the same services without an account (OpenSubtitles, Wizdom, Addic7ed, YIFY Subtitles), the same identification of the video (IMDb, Wikidata, Cinemeta) and the same order of the results.

  • Android: the languages and tracks panel › Subtitles › ⋯ › Search subtitles online: what the video was taken for (Elephants Dream (2006) · 30 found), the subtitles by language, each with its service, For this file and its downloads. A tap downloads it, shows it and keeps it for the file. The video is another one: search by its title finds the right one. Settings › Subtitles has the second language, Find subtitles online when a video has none in these languages (asked in the welcome's privacy step), each service and the OpenSubtitles.com key. When it finds one by itself: English · Downloaded from OpenSubtitles.
  • Samsung TV: the subtitles panel of the player has the same list, OK to load one; Settings › Subtitles the same choices.

Remembered choices

What How long
The subtitle chosen for a file (a track, a file or one found online), shown again the next time; from the cache when it was downloaded The last 500 media
The title chosen for the online search of a file The last 500 media
The track and timing choices of a series Until you remove the preset
The size and position of the subtitles For every video, until you change them
The languages you pick (learning) Fading with each new pick

Subtitle keys

Key Action
V / Alt+V Next / previous subtitle track
Shift+V Subtitles on or off
H / G Subtitle delay up / down
Shift+Up / Shift+Down Subtitles higher / lower
Ctrl+wheel over the video Subtitles larger / smaller (elsewhere in the window it zooms the interface)
Ctrl+0 Normal size (taken by play the tenth media played last while the media library is on: see Keyboard shortcuts)
Shift+H, Shift+J, Shift+K, Ctrl+Shift+K Sync: mark the voice, mark the text, apply, reset
Ctrl+Shift+V Toggle secondary subtitle control

All of them can be changed: see Keyboard shortcuts.

Good to know

  • No subtitles show. Check Off is not chosen in the list, and Shift+V (subtitles on or off). A video without subtitles in your languages needs the online search on, or a click on the search button.
  • The wrong film's subtitles. The title was taken for another one: use the magnifier of the header.
  • Out of sync. Use Mark voice heard / Mark text seen; for a whole series, Save a series preset.
  • Too small or in the way. Use Position and size; the change stays for every video.
  • A language keeps coming back. It was learned from your picks; pick the one you want a few times and it takes over.

The player · Settings: Subtitles · Languages · Keyboard shortcuts · Home

⚠️ **GitHub.com Fallback** ⚠️