-
Notifications
You must be signed in to change notification settings - Fork 241
Audio Subtitles track properties
When we talk about audio/subtitles track properties, we are talking about track properties such as default track, impaired (description) track, forced track, original (language) track, ... which can be viewed also in Kodi audio/subtitles OSD settings while playing. These determine how tracks will be selected when playback starts, based on the user settings set on Kodi.
Here to follow the general track selection behavior of the Kodi framework.
Whenever possible these properties are automatically parsed/assigned by using the manifest data. But being that the specifications of the manifests (DASH, HLS, ...) may differ from what the Kodi framework require, there are situations where these properties are not assigned or are assigned incorrectly. For DASH manifest are supported some custom tags to do some fine tuning, see wiki Custom DASH manifest tags page.
The meaning of "default" on Kodi may differ from the specifications of manifest types (DASH, HLS, ...). Assigning these properties on Kodi tracks has the following meanings:
The "default" property is used to give priority to a track in the playback selection when is similar to another, same language but usually may differs for channels or codec used.
Consider the following example, we have a manifest with 2 audio tracks:
- Audio track english - channels 5.1 - codec ec-3
- Audio track english - channels 2.0 - codec ec-3
Both track are same language and differ only in the number of channels. To allow Kodi to automatically select (prioritise) track 5.1, we have to set the track 5.1 to default. If not set, Kodi will select the first one in index order, without distinction.
The "default" property is used to give priority to a track in the playback selection when is equal to another (unusual but only to understand the functionality) for example it may differs for the content e.g. different author.
Consider the following example, we have a manifest with 2 subtitles tracks:
- Subtitles track italian - (an author version 1)
- Subtitles track italian - (an author version 2)
Both track are same language and differ only for the author. To allow Kodi to automatically select (prioritise) a preferred track, we have to set to default one of the two tracks. If not set, Kodi will select the first one in index order, without distinction.
User Documentation
Developer Documentation
- Integration
- Integration DRM
- Integration DRM (old)
- Stream selection types properties
- How to test a stream
- Test samples python addon
- How to provide custom manifest and license
- Supported containers and codecs
- Verified Media Path (VMP)
- Set resolution limits for DRM streams
- Custom DASH manifest tags
- Audio Subtitles track properties
- Dev. FAQ
- Widevine ARM64 support
- Add‐on WIP status
Development