Skip to content

How to configure preferred Subtitle Languages ​

Example:

en.*,.*-orig

Apart from selecting the language through the suggested chips, you can write down the language codes yourself. To write multiple languages, separate the codes by ,. Each suggested chip represents a certain language code that yt-dlp can understand.

Languages of the subtitles to download can be regex. e.g. "en.*" is a regex pattern that matches "en" followed by 0 or more of any character. You can prefix the language code with a "-" to exclude it from the requested languages, e.g. -live_chat

Where to set it ​

  • Default: More -> Settings -> Processing Subtitle languages (the default value is .*-orig, which means the original language of the video)
  • Per download: the Subtitles option in the video tab of the Download Card

Useful values ​

ValueMeaning
enEnglish
en.*English and all its variants such as en-US, en-GB
.*-origThe original language of the video, when automatic subtitles exist
allEvery available language
all,-live_chatEverything except the live chat
es,pt.*Spanish and every Portuguese variant

Subtitle options ​

In More -> Settings -> Processing under Video:

SettingMeaning
Embed subtitlesPut the subtitle stream into the video file.
Save subtitlesWrite the subtitle as a separate file next to the video.
Save automatic subtitlesSame, for automatically generated or translated subtitles.
Delete subtitle files after embeddingWhen saving and embedding together, delete the files after they are embedded.
Subtitle formatConvert the subtitles to srt, ass, lrc or vtt.

Embedding subtitles doesn't embed automatic subtitles by default. Enable Save automatic subtitles and Embed subtitles together.

You can also burn subtitles into the picture of the video from the download card. This re-encodes the video, and the speed depends on Internal Plugin FFmpeg Preset in the processing settings (slower presets give smaller files).

Note

Subtitles are saved or embedded only when the website has them. For automatic subtitles, YouTube generates a lot of translated languages, so choose only what you need or the download might get slow or fail due to rate limiting.