Subtitles - Revision history

Crystalp: clarify that bcp 47 support is new with v22

2026-01-11T03:47:53Z

clarify that bcp 47 support is new with v22

← Older revision		Revision as of 03:47, 11 January 2026
Line 85:		Line 85:
	To use this functionality you need to rename the subtitle files as <movie name>.<language>.<subtitle extension>.<br>		To use this functionality you need to rename the subtitle files as <movie name>.<language>.<subtitle extension>.<br>
	The language piece can be an ISO 639-1 or ISO 639-2 code, a BCP 47 tag (with - characters replaced with _) or the English name of a language.<br>		The language piece can be an ISO 639-1 or ISO 639-2 code, a BCP 47 tag (with - characters replaced with _) or the English name of a language.<br>
			{{note\|support for BCP 47 tags is new with Kodi 22}}

	For example:		For example:

Crystalp: ext sub languages can be more than full English names

2026-01-11T03:44:50Z

ext sub languages can be more than full English names

← Older revision		Revision as of 03:44, 11 January 2026
Line 83:		Line 83:
	Kodi supports the use of more than one external subtitle. This of course is most useful when you have more than one subtitle file, (eg. for more than language).		Kodi supports the use of more than one external subtitle. This of course is most useful when you have more than one subtitle file, (eg. for more than language).

	To use this functionality you need to rename the ~~video file and~~ subtitle files as ~~follows~~:		To use this functionality you need to rename the subtitle files as <movie name>.<language>.<subtitle extension>.<br>
			The language piece can be an ISO 639-1 or ISO 639-2 code, a BCP 47 tag (with - characters replaced with _) or the English name of a language.<br>
			For example:

	'''Video File:''' The Matrix.avi		'''Video File:''' The Matrix.avi
	'''Subtitle 1:''' The Matrix.English.srt		'''Subtitle 1:''' The Matrix.English.srt
	'''Subtitle 2:''' The Matrix.~~French~~.srt		'''Subtitle 2:''' The Matrix.fr.srt
	'''Subtitle 3:''' The Matrix.~~German~~.srt		'''Subtitle 3:''' The Matrix.zh_yue.srt

	~~The dot after the filename but before the extension specifies the language (you can use anything here, mix numbers and and letters or just use one or the other).~~
	<br />		<br />

Karellen: GUI peak luminance in HDR PQ mode

2023-01-19T05:59:27Z

GUI peak luminance in HDR PQ mode

← Older revision		Revision as of 05:59, 19 January 2023
Line 38:		Line 38:

	== Additional settings ==		== Additional settings ==



Line 48:		Line 47:
	The position of the subtitles can be adjusted vertically (but not horizontally) in the [[Settings/System/Display#Calibration\|Video Calibration]] screen, you can also configure the way that they are displayed though the [[Settings/Player/Language#Subtitles\|Subtitles Settings]].<br />		The position of the subtitles can be adjusted vertically (but not horizontally) in the [[Settings/System/Display#Calibration\|Video Calibration]] screen, you can also configure the way that they are displayed though the [[Settings/Player/Language#Subtitles\|Subtitles Settings]].<br />
	'''Note:''' This does not apply to DVD subtitles as the DVD itself defines their location.		'''Note:''' This does not apply to DVD subtitles as the DVD itself defines their location.


			=== Adjusting brightness of HDR subtitles ===
			Over-bright subtitles can be adjusted using the ''GUI peak luminance in HDR PQ mode'' setting.<br>
			See: '''[[Settings/System/Display#GUI_peak_luminance_in_HDR_PQ_mode\| GUI peak luminance in HDR PQ mode]]'''

MYnDstrEAm: /* Manually downloaded external subtitle files */ It works basically the same for using manually downloaded external audio track files.

2022-12-10T13:02:44Z

Manually downloaded external subtitle files: It works basically the same for using manually downloaded external audio track files.

← Older revision		Revision as of 13:02, 10 December 2022
Line 100:		Line 100:
	'''Subtitle 5:''' Movie Name (2006).German.ssa		'''Subtitle 5:''' Movie Name (2006).German.ssa

			It works basically the same for using [[External audio tracks\|manually downloaded external audio track files]].

	== Advanced options ==		== Advanced options ==

CastagnaIT at 16:54, 29 January 2022

2022-01-29T16:54:49Z

← Older revision		Revision as of 16:54, 29 January 2022
Line 107:		Line 107:

	=== Adding fonts ===		=== Adding fonts ===
	~~Additional~~ fonts can be stored in the Kodi folder ~~(one level below [[userdata]])~~ at <code>Kodi/media/Fonts/</code>		You can add additional fonts to add support for your language and to customise your style. Your additional fonts can be stored in the Kodi folder at <code>Kodi/media/Fonts/</code>.

			The supported font format type is TTF {{note\|On Kodi 20 - Add support for OTF font type}}.

			{{note\|On Kodi 20 - Please note that each time you add or remove fonts you will have to restart Kodi, to allow the font cache to be rebuilt and show fonts in the settings.}}

			For additional info see '''media''' section on [[Kodi_data_folder]] page.

	=== Increasing the delay range for subtitle adjustment ===		=== Increasing the delay range for subtitle adjustment ===

CastagnaIT at 16:01, 29 January 2022

2022-01-29T16:01:57Z

← Older revision		Revision as of 16:01, 29 January 2022
Line 17:		Line 17:
	Image-based subtitle formats supported:		Image-based subtitle formats supported:
	* VobSub (idx/sub)		* VobSub (idx/sub)
	* PGS (Presentation ~~Grapic~~ Stream Subtitle)		* PGS (Presentation Graphic Stream Subtitle)
	* SUP (Subtitle bitmap image of DVD and Blu-ray)		* SUP (Subtitle bitmap image of DVD and Blu-ray)

CastagnaIT at 16:01, 29 January 2022

2022-01-29T16:01:02Z

@@ Line 1: / Line 1: @@
 {{mininav|[[Video library]] {{l2| [[Settings]] }}|[[Video playback]] {{l2| [[Settings/Player|Player]] }} }}
 <section begin="intro" />Kodi supports both stand-alone subtitle and embedded subtitles. Most major subtitle formats are supported. Kodi can also search and download subtitles directly from full screen playback. <section end="intro" />
 == Changing subtitle settings during playback ==

Enen92: Just a minor rephrase, as gotham is already too old :)

2021-04-14T08:06:35Z

Just a minor rephrase, as gotham is already too old :)

