Documentation › Subtitles

Subtitle Preferences

These settings (Settings › Subtitles) decide how subtitles are automatically chosen for a video when it is opened. If a specific subtitle was manually chosen, that will be loaded the next time rather than using these preferences.

Subtitle Type

SettingChooses
NoneNothing
Forced Only (default)Forced subtitles, and nothing else if there are none
Prefer ForcedForced if there are any, otherwise full, otherwise SDH
Prefer FullFull if there are any, otherwise SDH, otherwise forced
Prefer SDHSDH if there are any, otherwise full, otherwise forced

Subtitle Language

SettingChooses
First Output OnlyThe first output's language
Second Output OnlyThe second output's language
Prefer First Output (default)Prefer the first output's language, fall back to the second
Prefer Second OutputPrefer the second output's language, fall back to the first
A specific languageOne particular language

Following an Output

The options that follow an output use the language of the track that is actually playing, not the language preference set for that output. If nothing matched your preference and the video's first track was used instead, the subtitles follow that track.

For a preferred output language match, it will fall through any available options for the given Subtitle Type preference (above), then do the same for the other output's language. The first match wins.

How Subtitle Languages and Types Are Recognized

TinePlayer will gather track info from several sources depending on what is available.

  • Flags set in the track metadata in the video file.
  • Language and track names from Jellyfin for a cast video. Its own forced and SDH flags are not read, since it reports them false on tracks it titles "Forced".
  • An nfo file beside the video containing track information.
  • Parsed from the track name or filename for external files.