Settings/Player/Language: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
← Older edit
CastagnaIT (talk | contribs)
Patroller
62 edits
Add "other" section + "Language code support on MKV files" subsection
Update for v22
 
(5 intermediate revisions by 3 users not shown)
Line 6: Line 6:


=Audio=
=Audio=
[[File:Player_language_audio.jpg|right|500px]]
[[File:Settings-Player-Language.jpg|600px]]




== Preferred Audio Language ==
== Preferred audio Language ==
{|
{|
|- valign="top"
|- valign="top"
Line 34: Line 34:


=Subtitles=
=Subtitles=
[[File:Settings-Player-Language-02.jpg|right|500px]]
[[File:Settings-Player-Subtitles.jpg|600px]]
{{See|Subtitles}}




Line 45: Line 44:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Defaults to the selected subtitle language if more than one language is available
| Select which subtitle track to use.<br>
Choose a language from the list to set the preferred subtitle language to automatically display, or choose ''Forced only'' (default setting)<ref>https://github.com/xbmc/xbmc/pull/27231</ref>, ''Original language'' (requires subtitle track to be correctly tagged), ''User interface language'' or set ''None'' if no subtitle track should be automatically displayed.
|}
|}




== Enable parsing for closed captions ==
== Don't show subtitles matching the audio language ==
{|
{|
|- valign="top"
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}  
| width=120px | {{nowrap|'''Settings level:'''}}  
| Standard
| Basic
|- valign="top"
| '''Description:'''
| Enable to parse for CC in video streams. Puts slightly more load on the CPU.
|}
 
 
== Subtitle position on screen ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Location of subtitles on screen.<br>
| When enabled, subtitles that are in the same language as the audio being played are not displayed. Forced subtitles are not affected.<ref>https://github.com/xbmc/xbmc/pull/28862</ref>
Options are: ''Fixed, Bottom of video, Below video, Top of video, Above video''
|}
|}


== Stereoscopic 3D depth of subtitles ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| Sets the visual depth of subtitles for stereoscopic 3D videos. The higher the value, the closer the subtitles will appear to the viewer.
|}




== Font to use for text subtitles ==
= Accessibility =
{|
[[File:Settings-Player-Accessibility.jpg|600px]]
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| Set the font type to be used for text based subtitles (such as embedded on video files, streamings or downloaded).
|}




== Character set ==
== Prefer audio stream for the visually impaired ==
{|
{|
|- valign="top"
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}  
| width=120px | {{nowrap|'''Settings level:'''}}  
| Standard
| Basic
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Set the font character set to be used for subtitles
| Where available the audio stream for the visually impaired will be selected over other audio streams of the same language. Requires correct tagging in the media file.
|}
|}




== Size ==
== Prefer audio stream for the hearing impaired ==
{|
{|
|- valign="top"
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}  
| width=120px | {{nowrap|'''Settings level:'''}}  
| Expert
| Basic
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| Set the font size to be used for subtitles.  
| Where available the audio stream for the hearing impaired will be selected over other audio streams of the same language. Requires correct tagging in the media file.
|}
|}




== Style ==
== Prefer subtitles for the hearing impaired ==
{|
{|
|- valign="top"
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}  
| width=120px | {{nowrap|'''Settings level:'''}}  
| Expert
| Basic
|- valign="top"
| '''Description:'''
| Set the font style to be used for subtitles. <br>
Options are: ''Normal, Bold, Italics, Bold italics''
|}
 
 
== Colour ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
| '''Description:'''
| Set the font colour to be used for subtitles. If subtitles are too bright on your display, select another colour here.
|}
 
 
== Opacity ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
| '''Description:'''
| Used to make subtitles transparent. <ref>https://github.com/xbmc/xbmc/pull/16106</ref><br>
Can be used to overcome bright subtitles when viewing HDR content. On LCD TV's with local dimming, it can reduce unwanted picture brightness adjustments.
|}
 
 
== Background colour ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
| '''Description:'''
| Set the colour to be used for the subtitle background. Used as required to make subtitles easier to read.
|}
 
 
== Background opacity ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
| '''Description:'''
| Adjust the transparency level for the subtitle background.
|}
 
 
== Override ASS/SSA subtitle fonts ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| If predefined fonts are given with the subtitle file enable this setting to override them.
| Where available the subtitle stream for the hearing impaired (SDH) will be selected over other subtitle streams of the same language and displayed by default. Requires correct tagging in the media file.
|}
|}
{{-}}
=Download Services=
[[File:Player_language_download-services.jpg|right|500px]]
{{See|Subtitles}}


