Settings/Player/Language: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Updated for v20)
 
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]]
{{See|Subtitles}}




Line 49: Line 47:




== Enable parsing for closed captions ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Standard
|- 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"
| '''Description:'''
| Location of subtitles on screen.<br>
Options are: ''Fixed, Bottom of video, Below video, Top of video, Above video''
|}


= Accessibility =


== 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.
|}


 
== Prefer audio stream for the visually impaired ==
== Font to use for text subtitles ==
{|
{|
|- 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 type to be used for text based subtitles (such as embedded on video files, streamings or downloaded).
| 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.
|}
|}




== Character set ==
== Prefer audio stream for the hearing 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 hearing impaired will be selected over other audio streams of the same language. Requires correct tagging in the media file.
|}
|}




== Size ==
== Prefer subtitles 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 subtitle stream for the hearing impaired will be selected over other subtitle streams of the same language. Requires correct tagging in the media file.
|}
|}


== Style ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Expert
|- 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"
| '''Description:'''
| If predefined fonts are given with the subtitle file enable this setting to override them.
|}
{{-}}
=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 ==
{|
|- 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 ==
{|
|- valign="top"
| width=120px | {{nowrap|'''Settings level:'''}}
| Advanced
|- valign="top"
| '''Description:'''
| If you chose ''Custom location'' in the previous setting, set the location with this setting.
|}
== 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), if the track title already contains text, you can insert the language code at the end of the text and optionally wrap the language code with round brackets. This will allow to Kodi to read the full language code string to override the default one. <ref>https://github.com/xbmc/xbmc/pull/21776</ref>




Line 288: Line 92:


{{top}}
{{top}}
{{updated|19}}
{{updated|20}}


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

Latest revision as of 04:34, 16 January 2023

Home icon grey.png   ▶ Settings ▶ Player ▶ Language



Audio

Settings-Player-Language.jpg


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: Defaults to the selected subtitle language if more than one language is available



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 will be selected over other subtitle streams of the same language. Requires correct tagging in the media file.


References


Return to top