← Older revision		Revision as of 08:06, 14 April 2021
Line 114:		Line 114:

	=== Using Forced Subtitles ===		=== Using Forced Subtitles ===
	Many movies have subtitles encoded for secondary languages spoken during the film – when these are added to the movie, they are known as forced subtitles and are always visible (despite not being hard encoded). ~~As of~~ Gotham~~, Kodi~~ recognizes and respects the forced flag for showing subtitles (even if subtitles are turned off by default, the forced flag will trigger them being turned on). This requires that the user have set the default languages in Settings in order to function properly. If there are multiple forced subtitles, Kodi will select the forced subtitles that match the default playback language.		Many movies have subtitles encoded for secondary languages spoken during the film – when these are added to the movie, they are known as forced subtitles and are always visible (despite not being hard encoded). Kodi (since v13 Gotham) recognizes and respects the forced flag for showing subtitles (even if subtitles are turned off by default, the forced flag will trigger them being turned on). This requires that the user have set the default languages in Settings in order to function properly. If there are multiple forced subtitles, Kodi will select the forced subtitles that match the default playback language.

Karellen at 01:03, 10 October 2020

2020-10-10T01:03:01Z

← Older revision		Revision as of 01:03, 10 October 2020
Line 130:		Line 130:
	</syntaxhighlight>		</syntaxhighlight>


			= References =
			{{github_link\|[https://github.com/xbmc/xbmc/blob/master/xbmc/cores/VideoPlayer/VideoPlayer.cpp#L94 Requirements to load subtitles]}}

Karellen at 07:22, 12 July 2020

2020-07-12T07:22:35Z

← Older revision		Revision as of 07:22, 12 July 2020
Line 34:		Line 34:

	== Subtitle downloader ==		== Subtitle downloader ==
	{{Main\|HOW-TO:~~Setup subtitle services~~}}		{{Main\|HOW-TO:Set_up_subtitle_services}}

	* <code>ActivateWindow(subtitlesearch)</code> can be bound to a remote button using [[keymaps]] in order to quickly bring up the subtitle search window.		* <code>ActivateWindow(subtitlesearch)</code> can be bound to a remote button using [[keymaps]] in order to quickly bring up the subtitle search window.
Line 108:		Line 108:
	</syntaxhighlight>		</syntaxhighlight>
	# Change the two values between the tags to fit your situation.		# Change the two values between the tags to fit your situation.
	# Save this file in your '''[[userdata folder]]'''		# Save this file in your '''[[Userdata\|userdata folder]]'''
	#: ''If you have an existing file, make sure the <video></video> tags, and settings we'll add between them, are between the main <advancedsettings></advancedsettings> tags.''		#: ''If you have an existing file, make sure the <video></video> tags, and settings we'll add between them, are between the main <advancedsettings></advancedsettings> tags.''