== Languages to download subtitles for ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| Set which language subtitles to search and download.<br>
Check with your selected subtitle provider if subtitles are not found in the specified language.
|}




== Subtitle storage location ==
= Closed caption subtitles =
{|
[[File:Settings-Player-CC.jpg|600px]]
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| Specify where downloaded subtitles should be saved, the same location as the video or a custom location.  
Options: ''Next to the video'' or ''Custom location''.
|}




== Custom subtitle folder ==
== Set CC subtitles only for the hearing impaired ==
{|
{|
|- valign="top"
|- valign="top"
Line 223: Line 110:
|- valign="top"
|- valign="top"
| '''Description:'''
| '''Description:'''
| If you chose ''Custom location'' in the previous setting, set the location with this setting.
| When enabled, Closed Captioned subtitles will be labeled for the hearing impaired. This will affect the automatic selection of subtitles which, unless otherwise specified, will not be displayed by default.
|}
|}


== Pause when searching for subtitles ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| Pause the current video while searching for subtitles and resume once the subtitle is available.
|}
== Auto download first subtitle ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| Automatically download first subtitle from the search result list.
|}
== Default TV service ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| Select the service that will be used as default to search for TV-show subtitles.<br>
If none are listed, use the ''Get more...'' button
|}
== Default movie service ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- valign="top"
| '''Description:'''
| Select the service that will be used as default to search for movie subtitles.<br>
If none are listed, use the ''Get more...'' button
|}
= Other =
== Language code support on MKV files ==
The MKV video format supports IETF BCP 47 language code standard, this allows you to have audio / subtitles tracks with language and region code subtag (or other types of subtags).
Kodi does not officially support the IETF BCP 47 format, therefore all tracks with languages defined with subtags (for example region: "pt-BR") will be always identified with the primary language code (so: "pt"), it will result in the GUI language list not being able to distinguish between language variants.
{{note|Language code override for Kodi v20 and above:}}
A way to fix the Kodi language code detection problem is open with a video editor software your MKV file (e.g. mkvtoolnix), then for each audio / subtitle track that use the IETF BCP 47 language code, copy the same language code string to the track title field (or track name field, depends from the video editor used), it will allow to Kodi to read the full language code string to override the default one.




Line 288: Line 120:


{{top}}
{{top}}
{{updated|19}}
{{updated|22}}


[[Category:Settings]]
[[Category:Settings]]
[[Category:Languages]]

Latest revision as of 05:43, 16 October 2026

  ▶ Settings ▶ Player ▶ Language



Audio


Preferred audio Language

Settings level: Basic
Description: Defaults to the selected audio language if more than one language is available


Prefer default audio streams

Settings level: Standard
Description: If enabled, audio streams that are flagged as default (and match the preferred language) are preferred over audio streams with higher quality (number of channels, codec, ...)



Subtitles


Preferred Subtitle Language

Settings level: Basic
Description: Select which subtitle track to use.

Choose a language from the list to set the preferred subtitle language to automatically display, or choose Forced only (default setting)[1], Original language (requires subtitle track to be correctly tagged), User interface language or set None if no subtitle track should be automatically displayed.


Don't show subtitles matching the audio language

Settings level: Basic
Description: When enabled, subtitles that are in the same language as the audio being played are not displayed. Forced subtitles are not affected.[2]


Accessibility


Prefer audio stream for the visually impaired

Settings level: Basic
Description: Where available the audio stream for the visually impaired will be selected over other audio streams of the same language. Requires correct tagging in the media file.


Prefer audio stream for the hearing impaired

Settings level: Basic
Description: Where available the audio stream for the hearing impaired will be selected over other audio streams of the same language. Requires correct tagging in the media file.


Prefer subtitles for the hearing impaired

Settings level: Basic
Description: Where available the subtitle stream for the hearing impaired (SDH) will be selected over other subtitle streams of the same language and displayed by default. Requires correct tagging in the media file.


Closed caption subtitles


Set CC subtitles only for the hearing impaired

Settings level: Advanced
Description: When enabled, Closed Captioned subtitles will be labeled for the hearing impaired. This will affect the automatic selection of subtitles which, unless otherwise specified, will not be displayed by default.


References

  1. ↑ https://github.com/xbmc/xbmc/pull/27231
  2. ↑ https://github.com/xbmc/xbmc/pull/28862


Return to top
Retrieved from "https://kodi.wiki/index.php?title=Settings/Player/Language&oldid=264616"