InfoLabels: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
Hitcher (talk | contribs)
Hitcher (talk | contribs)
Update info labels from Doxygen
 
(40 intermediate revisions by 3 users not shown)
Line 5: Line 5:


=== Addon ===
=== Addon ===
 
{|  class="wikitable sortable" width="100%"
{|  class="prettytable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>Addon.SettingStr(addon_id,setting_id)</code>
|  <code>Addon.SettingInt(addon_id,setting_id)</code>
|  '''Returns'''
|  '''Returns'''
:The string value of the setting <code>setting_id</code> belonging to the addon with the id <code>addon_id</code>.
:The integer value of the setting <code>setting_id</code> belonging to the addon with the id <code>addon_id</code>.
'''Parameters'''
'''Parameters'''
:'''addon_id''' - the id of the addon
:'''addon_id''' - The id of the addon
:'''setting_id''' - the addon setting
:'''setting_id''' - The addon setting
{{highlight|'''Note'''<br>
The provided setting with <code>setting_id</code> must be an integer setting type.<br>
Otherwise it will return the integer info default value (which is 0).}}
| [https://forum.kodi.tv/showthread.php?tid=363553&pid=3098121#pid3098121 v20]
| [https://forum.kodi.tv/showthread.php?tid=363553&pid=3098121#pid3098121 v20]
|-
|-
|  <code>Addon.SettingInt(addon_id,setting_id)</code>
|  <code>Addon.SettingStr(addon_id,setting_id)</code>
|  '''Returns'''
|  '''Returns'''
:The integer value of the setting <code>setting_id</code> belonging to the addon with the id <code>addon_id</code>.<br>
:The string value of the setting <code>setting_id</code> belonging to the addon with the id <code>addon_id</code>.
'''Parameters'''
'''Parameters'''
:'''addon_id''' - the id of the addon
:'''addon_id''' - The id of the addon
:'''setting_id''' - the addon setting
:'''setting_id''' - The addon setting
{{highlight|'''Note'''<br>
The provided setting with <code>setting_id</code> must be an integer setting type. Otherwise it will return the integer info default value (which is 0).}}
| [https://forum.kodi.tv/showthread.php?tid=363553&pid=3098121#pid3098121 v20]
| [https://forum.kodi.tv/showthread.php?tid=363553&pid=3098121#pid3098121 v20]
|}
|}


=== Container ===
=== Container ===
 
{{highlight|'''Note'''<br>
If no <code>id</code> is specified it grabs the current container.}}
{|  class="wikitable sortable" width="100%"
{|  class="wikitable sortable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
Line 40: Line 41:
|  '''Returns'''
|  '''Returns'''
:The column number of the focused position in a panel container.
:The column number of the focused position in a panel container.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|-
Line 47: Line 46:
|  '''Returns'''
|  '''Returns'''
:The current item in the container or grouplist with given id.
:The current item in the container or grouplist with given id.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|-
Line 54: Line 51:
|  '''Returns'''
|  '''Returns'''
:The current page in the container with given id.
:The current page in the container with given id.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|-
|  <code>Container(id).ListItem(offset).Property</code>
|  <code>Container(id).ListItem(offset).Property</code>
|  '''Returns'''
|  '''Returns'''
:The property of the ListItem with a given offset.<br>
:The property of the ListItem with a given offset.
'''Parameters'''
'''Parameters'''
:'''offset''' - the offset for the listitem.
:'''offset''' - The offset for the listitem.
{{highlight|'''Note'''<br>
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.<br>
<code>Property</code> has to be replaced with <code>Label</code>, <code>Label2</code>, <code>Icon</code>, etc.<br>
<code>Property</code> has to be replaced with <code>Label</code>, <code>Label2</code>, <code>Icon</code>, etc.<br>
'''Example:''' <code>Container(50).Listitem(2).Label</code>}}
'''Example:''' <code>Container(50).Listitem(2).Label</code>}}
Line 71: Line 65:
|  <code>Container(id).ListItemAbsolute(x).[infolabel]</code>
|  <code>Container(id).ListItemAbsolute(x).[infolabel]</code>
|  '''Returns'''
|  '''Returns'''
:The infolabel for an item in a container.<br>
:The infolabel for an item in a container.
'''Parameters'''
'''Parameters'''
:'''x''' - the absolute position in the container.
:'''x''' - The absolute position in the container.
{{highlight|'''Note'''<br>
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.<br>
'''Example:''' <code>Container(50).ListItemAbsolute(4).Genre</code>}}
'''Example:''' <code>Container(50).ListItemAbsolute(4).Genre</code>}}
|
|
Line 81: Line 74:
|  <code>Container(id).ListItemNoWrap(offset).Property</code>
|  <code>Container(id).ListItemNoWrap(offset).Property</code>
|  '''Returns'''
|  '''Returns'''
:The same as Container(id).ListItemNoWrap(offset).Property but it won't wrap.
:The same as Container(id).ListItemNoWrap(offset).Property but it won't wrap.<br>
:This means if the last item of a list is focused, <code>ListItemNoWrap(1)</code> will be empty while <code>ListItem(1)</code> will return the first item of the list.<br>
'''Parameters'''
:'''offset''' - The offset for the listitem.
{{highlight|'''Note'''<br>
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.<br>
<code>Property</code> has to be replaced with <code>Label</code>, <code>Label2</code>, <code>Icon</code>, etc.<br>
That means if the last item of a list is focused, <code>ListItemNoWrap(1)</code> will be empty while <code>ListItem(1)</code> will return the first item of the list. Property has to be replaced with <code>Label</code>, <code>Label2</code>, <code>Icon</code>, etc.<br>
'''Example''': <code>Container(50).ListitemNoWrap(1).Plot</code>}}
'''Example''': <code>Container(50).ListitemNoWrap(1).Plot</code>}}
|
|
Line 90: Line 85:
|  <code>Container(id).ListItemPosition(x).[infolabel]</code>
|  <code>Container(id).ListItemPosition(x).[infolabel]</code>
|  '''Returns'''
|  '''Returns'''
:The infolabel for an item in a container.<br>
:The infolabel for an item in a container.
'''Parameters'''
'''Parameters'''
:'''x''' - the position in the container relative to the cursor position.
:'''x''' - The position in the container relative to the cursor position.
{{highlight|'''Note'''<br>
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.<br>
'''Example:''' <code>Container(50).ListItemAbsolute(4).Genre</code>}}
'''Example:''' <code>Container(50).ListItemAbsolute(4).Genre</code>}}
|
|
Line 101: Line 95:
|  '''Returns'''
|  '''Returns'''
:The number of all items in the container or grouplist with given id including parent folder item.
:The number of all items in the container or grouplist with given id including parent folder item.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
| [https://forum.kodi.tv/showthread.php?tid=298565&pid=2553240#pid2553240 v18]
| [https://forum.kodi.tv/showthread.php?tid=298565&pid=2553240#pid2553240 v18]
|-
|-
Line 108: Line 100:
|  '''Returns'''
|  '''Returns'''
:The number of items in the container or grouplist with given id excluding parent folder item.
:The number of items in the container or grouplist with given id excluding parent folder item.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|-
Line 115: Line 105:
|  '''Returns'''
|  '''Returns'''
:The number of items in the container or grouplist with given id excluding all folder items (e.g. pvr recordings folders, parent ".." folder, "All albums", etc).
:The number of items in the container or grouplist with given id excluding all folder items (e.g. pvr recordings folders, parent ".." folder, "All albums", etc).
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|  [https://forum.kodi.tv/showthread.php?tid=298565&pid=2553240#pid2553240 v18]
|  [https://forum.kodi.tv/showthread.php?tid=298565&pid=2553240#pid2553240 v18]
|-
|-
|  <code>Container(id).NumPages</code>
|  <code>Container(id).NumPages</code>
|  '''Returns'''
|  '''Returns'''
:The number of pages in the container with given id. If no id is specified it grabs the current container.
:The number of pages in the container with given id.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|-
Line 129: Line 115:
|  '''Returns'''
|  '''Returns'''
:The current focused position of container / grouplist (id) as a numeric label.
:The current focused position of container / grouplist (id) as a numeric label.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|-
Line 136: Line 120:
|  '''Returns'''
|  '''Returns'''
:The row number of the focused position in a panel container.
:The row number of the focused position in a panel container.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|
|
|-
|  <code>Container(id).TotalUnWatched</code>
|  '''Returns'''
:The number of unwatched items in the container.
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2052026#pid2052026 v16]
|-
|  <code>Container(id).TotalWatched</code>
|  '''Returns'''
:The number of watched items in the container.
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2052026#pid2052026 v16]
|-
|-
|  <code>Container.Art(type)</code>
|  <code>Container.Art(type)</code>
|  '''Returns'''
|  '''Returns'''
:The path to the art image file for the given type of the current container.<br>
:The path to the art image file for the given type of the current container.
'''Parameters'''
'''Parameters'''
:'''type''' - the art type to request.
:'''type''' - The art type to request.
{{highlight|'''Todo'''<br>
{{highlight|'''Todo'''<br>
List of all art types.}}
List of all art types.}}
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2095396#pid2095396 v16]<br>
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2095396#pid2095396 v16]
[https://forum.kodi.tv/showthread.php?tid=211896&pid=1866664#pid1866664 v15]
[https://forum.kodi.tv/showthread.php?tid=211896&pid=1866664#pid1866664 v15]
|-
|-
Line 205: Line 197:
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2052012#pid2052012 v16]
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2052012#pid2052012 v16]
|-
|-
|  <code>Container(id).TotalUnWatched</code>
|  <code>Container.Totaltime</code>
|  '''Returns'''
|  '''Returns'''
:The number of unwatched items in the container.
:The total time of all items in the current container.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2052026#pid2052026 v16]
|-
|  <code>Container(id).TotalWatched</code>
|  '''Returns'''
:The number of watched items in the container.
{{highlight|'''Note'''<br>
If no id is specified it grabs the current container.}}
|  [https://forum.kodi.tv/showthread.php?tid=231270&pid=2052026#pid2052026 v16]
|-
|  <code>Container.Totaltime</code>
|  '''Returns'''
:The total time of all items in the current container.
|
|
|-
|-
Line 236: Line 214:


=== Control ===
=== Control ===
 
{|  class="wikitable sortable" width="100%"
{|  class="prettytable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>Control.GetLabel(id)[.index()]</code>
|  <code>Control.GetLabel(id)[.index()]</code>
|  '''Returns'''
|  '''Returns'''
:The label value or texture name of the control with the given id.<br>
:The label value or texture name of the control with the given id.
'''Parameters'''
'''Parameters'''
:'''id''' - the id of the control.
:'''id''' - The id of the control.
:'''index''' - [opt] optionally you can specify index(1) to retrieve label2 from an Edit control.
:'''index''' - [opt] Optionally you can specify index(1) to retrieve label2 from an Edit control.
|  [https://forum.kodi.tv/showthread.php?tid=211896&pid=1937160#pid1937160 v15]
|  [https://forum.kodi.tv/showthread.php?tid=211896&pid=1937160#pid1937160 v15]
|}
|}


=== Fanart ===
=== Fanart ===
 
{{highlight|'''Note'''<br>
Colors are arranged Lightest to Darkest.}}
{|  class="wikitable sortable" width="100%"
{|  class="wikitable sortable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>Fanart.Color1</code>
|  <code>Fanart.Color1</code>
|  Returns the first of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show.  Colors are arranged Lightest to Darkest.
|  Returns the first of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show.
|
|
|-
|-
|  <code>Fanart.Color2</code>
|  <code>Fanart.Color2</code>
|  Returns the second of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show.  Colors are arranged Lightest to Darkest.
|  Returns the second of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show.
|
|
|-
|-
|  <code>Fanart.Color3</code>
|  <code>Fanart.Color3</code>
|  Returns the third of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show.  Colors are arranged Lightest to Darkest.
|  Returns the third of three colors included in the currently selected '''[[Fanart]]''' theme for the parent TV Show.
|
|
|}
|}


=== Game ===
=== Game ===
{|  class="wikitable sortable" width="100%"
{|  class="wikitable sortable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>Game.Title</code>
|  <code>Game.Developer</code>
Name of the game
'''Returns'''
:  The developer of the game (e.g. Activision).
|  v18
|  v18
|-
|-
|  <code>Game.Platform</code>
|  <code>Game.GameClient</code>
Platform the game runs on (e.g. Atari 2600)
'''Returns'''
:  The add-on ID of the emulator used to play the game.
|  v18
|  v18
|-
|-
|  <code>Game.Genres</code>
|  <code>Game.Genres</code>
Gerne of the game (e.g. Action)
'''Returns'''
:  The genre of the game (e.g. Action).
|  v18
|  v18
|-
|-
|  <code>Game.Publisher</code>
|  <code>Game.Overview</code>
Publishing company of the game (e.g. Nintendo)
'''Returns'''
:  The game description.
|  v18
|  v18
|-
|-
|  <code>Game.Developer</code>
|  <code>Game.Platform</code>
Developer of the game
'''Returns'''
:  The platform the game runs on (e.g. Atari 2600).
|  v18
|  v18
|-
|-
|  <code>Game.Overview</code>
|  <code>Game.Publisher</code>
Game description
'''Returns'''
:  The publishing company of the game (e.g. Nintendo).
|  v18
|  v18
|-
|-
|  <code>Game.Year</code>
|  <code>Game.Title</code>
Year the game was released
'''Returns'''
:  The name of the game.
|  v18
|  v18
|-
|-
|  <code>Game.GameClient</code>
|  <code>Game.Year</code>
Name of the used emulator
'''Returns'''
:  The year the game was released.
|  v18
|  v18
|}
=== Integer ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Integer.ValueOf(number)</code>
|  '''Returns'''
:An integer info label that represents the provided number
'''Parameters'''
:number - the number to compute
{{highlight|'''Note'''<br>Example: <code>Integer.ValueOf(4)</code> will be evaluated to 4.<br>Will return -1 if not able to convert the provided value to an integer. Example: <code>Integer.ValueOf(some string)</code> will evaluate to -1 as the provided argument is not an integer.}}
|
|}
|}


=== ListItem ===
=== ListItem ===
{|  class="wikitable sortable" width="100%"
{|  class="wikitable sortable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>ListItem.AddonBroken</code>
|  <code>ListItem.AddonBroken</code>
|  Deprecated! use ListItem.AddonLifecycleDesc instead
|  Deprecated! use ListItem.AddonLifecycleDesc instead.
|
|
|-
|-
|  <code>ListItem.AddonCreator</code>
|  <code>ListItem.AddonCreator</code>
Shows the name of the author the currently selected addon
'''Returns'''
:The name of the author the currently selected addon.
|
|
|-
|-
|  <code>ListItem.AddonDescription</code>
|  <code>ListItem.AddonDescription</code>
Shows the full description of the currently selected addon
'''Returns'''
:The full description of the currently selected addon.
|
|
|-
|-
| <code>ListItem.AddonDisclaimer</code>
| <code>ListItem.AddonDisclaimer</code>
Shows the disclaimer of the currently selected addon
'''Returns'''
:The disclaimer of the currently selected addon.
|
|
|-
|-
| <code>ListItem.AddonInstallDate</code>
| <code>ListItem.AddonInstallDate</code>
Date the addon was installed
'''Returns'''
:The date the addon was installed.
|
|
|-
|-
| <code>ListItem.AddonLastUpdated</code>
| <code>ListItem.AddonLastUpdated</code>
Date the addon was last updated
'''Returns'''
:The date the addon was last updated.
|
|
|-
|-
| <code>ListItem.AddonLastUsed</code>
| <code>ListItem.AddonLastUsed</code>
Date the addon was used last
'''Returns'''
:The date the addon was used last.
|
|
|-
|-
| <code>ListItem.AddonLifecycleDesc</code>
| <code>ListItem.AddonLifecycleDesc</code>
Description of the Lifecycle type (example: broken due to website changes)
'''Returns'''
| v19
:The description of the lifecycle type (e.g. broken due to website changes).
| v19
|-
|-
| <code>ListItem.AddonLifecycleType</code>
| <code>ListItem.AddonLifecycleType</code>
|  The Lifecycle type of the addon (returns a localized string: normal / broken / deprecated)
'''Returns'''
| v19
:The lifecycle type of the addon as a localized string (e.g. normal, broken, or deprecated).
| v19
|-
|-
| <code>ListItem.AddonName</code>
| <code>ListItem.AddonName</code>
Shows the name of the currently selected addon
'''Returns'''
:The name of the currently selected addon.
|
|
|-
|-
| <code>ListItem.AddonNews</code>
| <code>ListItem.AddonNews</code>
|  Returns a brief changelog, taken from the addons' addon.xml file
'''Returns'''
:A brief changelog, taken from the addons' addon.xml file.
|
|
|-
|-
|  <code>ListItem.AddonSize</code>
|  <code>ListItem.AddonOrigin</code>
Filesize of the addon
'''Returns'''
:The name of the repository the add-on originates from.
|
|
|-
|-
| <code>ListItem.AddonSummary</code>
| <code>ListItem.AddonSize</code>
Shows a short description of the currently selected addon
'''Returns'''
:The filesize of the addon.
|
|
|-
|-
| <code>ListItem.AddonType</code>
| <code>ListItem.AddonSummary</code>
Shows the type (e.g. screensaver, script, skin, etc) of the currently selected addon
'''Returns'''
:A short description of the currently selected addon.
|
|
|-
|-
| <code>ListItem.AddonVersion</code>
| <code>ListItem.AddonType</code>
Shows the version of the currently selected addon
'''Returns'''
:The type of the currently selected addon (e.g. screensaver, script, skin, etc).
|
|
|-
|-
| <code>ListItem.Album</code>
| <code>ListItem.AddonVersion</code>
Shows the album of the currently selected song in a container
'''Returns'''
:The version of the currently selected addon.
|
|
|-
|-
| <code>ListItem.AlbumArtist</code>
| <code>ListItem.Album</code>
Shows the artist of the currently selected album in a list
'''Returns'''
:The album of the currently selected song in a container.
|
|
|-
|-
| <code>ListItem.AlbumStatus</code>
| <code>ListItem.AlbumArtist</code>
|  Returns the Musicbrainz release status of the album (e.g. offical, bootleg, promotion, etc).
'''Returns'''
| v19
:The artist of the currently selected album in a list.
|
|-
|-
|  <code>ListItem.Appearances</code>
| <code>ListItem.AlbumStatus</code>
|  Returns the number of movies featuring the selected actor / directed by the selected director
'''Returns'''
| v17
:The Musicbrainz release status of the album (e.g. offical, bootleg, promotion, etc).
| v19
|-
| <code>ListItem.Appearances</code>
'''Returns'''
:The number of movies featuring the selected actor or directed by the selected director.
| v17
|-
|-
| <code>ListItem.Artist</code>
| <code>ListItem.Artist</code>
Shows the artist of the currently selected song in a container
'''Returns'''
:The artist of the currently selected song in a container.
|
|
|-
|-
| <code>ListItem.AudioChannels</code>
| <code>ListItem.AudioChannels</code>
Shows the number of audio channels of the currently selected video (possible values: 1, 2, 4, 5, 6, 7, 8, 10)
'''Returns'''
:The number of audio channels of the currently selected video (e.g. 1, 2, 4, 5, 6, 7, 8, 10, etc).
|
|
|-
|-
| <code>ListItem.AudioCodec</code>
| <code>ListItem.AudioCodec</code>
Shows the audio codec of the currently selected video (possible values: aac, aac_latm, ac3, aif, aifc, aiff, alac, ape, avc, cdda, dca, dolbydigital, dts, dtshd_hra, dtshd_ma, dtshd_ma_x*, dtshd_ma_x_imax*, dtsma, eac3, eac3_ddp_atmos*, flac, mp1, mp3, mp3float, ogg, opus, pcm, pcm_bluray, pcm_s16le, pcm_s24le, truehd, truehd_atmos*, vorbis, wav, wavpack, wmapro, wmav2)
'''Returns'''
| *v22
:The audio codec of the currently selected video.<br>
:Possible values:
:*aac
:*aac_latm
:*aac_lc*
:*aac_ltp*
:*aac_ssr*
:*ac3
:*aif
:*aifc
:*aiff
:*alac
:*ape
:*avc
:*cdda
:*dca**
:*dts***
:*dolbydigital
:*dtshd_hra
:*dtshd_ma
:*dtshd_ma_x*
:*dtshd_ma_x_imax*
:*dtsma
:*eac3
:*eac3_ddp_atmos*
:*flac
:*he_aac*
:*he_aac_v2*
:*mp1
:*mp2
:*mp3
:*mp3float
:*ogg
:*opus
:*pcm
:*pcm_bluray
:*pcm_s16le
:*pcm_s24le
:*truehd
:*truehd_atmos*
:*vorbis
:*wav
:*wavpack
:*wmapro
:*wmav2
:
: ** note: dca replaced dts in 2011. Deprecated in 2026 / v22.
: *** note: dts used before 2011 and reintroduced in 2026 / v22.
| *v22
|-
|-
| <code>ListItem.AudioLanguage</code>
| <code>ListItem.AudioLanguage</code>
Shows the audio language of the currently selected video (returns an ISO 639-2 three character code, e.g. eng, epo, deu)
'''Returns'''
:The audio language of the currently selected video as an ISO 639-2 three character code (e.g. eng, epo, deu).
|
|
|-
|-
| <code>ListItem.BitRate</code>
| <code>ListItem.BitRate</code>
|  Returns the bitrate of the current song (Actual rate for CBR, average rate for VBR)
'''Returns'''
| v19
:The actual bitrate for CBR or average bitrate for VBR of the currently selected song.
| v19
|-
|-
| <code>ListItem.BPM</code>
| <code>ListItem.BPM</code>
|  Returns the Beats Per Minute for a song
'''Returns'''
| v19
:The Beats Per Minute of the currently selected song.
| v19
|-
|-
| <code>ListItem.Cast</code>
| <code>ListItem.Cast</code>
A list of cast members, separated by carriage returns, for use in dialogvideoinfo.xml
'''Returns'''
:The list of cast members, separated by carriage returns, for use in dialogvideoinfo.xml.
|
|
|-
|-
|  <code>ListItem.CastAndRole</code>
<code>ListItem.Cast(separator)</code>
A list of cast members and roles, separated by carriage returns. Every cast/role combination is formatted 'cast' as 'role' where 'as' is localised, for use in dialogvideoinfo.xml
|  '''Returns'''
:A list of cast members, separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
| <code>ListItem.CastAndRole</code>
'''Returns'''
:The list of cast members and roles, separated by carriage returns. Every cast/role combination is formatted 'cast' as 'role' where 'as' is localised, for use in dialogvideoinfo.xml.
|
|
|-
|-
|  <code>ListItem.ChannelLogo</code>
|  <code>ListItem.CastAndRole(separator)</code>
Shows the logo of the currently selected radio or TV channel
'''Returns'''
| v22
:A list of cast members and roles, separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>ListItem.ChannelName</code>
|  <code>ListItem.ChannelGroup</code>
Name of current selected TV channel in a container
'''Returns'''
:The channel group of the selected item ( PVR ).
|
|
|-
|-
| <code>ListItem.ChannelName</code>
| <code>ListItem.ChannelLogo</code>
Channelname of the selected item (PVR).
'''Returns'''
|
:The logo of the currently selected radio or TV channel (PVR).
| v22
|-
|-
| <code>ListItem.ChannelNumber</code>
| <code>ListItem.ChannelName</code>
Channel number of the selected item (PVR).
'''Returns'''
:The name of current selected TV channel in a container (PVR).
|
|
|-
|-
| <code>ListItem.ChannelNumberLabel</code>
| <code>ListItem.ChannelName</code>
Channel and subchannel number of the currently selected channel that's currently playing (PVR).
'''Returns'''
:The channel name of the selected item (PVR).
|
|
|-
|-
| <code>ListItem.Comment</code>
| <code>ListItem.ChannelNumber</code>
Comment assigned to the item (PVR/MUSIC).
'''Returns'''
:The channel number of the selected item (PVR).
|
|
|-
|-
| <code>ListItem.ContributorAndRole</code>
| <code>ListItem.ChannelNumberLabel</code>
List of all people and their role who've contributed to the selected song
'''Returns'''
:The channel and subchannel number of the currently selected channel that's currently playing (PVR).
|
|
|-
|-
| <code>ListItem.Contributors</code>
| <code>ListItem.Comment</code>
List of all people who've contributed to the selected song
|  '''Returns'''
:The comment assigned to the item (PVR/MUSIC).
|
|
|-
|-
| <code>ListItem.Country</code>
| <code>ListItem.ContributorAndRole</code>
Shows the production country of the currently selected movie in a container
'''Returns'''
:The list of all people and their role who've contributed to the selected song.
|
|
|-
|-
| <code>ListItem.CurrentItem</code>
| <code>ListItem.Contributors</code>
Will return the current index of the item in a container starting at 1.
'''Returns'''
|  v19
:The list of all people who've contributed to the selected song.
|-
|  <code>ListItem.Date</code>
|  Shows the file date of the currently selected song or movie in a container / Aired date of an episode / Day, start time and end time of current selected TV programme (PVR)
|
|
|-
|-
| <code>ListItem.DateAdded</code>
| <code>ListItem.Country</code>
Shows the date the currently selected item was added to the library / Date and time of an event in the EventLog window.
'''Returns'''
:The production country of the currently selected movie in a container.
|
|
|-
|-
| <code>ListItem.DBID</code>
| <code>ListItem.CurrentItem</code>
Shows the database id of the currently selected ListItem in a container
'''Returns'''
|
:The current index of the item in a container starting at 1.
| v19
|-
|-
| <code>ListItem.DBTYPE</code>
| <code>ListItem.Date</code>
Shows the database type of the ListItem.DBID for videos (video, movie, set, tvshow, season, episode, musicvideo) or for audio (music, song, album, artist). Beware with season, the "*all seasons" entry does give a DBTYPE "season" and a DBID, but you can't get the details of that entry since it's a virtual entry in the Video Library.
'''Returns'''
:The file date of the currently selected song or movie in a container, the aired date of an episode, or the day, start time, and end time of the currently selected TV programme (PVR).
|
|
|-
|-
| <code>ListItem.Director</code>
| <code>ListItem.DateAdded</code>
Shows the director of the currently selected movie in a container
'''Returns'''
:The date the currently selected item was added to the library or date and time of an event in the EventLog window.
|
|
|-
|-
|  <code>ListItem.DiscNumber</code>
|  <code>ListItem.DateTime</code>
Shows the disc number of the currently selected song in a container
'''Returns'''
:The date and time a certain event happened (event log).
|
|
|-
|-
| <code>ListItem.DiscTitle</code>
| <code>ListItem.DBID</code>
|  The disc title of the currently selected album or song
'''Returns'''
| v19
:The database id of the currently selected ListItem in a container.
|
|-
|-
| <code>ListItem.Duration[(format)]</code>
| <code>ListItem.DBTYPE</code>
Shows the song or movie duration of the currently selected movie in a container. Optionally specify a time format, hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
:The database type of the ListItem.DBID for videos (video, movie, set, tvshow, season, episode, musicvideo) or for audio (music, song, album, artist).
{{highlight|'''Note'''<br>
With season, the "*all seasons" entry does give a DBTYPE "season" and a DBID, but you can't get the details of that entry since it's a virtual entry in the Video Library.}}
|
|
|-
|-
| <code>ListItem.EndDate</code>
| <code>ListItem.DecodedFileNameAndPath</code>
End date of the selected item (PVR).
'''Returns'''
:The full path with filename of the currently selected song or movie in a container decoded.
|
|
|-
|-
|  <code>ListItem.EndTime</code>
|  <code>ListItem.Developer</code>
End time of current selected TV programme in a container
'''Returns'''
:The game developer (e.g. "Square") (RETROPLAYER).
|
|
|-
|-
| <code>ListItem.EndTime</code>
| <code>ListItem.Director</code>
End time of the selected item (PVR).
'''Returns'''
:The director of the currently selected movie in a container.
|
|
|-
|-
|  <code>ListItem.EndTimeResume</code>
|  <code>ListItem.Director(separator)</code>
|  Returns the time a video will end if you resume it, instead of playing it from the beginning.
'''Returns'''
:A list of directors, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
| <code>ListItem.DiscNumber</code>
|  '''Returns'''
:The disc number of the currently selected song in a container.
|
|
|-
|-
| <code>ListItem.Episode</code>
| <code>ListItem.DiscTitle</code>
Shows the episode number value for the currently selected episode. It also shows the number of total, watched or unwatched episodes for the currently selected tvshow or season, based on the the current watched filter.
'''Returns'''
|
:The disc title of the currently selected album or song.
| v19
|-
|-
| <code>ListItem.EpisodeName</code>
| <code>ListItem.Duration[(format)]</code>
(PVR only) The name of the episode if the selected EPG item is a TV Show
'''Returns'''
:The song or movie duration of the currently selected movie in a container. Optionally specify a time format, hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
| <code>ListItem.FileExtension</code>
| <code>ListItem.EndDate</code>
Shows the file extension (without leading dot) of the currently selected item in a container
'''Returns'''
:The end date of the selected item (PVR).
|
|
|-
|-
| <code>ListItem.FileName</code>
| <code>ListItem.EndTime</code>
Shows the filename of the currently selected song or movie in a container
'''Returns'''
:The end time of current selected TV programme in a container (PVR).
|
|
|-
|-
| <code>ListItem.FileNameAndPath</code>
| <code>ListItem.EndTimeResume</code>
Shows the full path with filename of the currently selected song or movie in a container
'''Returns'''
:The time a video will end if you resume it, instead of playing it from the beginning.
|
|
|-
|-
|  <code>ListItem.FileNameNoExtension</code>
|  <code>ListItem.EpgEventTitle</code>
|  Returns the filename without its extension.
'''Returns'''
|  v19
:The title of the epg event associated with the item, if any.
|-
|  <code>ListItem.FolderName</code>
|  Shows top most folder of the path of the currently selected song or movie in a container
|
|
|-
|-
| <code>ListItem.FolderPath</code>
| <code>ListItem.Episode</code>
Shows the complete path of the currently selected song or movie in a container (without user details).
'''Returns'''
:The episode number value for the currently selected episode. It also shows the number of total, watched or unwatched episodes for the currently selected TV show or season, based on the the current watched filter.
|
|
|-
|-
| <code>ListItem.Genre</code>
| <code>ListItem.EpisodeName</code>
Shows the genre of the currently selected song, album or movie in a container
'''Returns'''
:The name of the episode if the selected EPG item is a TV Show (PVR).
|
|
|-
|-
|  <code>ListItem.HdrType</code>
|  <code>ListItem.EpisodePart</code>
Shows the HDR type of the currently selected video (possible values: hdr10, dolbyvision and hlg)
'''Returns'''
|  v20
:string containing the number of parts of a single episode - empty if no data provided
|-
|  <code>ListItem.IMDBNumber</code>
|  The IMDB iD of the selected Video in a container
|
|
|-
|-
|  <code>ListItem.IsBoxset</code>
|  <code>ListItem.ExpirationDate</code>
|  Returns true if the item is part of a boxset
'''Returns'''
|  v19
:The expiration date of the selected item in a container, empty string if not supported.
|-
|  <code>ListItem.Label</code>
|  Shows the left label of the currently selected item in a container
|
|
|-
|-
|  <code>ListItem.Label2</code>
|  <code>ListItem.ExpirationTime</code>
Shows the right label of the currently selected item in a container
'''Returns'''
:The expiration time of the selected item in a container, empty string if not supported
|
|
|-
|-
| <code>ListItem.LastPlayed</code>
| <code>ListItem.FileExtension</code>
Last play date of Video in a container
'''Returns'''
:The file extension (without leading dot) of the currently selected item in a container.
|
|
|-
|-
| <code>ListItem.Mood</code>
| <code>ListItem.FileName</code>
Mood of the selected song
'''Returns'''
:The filename of the currently selected song or movie in a container.
|
|
|-
|-
| <code>ListItem.Mpaa</code>
| <code>ListItem.FileNameAndPath</code>
Show the MPAA rating of the currently selected movie in a container
'''Returns'''
:The full path with filename of the currently selected song or movie in a container.
|
|
|-
|-
| <code>ListItem.MusicChannels</code>
| <code>ListItem.FileNameNoExtension</code>
|  Returns the number of audio channels for a song
'''Returns'''
| v19
:The filename without its extension.
| v19
|-
|-
| <code>ListItem.NextDuration</code>
| <code>ListItem.FolderName</code>
Duration of the next item (PVR).
'''Returns'''
|  v18
:The top most folder of the path of the currently selected song or movie in a container.
|-
|  <code>ListItem.NextEndDate</code>
|  End date of the next item (PVR).
|
|
|-
|-
| <code>ListItem.NextEndTime</code>
| <code>ListItem.FolderPath</code>
End of the next item (PVR).
'''Returns'''
:The complete path of the currently selected song or movie in a container (without user details).
|
|
|-
|-
|  <code>ListItem.NextGenre</code>
|  <code>ListItem.GameClient</code>
Genre of the next item (PVR).
'''Returns'''
:The add-on ID of the game client (a.k.a. emulator) to use for playing the game (e.g. game.libretro.fceumm) (RETROPLAYER).
|
|
|-
|-
| <code>ListItem.NextPlot</code>
| <code>ListItem.Genre</code>
Plot of the next item (PVR).
'''Returns'''
:The genre of the currently selected song, album, or movie in a container.
|
|
|-
|-
|  <code>ListItem.NextPlotOutline</code>
|  <code>ListItem.Genre(separator)</code>
Plot outline of the next item (PVR).
'''Returns'''
|
:A list of genres, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for videos or music. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>ListItem.NextStartDate</code>
|  <code>ListItem.Genres</code>
Start date of the next item (PVR).
'''Returns'''
:The game genres (e.g. "["Action","Strategy"]") (RETROPLAYER).
|
|
|-
|-
|  <code>ListItem.NextStartTime</code>
|  <code>ListItem.HdrDetail</code>
Start time of the next item (PVR).
'''Returns'''
:String containing details for the HDR type (currently only for DV - profile and EL type) or empty if not HDR. Prints eg 5, 7FEL, and compatibility ID for profile 8 eg 8.4.
|
|
|-
|-
| <code>ListItem.NextTitle</code>
| <code>ListItem.HdrType</code>
Title of the next item (PVR).
'''Returns'''
|
:The HDR type of the currently selected video (e.g. hdr10, dolbyvision, or hlg).
| v20
|-
|-
| <code>ListItem.OriginalDate</code>
| <code>ListItem.IMDBNumber</code>
|  Returns the original release date of the item
'''Returns'''
|  v19
:The IMDB iD of the selected Video in a container.
|-
|  <code>ListItem.OriginalTitle</code>
|  Shows the original title of the currently selected movie in a container
|
|
|-
|-
| <code>ListItem.ParentalRatingCode</code>
| <code>ListItem.Label</code>
|  Shows the parental rating code
'''Returns'''
|  v22
:The left label of the currently selected item in a container.
|-
|  <code>ListItem.ParentalRatingIcon</code>
|  Shows the parental rating icon
|  v22
|-
<code>ListItem.ParentalRatingSource</code>
Shows the parental rating source
|  v22
|-
|  <code>ListItem.Path</code>
|  Shows the complete path of the currently selected song or movie in a container
|
|
|-
|-
| <code>ListItem.PercentPlayed</code>
| <code>ListItem.Label2</code>
|  Returns percentage value [0-100] of how far the selected video has been played
'''Returns'''
:The right label of the currently selected item in a container.
|
|
|-
|-
| <code>ListItem.PictureAperture</code>
| <code>ListItem.LastPlayed</code>
Shows the F-stop used to take the selected picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
'''Returns'''
:The last play date of video in a container.
|
|
|-
|-
|  <code>ListItem.PictureAuthor</code>
|  <code>ListItem.MediaProviders</code>
Shows the name of the person involved in writing about the selected picture. This is the value of the IPTC Writer tag (hex code 0x7A).
'''Returns'''
:string containing the names of the media providers of the item, separated by commas if multiple are present.
|
|
|-
|-
| <code>ListItem.PictureByline</code>
| <code>ListItem.Mood</code>
Shows the name of the person who created the selected picture. This is the value of the IPTC Byline tag (hex code 0x50).
'''Returns'''
:The mood of the selected song.
|
|
|-
|-
| <code>ListItem.PictureBylineTitle</code>
| <code>ListItem.Mpaa</code>
Shows the title of the person who created the selected picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
'''Returns'''
:The MPAA rating of the currently selected movie in a container.
|
|
|-
|-
| <code>ListItem.PictureCamMake</code>
| <code>ListItem.MusicChannels</code>
Shows the manufacturer of the camera used to take the selected picture. This is the value of the EXIF Make tag (hex code 0x010F).
'''Returns'''
|
:The number of audio channels for a song.
| v19
|-
|-
| <code>ListItem.PictureCamModel</code>
| <code>ListItem.NextDuration</code>
Shows the manufacturer's model name or number of the camera used to take the selected picture. This is the value of the EXIF Model tag (hex code 0x0110).
|  '''Returns'''
|
:The duration of the next item (PVR).
| v18
|-
|-
| <code>ListItem.PictureCaption</code>
| <code>ListItem.NextEndDate</code>
Shows a description of the selected picture. This is the value of the IPTC Caption tag (hex code 0x78).
'''Returns'''
:The end date of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureCategory</code>
| <code>ListItem.NextEndTime</code>
Shows the subject of the selected picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
'''Returns'''
:The end of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureCCDWidth</code>
| <code>ListItem.NextGenre</code>
Shows the width of the CCD in the camera used to take the selected picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
'''Returns'''
:The genre of the next item (PVR).
|
|
|-
|-
|  <code>ListItem.PictureCity</code>
|  <code>ListItem.NextGenre(separator)</code>
Shows the city where the selected picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
'''Returns'''
|
:A list of genres of the the next item (PVR), separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for videos. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
| <code>ListItem.PictureColour</code>
| <code>ListItem.NextPlot</code>
Shows whether the selected picture is "Colour" or "Black and White".
'''Returns'''
:The plot of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureComment</code>
| <code>ListItem.NextPlotOutline</code>
Shows a description of the selected picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
'''Returns'''
:The plot outline of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureCopyrightNotice</code>
| <code>ListItem.NextStartDate</code>
Shows the copyright notice of the selected picture. This is the value of the IPTC Copyright tag (hex code 0x74).
'''Returns'''
:The start date of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureCountry</code>
| <code>ListItem.NextStartTime</code>
Shows the full name of the country where the selected picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
'''Returns'''
:The start time of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureCountryCode</code>
| <code>ListItem.NextTitle</code>
Shows the country code of the country where the selected picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
'''Returns'''
:The title of the next item (PVR).
|
|
|-
|-
| <code>ListItem.PictureCredit</code>
| <code>ListItem.OriginalDate</code>
Shows who provided the selected picture. This is the value of the IPTC Credit tag (hex code 0x6E).
'''Returns'''
|
:The original release date of the item.
| v19
|-
|-
| <code>ListItem.PictureDate</code>
| <code>ListItem.OriginalTitle</code>
Shows the localized date of the selected picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
'''Returns'''
:The original title of the currently selected movie in a container.
|
|
|-
|-
|  <code>ListItem.PictureDatetime</code>
|  <code>ListItem.Overview</code>
Shows the date/timestamp of the selected picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
'''Returns'''
:The game overview/summary (RETROPLAYER).
|
|
|-
|-
|  <code>ListItem.PictureDesc</code>
|  <code>ListItem.ParentalRating</code>
Shows a short description of the selected picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
'''Returns'''
:The parental rating of the list item ( PVR ).
|
|
|-
|-
| <code>ListItem.PictureDigitalZoom</code>
| <code>ListItem.ParentalRatingCode</code>
Shows the digital zoom ratio when the selected picture was taken. This is the value of the EXIF DigitalZoomRatio tag (hex code 0xA404).
'''Returns'''
|
:The parental rating code.
| v22
|-
|-
| <code>ListItem.PictureExpMode</code>
| <code>ListItem.ParentalRatingIcon</code>
Shows the exposure mode of the selected picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
'''Returns'''
|
:The parental rating icon.
| v22
|-
|-
| <code>ListItem.PictureExposure</code>
| <code>ListItem.ParentalRatingSource</code>
Shows the class of the program used by the camera to set exposure when the selected picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
'''Returns'''
|
:The parental rating source.
| v22
|-
|-
| <code>ListItem.PictureExposureBias</code>
| <code>ListItem.Path</code>
Shows the exposure bias of the selected picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
'''Returns'''
:The complete path of the currently selected song or movie in a container.
|
|
|-
|-
| <code>ListItem.PictureExpTime</code>
| <code>ListItem.PercentPlayed</code>
Shows the exposure time of the selected picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
'''Returns'''
:The returns percentage value [0-100] of how far the selected video has been played.
|
|
|-
|-
| <code>ListItem.PictureFlashUsed</code>
| <code>ListItem.PictureAperture</code>
Shows the status of flash when the selected picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209).
'''Returns'''
:The f-stop used to take the selected picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
|
|
|-
|-
| <code>ListItem.PictureFocalLen</code>
| <code>ListItem.PictureAuthor</code>
Shows the lens focal length of the selected picture
'''Returns'''
:The name of the person involved in writing about the selected picture. This is the value of the IPTC Writer tag (hex code 0x7A).
|
|
|-
|-
| <code>ListItem.PictureFocusDist</code>
| <code>ListItem.PictureByline</code>
Shows the focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
'''Returns'''
:The name of the person who created the selected picture. This is the value of the IPTC Byline tag (hex code 0x50).
|
|
|-
|-
| <code>ListItem.PictureGPSAlt</code>
| <code>ListItem.PictureBylineTitle</code>
Shows the altitude in meters where the selected picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
'''Returns'''
:The title of the person who created the selected picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
|
|
|-
|-
| <code>ListItem.PictureGPSLat</code>
| <code>ListItem.PictureCamMake</code>
Shows the latitude where the selected picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
'''Returns'''
:The manufacturer of the camera used to take the selected picture. This is the value of the EXIF Make tag (hex code 0x010F).
|
|
|-
|-
| <code>ListItem.PictureGPSLon</code>
| <code>ListItem.PictureCamModel</code>
Shows the longitude where the selected picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
'''Returns'''
:The manufacturer's model name or number of the camera used to take the selected picture. This is the value of the EXIF Model tag (hex code 0x0110).
|
|
|-
|-
| <code>ListItem.PictureHeadline</code>
| <code>ListItem.PictureCaption</code>
Shows a synopsis of the contents of the selected picture. This is the value of the IPTC Headline tag (hex code 0x69).
'''Returns'''
:The description of the selected picture. This is the value of the IPTC Caption tag (hex code 0x78).
|
|
|-
|-
| <code>ListItem.PictureImageType</code>
| <code>ListItem.PictureCategory</code>
Shows the color components of the selected picture. This is the value of the IPTC ImageType tag (hex code 0x82).
'''Returns'''
:The subject of the selected picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
|
|
|-
|-
| <code>ListItem.PictureIPTCDate</code>
| <code>ListItem.PictureCCDWidth</code>
Shows the date when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
'''Returns'''
:The width of the CCD in the camera used to take the selected picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
|
|
|-
|-
| <code>ListItem.PictureIPTCTime</code>
| <code>ListItem.PictureCity</code>
Shows the time when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
'''Returns'''
:The city where the selected picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
|
|
|-
|-
| <code>ListItem.PictureISO</code>
| <code>ListItem.PictureColour</code>
Shows the ISO speed of the camera when the selected picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
'''Returns'''
:Whether the selected picture is "Colour" or "Black and White".
|
|
|-
|-
| <code>ListItem.PictureKeywords</code>
| <code>ListItem.PictureComment</code>
Shows keywords assigned to the selected picture. This is the value of the IPTC Keywords tag (hex code 0x19).
'''Returns'''
:The description of the selected picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
|
|
|-
|-
| <code>ListItem.PictureLightSource</code>
| <code>ListItem.PictureCopyrightNotice</code>
Shows the kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
'''Returns'''
:The copyright notice of the selected picture. This is the value of the IPTC Copyright tag (hex code 0x74).
|
|
|-
|-
| <code>ListItem.PictureLongDate</code>
| <code>ListItem.PictureCountry</code>
Shows only the localized date of the selected picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
'''Returns'''
:The full name of the country where the selected picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
|
|
|-
|-
| <code>ListItem.PictureLongDatetime</code>
| <code>ListItem.PictureCountryCode</code>
Shows the date/timestamp of the selected picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
'''Returns'''
:The country code of the country where the selected picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
|
|
|-
|-
| <code>ListItem.PictureMeteringMode</code>
| <code>ListItem.PictureCredit</code>
Shows the metering mode used when the selected picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
'''Returns'''
:The provider of the selected picture. This is the value of the IPTC Credit tag (hex code 0x6E).
|
|
|-
|-
| <code>ListItem.PictureObjectName</code>
| <code>ListItem.PictureDate</code>
Shows a shorthand reference for the selected picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
'''Returns'''
:The localized date of the selected picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|
|-
|-
| <code>ListItem.PictureOrientation</code>
| <code>ListItem.PictureDatetime</code>
Shows the orientation of the selected picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
'''Returns'''
:The date/timestamp of the selected picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|
|-
|-
| <code>ListItem.PicturePath</code>
| <code>ListItem.PictureDesc</code>
Shows the filename and path of the selected picture
'''Returns'''
:The short description of the selected picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
|
|
|-
|-
| <code>ListItem.PictureProcess</code>
| <code>ListItem.PictureDigitalZoom</code>
Shows the process used to compress the selected picture
'''Returns'''
:The digital zoom ratio when the selected picture was taken. This is the value of the EXIF DigitalZoomRatio tag (hex code 0xA404).
|
|
|-
|-
| <code>ListItem.PictureReferenceService</code>
| <code>ListItem.PictureExpMode</code>
Shows the Service Identifier of a prior envelope to which the selected picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
'''Returns'''
:The exposure mode of the selected picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
|
|
|-
|-
| <code>ListItem.PictureResolution</code>
| <code>ListItem.PictureExposure</code>
Shows the dimensions of the selected picture
'''Returns'''
:The class of the program used by the camera to set exposure when the selected picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
|
|
|-
|-
| <code>ListItem.PictureSource</code>
| <code>ListItem.PictureExposureBias</code>
Shows the original owner of the selected picture. This is the value of the IPTC Source tag (hex code 0x73).
'''Returns'''
:The exposure bias of the selected picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
|
|
|-
|-
| <code>ListItem.PictureSpecialInstructions</code>
| <code>ListItem.PictureExpTime</code>
Shows other editorial instructions concerning the use of the selected picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
'''Returns'''
:The exposure time of the selected picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
|
|
|-
|-
| <code>ListItem.PictureState</code>
| <code>ListItem.PictureFlashUsed</code>
Shows the State/Province where the selected picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
'''Returns'''
:The status of flash when the selected picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209).
|
|
|-
|-
| <code>ListItem.PictureSublocation</code>
| <code>ListItem.PictureFocalLen</code>
Shows the location within a city where the selected picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
'''Returns'''
:The lens focal length of the selected picture.
|
|
|-
|-
| <code>ListItem.PictureSupplementalCategories</code>
| <code>ListItem.PictureFocusDist</code>
Shows supplemental category codes to further refine the subject of the selected picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
'''Returns'''
:The focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
|
|
|-
|-
| <code>ListItem.PictureTransmissionReference</code>
| <code>ListItem.PictureGPSAlt</code>
Shows a code representing the location of original transmission of the selected picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
'''Returns'''
:The altitude in meters where the selected picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
|
|
|-
|-
| <code>ListItem.PictureUrgency</code>
| <code>ListItem.PictureGPSLat</code>
Shows the urgency of the selected picture. Values are 1-9. The "1" is most urgent. Some image management programs use urgency to indicate picture rating, where urgency "1" is 5 stars and urgency "5" is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
'''Returns'''
:The latitude where the selected picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
|
|
|-
|-
| <code>ListItem.PictureWhiteBalance</code>
| <code>ListItem.PictureGPSLon</code>
Shows the white balance mode set when the selected picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
'''Returns'''
:The longitude where the selected picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
|
|
|-
|-
| <code>ListItem.PlayCount</code>
| <code>ListItem.PictureHeadline</code>
Playcount of Video in a container
'''Returns'''
:The synopsis of the contents of the selected picture. This is the value of the IPTC Headline tag (hex code 0x69).
|
|
|-
|-
| <code>ListItem.Plot</code>
| <code>ListItem.PictureImageType</code>
Complete Text Summary of Video in a container
'''Returns'''
:The color components of the selected picture. This is the value of the IPTC ImageType tag (hex code 0x82).
|
|
|-
|-
| <code>ListItem.PlotOutline</code>
| <code>ListItem.PictureIPTCDate</code>
Small Summary of current Video in a container
'''Returns'''
:The date when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
|
|
|-
|-
| <code>ListItem.Premiered</code>
| <code>ListItem.PictureIPTCTime</code>
Shows the release/aired date of the currently selected episode, show, movie or EPG item in a container
'''Returns'''
:The time when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
|
|
|-
|-
| <code>ListItem.PrivacyPolicy</code>
| <code>ListItem.PictureISO</code>
|  Returns the official Kodi privacy-policy
'''Returns'''
|  v17
:The ISO speed of the camera when the selected picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
|-
|  <code>ListItem.ProgramCount</code>
|  Shows the number of times an xbe has been run from "my programs"
|
|
|-
|-
| <code>ListItem.Progress</code>
| <code>ListItem.PictureKeywords</code>
Part of the programme that's been played (PVR).
'''Returns'''
:The keywords assigned to the selected picture. This is the value of the IPTC Keywords tag (hex code 0x19).
|
|
|-
|-
| <code>ListItem.Property(Addon.Changelog)</code>
| <code>ListItem.PictureLightSource</code>
Shows the changelog of the currently selected addon
'''Returns'''
:The kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
|
|
|-
|-
| <code>ListItem.Property(Addon.ID)</code>
| <code>ListItem.PictureLongDate</code>
Shows the identifier of the currently selected addon
'''Returns'''
:The localized date of the selected picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|
|-
|-
| <code>ListItem.Property(Addon.Path)</code>
| <code>ListItem.PictureLongDatetime</code>
Shows the path of the currently selected addon
'''Returns'''
:The date/timestamp of the selected picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|
|-
|-
| <code>ListItem.Property(Addon.Status)</code>
| <code>ListItem.PictureMeteringMode</code>
Shows the status of the currently selected addon
'''Returns'''
:The metering mode used when the selected picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
|
|
|-
|-
| <code>ListItem.Property(Album_Description)</code>
| <code>ListItem.PictureObjectName</code>
Shows a review of the currently selected Album
'''Returns'''
:The shorthand reference for the selected picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
|
|
|-
|-
| <code>ListItem.Property(Album_Duration)</code>
| <code>ListItem.PictureOrientation</code>
|  Returns the duration of an album in HH:MM:SS
'''Returns'''
|  v19
:The orientation of the selected picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
|-
|  <code>ListItem.Property(Album_Label)</code>
|  Shows the record label of the currently selected Album
|
|
|-
|-
| <code>ListItem.Property(Album_Mood)</code>
| <code>ListItem.PicturePath</code>
Shows the moods of the currently selected Album
'''Returns'''
:The filename and path of the selected picture.
|
|
|-
|-
| <code>ListItem.Property(Album_Rating)</code>
| <code>ListItem.PictureProcess</code>
Shows the scraped rating of the currently selected Album
'''Returns'''
:The process used to compress the selected picture.
|
|
|-
|-
| <code>ListItem.Property(Album_Style)</code>
| <code>ListItem.PictureReferenceService</code>
Shows the styles of the currently selected Album
'''Returns'''
:The service identifier of a prior envelope to which the selected picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
|
|
|-
|-
| <code>ListItem.Property(Album_Theme)</code>
| <code>ListItem.PictureResolution</code>
Shows the themes of the currently selected Album
'''Returns'''
:The dimensions of the selected picture.
|
|
|-
|-
| <code>ListItem.Property(Album_Type)</code>
| <code>ListItem.PictureSource</code>
Shows the Album Type (e.g. compilation, enhanced, explicit lyrics) of the currently selected Album
'''Returns'''
:The original owner of the selected picture. This is the value of the IPTC Source tag (hex code 0x73).
|
|
|-
|-
| <code>ListItem.Property(Album_UserRating)</code>
| <code>ListItem.PictureSpecialInstructions</code>
Shows the user rating of the currently selected Album
'''Returns'''
:The editorial instructions concerning the use of the selected picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
|
|
|-
|-
| <code>ListItem.Property(Artist_Born)</code>
| <code>ListItem.PictureState</code>
Date of Birth of the currently selected Artist
'''Returns'''
:The State/Province where the selected picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
|
|
|-
|-
| <code>ListItem.Property(Artist_Description)</code>
| <code>ListItem.PictureSublocation</code>
Shows a biography of the currently selected artist
'''Returns'''
:The location within a city where the selected picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
|
|
|-
|-
| <code>ListItem.Property(Artist_Died)</code>
| <code>ListItem.PictureSupplementalCategories</code>
Date of Death of the currently selected Artist
'''Returns'''
:The supplemental category codes to further refine the subject of the selected picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
|
|
|-
|-
| <code>ListItem.Property(Artist_Disambiguation)</code>
| <code>ListItem.PictureTransmissionReference</code>
Brief description of the currently selected Artist that differentiates them from others with the same name
'''Returns'''
| v18
:The code representing the location of original transmission of the selected picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
|
|-
|-
| <code>ListItem.Property(Artist_Disbanded)</code>
| <code>ListItem.PictureUrgency</code>
Disbanding date of the currently selected Band
'''Returns'''
:The urgency of the selected picture. Values are 1-9. The "1" is most urgent. Some image management programs use urgency to indicate picture rating, where urgency "1" is 5 stars and urgency "5" is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
|
|
|-
|-
| <code>ListItem.Property(Artist_Formed)</code>
| <code>ListItem.PictureWhiteBalance</code>
Formation date of the currently selected Band
'''Returns'''
:The white balance mode set when the selected picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
|
|
|-
|-
|  <code>ListItem.Property(Artist_Gender)</code>
|  <code>ListItem.Platform</code>
Gender of the currently selected Artist - male, female, other
'''Returns'''
| v18
:The game platform (e.g. "Atari 2600") (RETROPLAYER).
|
|-
|-
| <code>ListItem.Property(Artist_Genre)</code>
| <code>ListItem.PlayCount</code>
Shows the genre of the currently selected artist
'''Returns'''
:The playcount of video in a container.
|
|
|-
|-
| <code>ListItem.Property(Artist_Instrument)</code>
| <code>ListItem.Plot</code>
Instruments played by the currently selected artist
'''Returns'''
:The complete text summary of video in a container.
|
|
|-
|-
| <code>ListItem.Property(Artist_Mood)</code>
| <code>ListItem.PlotOutline</code>
Shows the moods of the currently selected artist
'''Returns'''
:The small summary of current video in a container.
|
|
|-
|-
| <code>ListItem.Property(Artist_Sortname)</code>
| <code>ListItem.Premiered</code>
Sortname of the currently selected Artist
'''Returns'''
|  v18
:The release/aired date of the currently selected episode, show, movie, or EPG item in a container.
|-
|  <code>ListItem.Property(Artist_Style)</code>
|  Shows the styles of the currently selected artist
|
|
|-
|-
| <code>ListItem.Property(Artist_Type)</code>
| <code>ListItem.PrivacyPolicy</code>
Type of the currently selected Artist - person, group, orchestra, choir, etc.
'''Returns'''
| v18
:The official Kodi privacy-policy.
| v17
|-
|-
| <code>ListItem.Property(Artist_YearsActive)</code>
| <code>ListItem.ProgramCount</code>
Years the currently selected artist has been active
'''Returns'''
:The number of times an xbe has been run from "my programs".
|
|
|-
|-
| <code>ListItem.Property(AudioChannels.[n])</code>
| <code>ListItem.Progress</code>
Shows the number of audio channels of the currently selected video, 'n' defines the number of the audiostream (values: see  ListItem.AudioChannels)
|  '''Returns'''
:The part of the programme that's being played (PVR).
|
|
|-
|-
| <code>ListItem.Property(AudioCodec.[n])</code>
| <code>ListItem.Property(Addon.Changelog)</code>
Shows the audio codec of the currently selected video, 'n' defines the number of the audiostream (values: see  ListItem.AudioCodec)
'''Returns'''
:The changelog of the currently selected addon.
|
|
|-
|-
| <code>ListItem.Property(AudioLanguage.[n])</code>
| <code>ListItem.Property(Addon.ID)</code>
Shows the audio language of the currently selected video, 'n' defines the number of the audiostream (values: see  ListItem.AudioLanguage)
'''Returns'''
:The identifier of the currently selected addon.
|
|
|-
|-
| <code>ListItem.Property(game.stretchmode)</code>
| <code>ListItem.Property(Addon.Path)</code>
Name of the stretch mode (e.g. Stretch 4:3)
'''Returns'''
|  v18
:The path of the currently selected addon.
|-
|  <code>ListItem.Property(game.videofilter)</code>
|  Name of the video filter (e.g.. Bilinear)
|  v18
|-
|  <code>ListItem.Property(game.videorotation)</code>
|  Angle of the rotation
|  v18
|-
|  <code>ListItem.Property(NumEpisodes)</code>
|  Shows the number of total, watched or unwatched episodes for the currently selected tvshow or season, based on the the current watched filter.
|
|
|-
|-
| <code>ListItem.Property(Role.Arranger)</code>
| <code>ListItem.Property(Addon.Status)</code>
|  Returns the name of the person who arranged the selected song
'''Returns'''
:The status of the currently selected addon.
|
|
|-
|-
| <code>ListItem.Property(Role.Composer)</code>
| <code>ListItem.Property(Album_Description)</code>
|  Returns the name of the person who composed the selected song
'''Returns'''
:The review of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Role.Conductor)</code>
| <code>ListItem.Property(Album_Duration)</code>
|  Returns the name of the person who conducted the selected song
'''Returns'''
|
:The duration of an album in HH:MM:SS.
| v19
|-
|-
| <code>ListItem.Property(Role.DJMixer)</code>
| <code>ListItem.Property(Album_Label)</code>
|  Returns the name of the dj who remixed the selected song
'''Returns'''
:The record label of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Role.Engineer)</code>
| <code>ListItem.Property(Album_Mood)</code>
|  Returns the name of the person who was the engineer of the selected song
'''Returns'''
:The moods of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Role.Lyricist)</code>
| <code>ListItem.Property(Album_Rating)</code>
|  Returns the name of the person who wrote the lyrics of the selected song
'''Returns'''
:The scraped rating of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Role.Mixer)</code>
| <code>ListItem.Property(Album_Style)</code>
|  Returns the name of the person who mixed the selected song
'''Returns'''
:The styles of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Role.Orchestra)</code>
| <code>ListItem.Property(Album_Theme)</code>
|  Returns the name of the orchestra performing the selected song
'''Returns'''
:The themes of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Role.Producer)</code>
| <code>ListItem.Property(Album_Type)</code>
|  Returns the name of the person who produced the selected song
'''Returns'''
:The album type of the currently selected album (e.g. compilation, enhanced, or explicit lyrics).
|
|
|-
|-
| <code>ListItem.Property(Role.Remixer)</code>
| <code>ListItem.Property(Album_UserRating)</code>
|  Returns the name of the person who remixed the selected song
'''Returns'''
:The user rating of the currently selected album.
|
|
|-
|-
| <code>ListItem.Property(Artist_Born)</code>
|  '''Returns'''
:The Date of Birth of the currently selected artist.
|
|-
|-
| <code>ListItem.Property(Stream.Bitrate)</code>
| <code>ListItem.Property(Artist_Description)</code>
Shows the video bitrate of the currently playing video
'''Returns'''
| v22
:The biography of the currently selected artist.
|
|-
|-
| <code>ListItem.Property(Stream.Channels)</code>
| <code>ListItem.Property(Artist_Died)</code>
Shows the number of audio channels of the currently playing video
'''Returns'''
| v22
:The Date of Death of the currently selected artist.
|
|-
|-
| <code>ListItem.Property(Stream.Codec)</code>
| <code>ListItem.Property(Artist_Disambiguation)</code>
Shows the video codec of the currently playing video
'''Returns'''
| v22
:The brief description of the currently selected artist that differentiates them from others with the same name.
| v18
|-
|-
| <code>ListItem.Property(Stream.CodecDesc)</code>
| <code>ListItem.Property(Artist_Disbanded)</code>
Shows the audio codec of the currently playing video
'''Returns'''
| v22
:The disbanding date of the currently selected band.
|
|-
|-
| <code>ListItem.Property(Stream.Description)</code>
| <code>ListItem.Property(Artist_Formed)</code>
Shows the audio description of the currently playing video
'''Returns'''
| v22
:The formation date of the currently selected band.
|
|-
|-
| <code>ListItem.Property(Stream.FPS)</code>
| <code>ListItem.Property(Artist_Gender)</code>
Shows the frames per second of the currently playing video
'''Returns'''
| v22
:The gender of the currently selected artist (e.g.male, female, or other).
| v18
|-
|-
| <code>ListItem.Property(Stream.HDRType)</code>
| <code>ListItem.Property(Artist_Genre)</code>
|  Shows the HDR type of the currently playing video (possible values: hdr10, dolbyvision and hlg)
'''Returns'''
|  v22
:The genre of the currently selected artist.
|-
|  <code>ListItem.Property(Stream.Language)</code>
|  Shows the audio language of the currently playing video (returns an ISO 639-2 three character code, e.g. eng, epo, deu)
|  v22
|-
|  <code>ListItem.Property(Stream.Resolution)</code>
|  Shows the video resolution of the currently playing video
|  v22
|-
|  <code>ListItem.Property(Stream.StereoMode)</code>
|  Returns the stereomode of the playing video (i.e. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, anaglyph_green_magenta)
|  v22
|-
|  <code>ListItem.Property(SubtitleLanguage.[n])</code>
|  Shows the subtitle language of the currently selected video, 'n' defines the number of the subtitle (values: see  ListItem.SubtitleLanguage)
|
|
|-
|-
| <code>ListItem.Property(TotalEpisodes)</code>
| <code>ListItem.Property(Artist_Instrument)</code>
Shows the total number of episodes for the currently selected tvshow or season
'''Returns'''
:The instruments played by the currently selected artist.
|
|
|-
|-
| <code>ListItem.Property(TotalSeasons)</code>
| <code>ListItem.Property(Artist_Mood)</code>
Shows the total number of seasons for the currently selected tvshow
'''Returns'''
:The moods of the currently selected artist.
|
|
|-
|-
| <code>ListItem.Property(UnWatchedEpisodes)</code>
| <code>ListItem.Property(Artist_Sortname)</code>
Shows the number of unwatched episodes for the currently selected tvshow or season
'''Returns'''
|
:The sortname of the currently selected artist.
| v18
|-
|-
| <code>ListItem.Property(WatchedEpisodes)</code>
| <code>ListItem.Property(Artist_Style)</code>
Shows the number of watched episodes for the currently selected tvshow or season
'''Returns'''
:The styles of the currently selected artist.
|
|
|-
|-
| <code>ListItem.PVRClientName</code>
| <code>ListItem.Property(Artist_Type)</code>
|  Returns the name of the PVR client addon for the selected PVR list item
'''Returns'''
| v22
:The type of the currently selected artist (person, group, orchestra, choir, etc).
| v18
|-
|-
| <code>ListItem.PVRInstanceName</code>
| <code>ListItem.Property(Artist_YearsActive)</code>
|  Returns the name of the instance of the PVR client addon for the selected PVR list item
'''Returns'''
|  v22
:The years the currently selected artist has been active.
|-
|  <code>ListItem.Rating[(name)]</code>
|  Shows the scraped rating of the currently selected item in a container. Optionally you can specify the name of the scraper to retrieve a specific rating, for use in dialogvideoinfo.xml.
|
|
|-
|-
| <code>ListItem.RatingAndVotes[(name)]</code>
| <code>ListItem.Property(AudioChannels.[n])</code>
Shows the IMDB rating and votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve a specific rating and votes, for use in dialogvideoinfo.xml.
'''Returns'''
:The number of audio channels of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioChannels).
|
|
|-
|-
| <code>ListItem.ReleaseDate</code>
| <code>ListItem.Property(AudioCodec.[n])</code>
|  Returns the release date of the current item
'''Returns'''
|  v19
:The audio codec of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioCodec).
|-
|  <code>ListItem.SampleRate</code>
|  Returns the sample rate of a song / 1000.0 (e.g. 44.1, 48, 96 etc)
|  v19
|-
|  <code>ListItem.Season</code>
|  Shows the season value for the currently selected tvshow
|
|
|-
|-
| <code>ListItem.Set</code>
| <code>ListItem.Property(AudioLanguage.[n])</code>
Shows the name of the set the movie is part of
'''Returns'''
:The audio language of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioLanguage).
|
|
|-
|-
| <code>ListItem.SetId</code>
| <code>ListItem.Property(game.stretchmode)</code>
Shows the id of the set the movie is part of
'''Returns'''
|
:The name of the stretch mode (e.g. Stretch 4:3).
| v18
|-
|-
| <code>ListItem.Size</code>
| <code>ListItem.Property(game.videofilter)</code>
Shows the file size of the currently selected song or movie in a container
'''Returns'''
|
:The name of the video filter (e.g. Bilinear).
| v18
|-
|-
| <code>ListItem.SortLetter</code>
| <code>ListItem.Property(game.videorotation)</code>
Shows the first letter of the current file in a container
'''Returns'''
|
:The angle of the rotation.
| v18
|-
|-
| <code>ListItem.StartDate</code>
| <code>ListItem.Property(NumEpisodes)</code>
Start date of current selected TV programme in a container
'''Returns'''
:The number of total, watched, or unwatched episodes for the currently selected TV show or season, based on the the current watched filter.
|
|
|-
|-
| <code>ListItem.StartDate</code>
| <code>ListItem.Property(Role.Arranger)</code>
Start date of the selected item (PVR).
'''Returns'''
:The name of the person who arranged the selected song.
|
|
|-
|-
| <code>ListItem.StartTime</code>
| <code>ListItem.Property(Role.Composer)</code>
Start time of current selected TV programme in a container
'''Returns'''
:The name of the person who composed the selected song.
|
|
|-
|-
| <code>ListItem.StartTime</code>
| <code>ListItem.Property(Role.Conductor)</code>
Start time of the selected item (PVR).
'''Returns'''
:The name of the person who conducted the selected song.
|
|
|-
|-
| <code>ListItem.Status</code>
| <code>ListItem.Property(Role.DJMixer)</code>
For use with tv shows. It can return one of the following: 'returning series','in production','planned','cancelled' or 'ended'
|  '''Returns'''
:The name of the DJ who remixed the selected song.
|
|
|-
|-
| <code>ListItem.StereoscopicMode</code>
| <code>ListItem.Property(Role.Engineer)</code>
|  Returns the stereomode of the selected video (i.e. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, anaglyph_green_magenta)
'''Returns'''
:The name of the person who was the engineer of the selected song.
|
|
|-
|-
| <code>ListItem.Studio</code>
| <code>ListItem.Property(Role.Lyricist)</code>
Studio of current selected Music Video in a container
'''Returns'''
:The name of the person who wrote the lyrics of the selected song.
|
|
|-
|-
| <code>ListItem.SubtitleLanguage</code>
| <code>ListItem.Property(Role.Mixer)</code>
Shows the subtitle language of the currently selected video (returns an ISO 639-2 three character code, e.g. eng, epo, deu)
'''Returns'''
:The name of the person who mixed the selected song.
|
|
|-
|-
| <code>ListItem.Tag</code>
| <code>ListItem.Property(Role.Orchestra)</code>
Will return the name of the 'tag' this movie is part of.
'''Returns'''
:The name of the orchestra performing the selected song.
|
|
|-
|-
| <code>ListItem.Tagline</code>
| <code>ListItem.Property(Role.Producer)</code>
Small Summary of current Video in a container
'''Returns'''
:The name of the person who produced the selected song.
|
|
|-
|-
| <code>ListItem.Title</code>
| <code>ListItem.Property(Role.Remixer)</code>
Shows the title of the currently selected song or movie in a container
'''Returns'''
:The name of the person who remixed the selected song.
|
|
|-
|-
| <code>ListItem.Top250</code>
| <code>ListItem.Property(Stream.Bitrate)</code>
Shows the IMDb top250 position of the currently selected  ListItem in a container.
'''Returns'''
|
:The video bitrate (kbps) of the currently playing video.
| v22
|-
|-
| <code>ListItem.TotalDiscs</code>
| <code>ListItem.Property(Stream.Channels)</code>
|  The total amount of discs belonging to an album
'''Returns'''
| v19
:The number of audio channels of the currently playing video.
| v22
|-
|-
| <code>ListItem.TrackNumber</code>
| <code>ListItem.Property(Stream.Codec)</code>
Shows the track number of the currently selected song in a container
'''Returns'''
|
:The audio, video, or subtitle codec of the currently playing video.
| v22
|-
|-
|  <code>ListItem.Trailer</code>
| <code>ListItem.Property(Stream.CodecDesc)</code>
Shows the full trailer path with filename of the currently selected movie in a container
|  '''Returns'''
|
:The audio description of the currently playing video.
| v22
|-
| <code>ListItem.Property(Stream.Description)</code>
'''Returns'''
:The audio, video, or subtitle title/name of the currently playing video.
| v22
|-
| <code>ListItem.Property(Stream.FPS)</code>
'''Returns'''
:The Frames per Second of the currently playing video.
| v22
|-
| <code>ListItem.Property(Stream.HDRType)</code>
|  '''Returns'''
:The HDR type of the currently playing video (e.g. hdr10, dolbyvision, or hlg).
| v22
|-
|-
| <code>ListItem.TvShowDBID</code>
| <code>ListItem.Property(Stream.Language)</code>
|  Returns the tv show DBID of the selected season or episode a container
'''Returns'''
| v19
:The audio language of the currently playing video as an ISO 639-2 three character code (e.g. eng, epo, deu, etc).
| v22
|-
|-
| <code>ListItem.TVShowTitle</code>
| <code>ListItem.Property(Stream.Resolution)</code>
Shows the name value for the currently selected tvshow in the season and episode depth of the video library
'''Returns'''
|
:The video resolution of the currently playing video.
| v22
|-
|-
| <code>ListItem.UniqueID()</code>
| <code>ListItem.Property(Stream.StereoMode)</code>
|  Returns the UniqueID of the selected item in a container
'''Returns'''
| v19
:The 3D stereo mode of the playing video (e.g. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, or anaglyph_green_magenta).
| v22
|-
|-
| <code>ListItem.UserRating</code>
| <code>ListItem.Property(SubtitleLanguage.[n])</code>
Shows the user rating of the currently selected item in a container
'''Returns'''
:The subtitle language of the currently selected stream, 'n' defines the number of the subtitle (values: see ListItem.SubtitleLanguage).
|
|
|-
|-
| <code>ListItem.VideoAspect</code>
| <code>ListItem.Property(TotalEpisodes)</code>
Shows the aspect ratio of the currently selected video (possible values: 1.33, 1.37, 1.66, 1.78, 1.85, 2.20, 2.35, 2.40, 2.55, 2.76, Note: Kodi v20: 1.00, 1.19, 2.00 )
'''Returns'''
:The total number of episodes for the currently selected TV show or season.
|
|
|-
|-
| <code>ListItem.VideoCodec</code>
| <code>ListItem.Property(TotalSeasons)</code>
Shows the video codec of the currently selected video (possible values: 3iv2, av1, avc1, div2, div3, divx 4, divx, dx50, flv, h264, hev1, hevc, hvc1, microsoft, mp42, mp43, mp4v, mpeg1, mpeg1video, mpeg2, mpeg2video, mpeg4, mpg4, rv40, svq1, svq3, theora, vc-1, vc1, vp6f, vp8, vp9, wmv, wmv2, wmv3, wvc1, xvid)
'''Returns'''
:The total number of seasons for the currently selected TV show.
|
|
|-
|-
| <code>ListItem.VideoResolution</code>
| <code>ListItem.Property(UnWatchedEpisodes)</code>
Shows the resolution of the currently selected video (possible values: 480, 576, 540, 720, 1080, 4K, 8K [Note: v18 addition]). Note that 540 usually means a widescreen format (around 960x540) while 576 means PAL resolutions (normally 720x576), therefore 540 is actually better resolution than 576.
'''Returns'''
| v18
:The number of unwatched episodes for the currently selected TV show or season.
|
|-
|-
| <code>ListItem.VideoVersionName</code>
| <code>ListItem.Property(WatchedEpisodes)</code>
|  Shows the name of the video version.
'''Returns'''
|  v21
:The number of watched episodes for the currently selected TV show or season.
|-
<code>ListItem.Votes[(name)]</code>
Shows the IMDB votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve specific votes, for use in dialogvideoinfo.xml.
|
|
|-
|-
|  <code>ListItem.Writer</code>
|  <code>ListItem.Publisher</code>
Name of Writer of current Video in a container
'''Returns'''
:The game publisher (e.g. "Nintendo") (RETROPLAYER).
|
|
|-
|-
| <code>ListItem.Year</code>
| <code>ListItem.PVRClientName</code>
Shows the year of the currently selected song, album or movie in a container
'''Returns'''
|}
:The name of the PVR client addon for the selected PVR list item.
 
| v22
=== Musicpartymode labels ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Definition
! Version
|-
|-
|  <code>MusicPartyMode.SongsPlayed</code>
|  <code>ListItem.PVRGroupOrigin</code>
Number of songs played during Party Mode
'''Returns'''
:If selected item is of type PVR channel group, the creator (user, system, client) of the group.
|
|
|-
|-
| <code>MusicPartyMode.MatchingSongs</code>
| <code>ListItem.PVRInstanceName</code>
Number of songs available to Party Mode
'''Returns'''
|
:The name of the instance of the PVR client addon for the selected PVR list item.
| v22
|-
|-
| <code>MusicPartyMode.MatchingSongsPicked</code>
| <code>ListItem.Rating[(name)]</code>
Number of songs picked already for Party Mode
'''Returns'''
:The scraped rating of the currently selected item in a container. Optionally you can specify the name of the scraper to retrieve a specific rating, for use in dialogvideoinfo.xml.
|
|
|-
|-
| <code>MusicPartyMode.MatchingSongsLeft</code>
| <code>ListItem.RatingAndVotes[(name)]</code>
Number of songs left to be picked from for Party Mode
'''Returns'''
:The IMDB rating and votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve a specific rating and votes, for use in dialogvideoinfo.xml.
|
|
|-
|-
|  <code>MusicPartyMode.RelaxedSongsPicked</code>
| <code>ListItem.ReleaseDate</code>
Not currently used
|  '''Returns'''
:The release date of the current item.
| v19
|-
| <code>ListItem.SampleRate</code>
'''Returns'''
:The sample rate of a song / 1000.0 (e.g. 44.1, 48, 96 etc).
| v19
|-
| <code>ListItem.Season</code>
'''Returns'''
:The season value for the currently selected TV show.
|
|
|-
|-
| <code>MusicPartyMode.RandomSongsPicked</code>
| <code>ListItem.Set</code>
Number of unique random songs picked during Party Mode
'''Returns'''
:The name of the set the movie is part of.
|
|
|}
=== Network labels ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|-
| <code>Network.IsDHCP</code>
| <code>ListItem.SetId</code>
Network type is DHCP or FIXED
'''Returns'''
:The id of the set the movie is part of.
|
|
|-
|-
| <code>Network.IPAddress</code>
| <code>ListItem.Size</code>
|  The system's IP Address (<ipaddress> is returned as a string)
'''Returns'''
:The file size of the currently selected song or movie in a container.
|
|
|-
|-
|  <code>Network.LinkState</code>
|  <code>ListItem.SongVideoURL</code>
Network linkstate (e.g. 10mbit/100mbit etc).
'''Returns'''
:Link to a video of a song
|
|
|-
|-
| <code>Network.MacAddress</code>
| <code>ListItem.SortLetter</code>
|  The system's  mac address
'''Returns'''
:The first letter of the current file in a container.
|
|
|-
|-
| <code>Network.SubnetMask</code>
| <code>ListItem.StartDate</code>
Network subnet mask
'''Returns'''
:The start date of current selected TV programme in a container.
|
|
|-
|-
| <code>Network.GatewayAddress</code>
| <code>ListItem.StartDate</code>
Network gateway address
'''Returns'''
:The start date of the selected item (PVR).
|
|
|-
|-
| <code>Network.DNS1Address</code>
| <code>ListItem.StartTime</code>
Network dns server 1 address
'''Returns'''
:The start time of current selected TV programme in a container.
|
|
|-
|-
| <code>Network.DNS2Address</code>
| <code>ListItem.StartTime</code>
Network dns server 2 address
'''Returns'''
:The start time of the selected item (PVR).
|
|
|-
|-
| <code>Network.DHCPAddress</code>
| <code>ListItem.Status</code>
DHCP server ip address
'''Returns'''
:The status of the selected TV show (e.g. 'returning series','in production','planned','cancelled' or 'ended').
|
|
|}
|-
 
| <code>ListItem.StereoscopicMode</code>
=== Player labels ===
'''Returns'''
 
:The stereomode of the selected video (ie.g. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, or anaglyph_green_magenta).
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
| <code>Player.FinishTime</code>
Time playing media will end
|
|
|-
|-
| <code>Player.FinishTime(format)</code>
| <code>ListItem.Studio</code>
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
:The studio of current selected music video in a container.
|
|
|-
|-
| <code>Player.Chapter</code>
| <code>ListItem.SubtitleLanguage</code>
Current chapter of current playing media
'''Returns'''
:The subtitle language of the currently selected video as an ISO 639-2 three character code (e.g. eng, epo, deu).
|
|
|-
|-
| <code>Player.ChapterCount</code>
| <code>ListItem.Tag</code>
Total number of chapters of current playing media
'''Returns'''
:The name of the 'tag' this movie is part of.
|
|
|-
|-
| <code>Player.Time</code>
| <code>ListItem.Tagline</code>
Elapsed time of current playing media
'''Returns'''
:The small summary of current video in a container.
|
|
|-
|-
|  <code>Player.Time(format)</code>
|  <code>ListItem.TimerType</code>
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
:The type of the PVR timer / timer rule item as a human readable string.
|
|
|-
|-
| <code>Player.TimeRemaining</code>
| <code>ListItem.Title</code>
Remaining time of current playing media
'''Returns'''
:The title of the currently selected song or movie in a container.
|
|
|-
|-
|  <code>Player.TimeRemaining(format)</code>
|  <code>ListItem.TitleExtraInfo</code>
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
:string containing extra information, enriching the title of the item.
|
|
|-
|-
| <code>Player.Duration</code>
| <code>ListItem.Top250</code>
Total duration of the current playing media
'''Returns'''
:The IMDB top 250 position of the currently selected ListItem in a container.
|
|
|-
|-
| <code>Player.Duration(format)</code>
| <code>ListItem.TotalDiscs</code>
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
|
:The total amount of discs belonging to an album.
| v19
|-
|-
| <code>Player.SeekTime</code>
| <code>ListItem.TrackNumber</code>
Time to which the user is seeking
'''Returns'''
:The track number of the currently selected song in a container.
|
|
|-
|-
| <code>Player.SeekBar</code>
| <code>ListItem.Trailer</code>
Time to which the user is seeking as a percentage (for use in slider controls)
'''Returns'''
:The full trailer path with filename of the currently selected movie in a container.
|
|
|-
|-
| <code>Player.SeekOffset</code>
| <code>ListItem.TVShowDBID</code>
Indicates the seek offset after a seek press (e.g. user presses BigStepForward, player.seekoffset returns +10:00)
'''Returns'''
|
:The TV show DBID of the selected season or episode a container.
| v19
|-
|-
| <code>Player.SeekOffset(format)</code>
| <code>ListItem.TVShowTitle</code>
Shows hours (hh), minutes (mm) or seconds (ss). Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
:The name value for the currently selected TV show in the season and episode depth of the video library.
|
|
|-
|-
| <code>Player.SeekStepSize</code>
| <code>ListItem.UniqueID()</code>
Displays the seek step size. (v15 addition)
'''Returns'''
|
:The UniqueID of the selected item in a container.
| v19
|-
|-
| <code>Player.Progress</code>
| <code>ListItem.UserRating</code>
Shows how much (percentage) of the file has been played
'''Returns'''
:The user rating of the currently selected item in a container.
|
|
|-
|-
| <code>Player.ProgressCache</code>
| <code>ListItem.VideoAspect</code>
Shows how much of the file is cached above current play percentage
'''Returns'''
|
:The aspect ratio of the currently selected video.<br>
:Possible values:
:*1.00*
:*1.19*
:*1.33
:*1.37
:*1.66
:*1.78
:*1.85
:*2.00*
:*2.20
:*2.35
:*2.40
:*2.55
:*2.76
| *v20
|-
|-
| <code>Player.Folderpath</code>
| <code>ListItem.VideoCodec</code>
Shows the full path of the currently playing song or movie. (supports .offset() and .position())
'''Returns'''
:The video codec of the currently selected video.<br>
:Possible values:
:*3iv2
:*av1
:*avc1
:*div2
:*div3
:*divx
:*divx 4
:*dx50
:*flv
:*h264
:*hev1
:*hevc
:*hvc1
:*microsoft
:*mp42
:*mp43
:*mp4v
:*mpeg1
:*mpeg1video
:*mpeg2
:*mpeg2video
:*mpeg4
:*mpg4
:*rv40
:*svq1
:*svq3
:*theora
:*vc-1
:*vc1
:*vp6f
:*vp8
:*vp9
:*wmv
:*wmv2
:*wmv3
:*wvc1
:*xvid
|
|
|-
|-
|  <code>Player.Filenameandpath</code>
|  <code>ListItem.VideoHeight</code>
Shows the full path with filename of the currently playing song or movie. (supports .offset() and .position())
'''Returns'''
:String containing height of video in pixels - empty if unknown.
|
|
|-
|-
| <code>Player.StartTime</code>
| <code>ListItem.VideoResolution</code>
|  Returns the starttime (from the epg) of a tv program, for all other videos it will return the time you started watching this video.
'''Returns'''
:The resolution of the currently selected video.<br>
:Possible values:
:*480
:*576
:*540
:*720
:*1080
:*4K
:*8K*
{{highlight|'''Note'''<br>
That 540 usually means a widescreen format (around 960x540) while 576 means PAL resolutions (normally 720x576), therefore 540 is actually better resolution than 576.}}
| *v18
|-
| <code>ListItem.VideoVersionName</code>
|  '''Returns'''
:The name of the video version.
| v21
|-
|  <code>ListItem.VideoWidth</code>
|  '''Returns'''
:String containing width of video in pixels - empty if unknown.
|
|
|-
|-
| <code>Player.StartTime(format)</code>
| <code>ListItem.Votes[(name)]</code>
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
'''Returns'''
:The IMDB votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve specific votes, for use in dialogvideoinfo.xml.
|
|
|-
|-
| <code>Player.Title</code>
| <code>ListItem.Writer</code>
|  Returns the musicplayer title for audio and the videoplayer title for videos. (supports .offset() and .position())
'''Returns'''
:The name of Writer of current video in a container.
|
|
|-
|-
|  <code>Player.Filename</code>
|  <code>ListItem.Writer(separator)</code>
|  Returns the filename of the currently playing media. (supports .offset() and .position())
'''Returns'''
|
:A list of writers, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
| <code>Player.Volume</code>
| <code>ListItem.Year</code>
|  Returns the volume level in dB
'''Returns'''
|
:The year of the currently selected song, album, or movie in a container.
|}
 
=== MusicPartyMode ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>Player.PlaySpeed</code>
|  <code>MusicPartyMode.MatchingSongs</code>
Current playspeed. (range:0.8 to 1.5)
'''Returns'''
:The number of songs available to Party Mode.
|
|
|-
|-
|  <code>Player.Process(AudioBitsPerSample)</code>
|  <code>MusicPartyMode.MatchingSongsLeft</code>
Bits per sample of the currently playing item
'''Returns'''
:The number of songs left to be picked from for Party Mode.
|
|
|-
|-
|  <code>Player.Process(AudioChannels)</code>
|  <code>MusicPartyMode.MatchingSongsPicked</code>
Number of audiochannels of the currently playing item
'''Returns'''
:The number of songs picked already for Party Mode.
|
|
|-
|-
|  <code>Player.Process(AudioDecoder)</code>
|  <code>MusicPartyMode.RandomSongsPicked</code>
Audiodecoder name of the currently playing item
'''Returns'''
:The number of unique random songs picked during Party Mode.
|
|
|-
|-
|  <code>Player.Process(AudioSamplerate)</code>
|  <code>MusicPartyMode.RelaxedSongsPicked</code>
Samplerate  f the currently playing item
'''Returns'''
:The number of relaxed songs picked during Party Mode.
|
|
|-
|-
|  <code>Player.Process(DeintMethod)</code>
|  <code>MusicPartyMode.SongsPlayed</code>
Deinterlace method of the currently playing video
'''Returns'''
:The number of songs played during Party Mode.
|
|
|}
=== Network ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>Player.Process(PixFormat)</code>
|  <code>Network.DHCPAddress</code>
Pixel format of the currently playing video
'''Returns'''
:The DHCP server ip address.
|
|
|-
|-
|  <code>Player.Process(VideoDAR)</code>
|  <code>Network.DNS1Address</code>
Display aspect ratio of the currently playing video
'''Returns'''
:The network dns server 1 address.
|
|
|-
|-
|  <code>Player.Process(VideoFPS)</code>
|  <code>Network.DNS2Address</code>
Video framerate of the currently playing video
'''Returns'''
:The network dns server 2 address.
|
|
|-
|-
|  <code>Player.Process(VideoHeight)</code>
|  <code>Network.GatewayAddress</code>
Height of the currently playing video
'''Returns'''
:The network gateway address.
|
|
|-
|-
|  <code>Player.Process(VideoDecoder)</code>
|  <code>Network.IPAddress</code>
Videodecoder name of the currently playing video
'''Returns'''
:The system's IP Address. e.g. 192.168.1.15
|
|
|-
|-
|  <code>Player.Process(VideoWidth)</code>
|  <code>Network.LinkState</code>
Width of the currently playing video
'''Returns'''
:The network linkstate (e.g. 10mbit/100mbit etc).
|
|
|-
|-
|  <code>Player.Process(VideoScanType)</code>
|  <code>Network.MacAddress</code>
The scan type identifier of the currently playing video '''p''' (for progressive) or '''i''' (for interlaced)
|  '''Returns'''
| v20
:The system's  mac address.
|
|-
|-
|  <code>Player.CutList</code>
|  <code>Network.SubnetMask</code>
this infolabel can be used with the [[Ranges Control]], as EDL and chapter markers
'''Returns'''
|  v19
:The network subnet mask.
|-
|
|  <code>Player.Chapters</code>
| this infolabel can be used with the [[Ranges Control]], as EDL and chapter markers
|  v19
|}
|}


==== Music player ====
=== Player ===


{|  class="wikitable sortable" width="100%"
{|  class="wikitable sortable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>MusicPlayer.ParentalRatingCode</code>
|  <code>Player.AudioDelay</code>
Shows the parental rating code
'''Returns'''
| v22
:The used audio delay with the format <code>%2.3f</code> s
|
|-
|-
|  <code>MusicPlayer.ParentalRatingIcon</code>
|  <code>Player.Bookmarks</code>
Shows the parental rating icon
'''Returns'''
| v22
:The bookmarks of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
|
|-
|-
|  <code>MusicPlayer.ParentalRatingSource</code>
|  <code>Player.CacheLevel</code>
Shows the parental rating source
'''Returns'''
| v22
:The used cache level as a string with an integer number.
|
|-
|-
|  <code>MusicPlayer.ChannelLogo</code>
|  <code>Player.ChapterName</code>
Shows the logo of the currently selected radio or TV channel
'''Returns'''
| v22
:The name of currently used chapter if available.
|
|-
|-
|  <code>MusicPlayer.Title</code>
|  <code>Player.Cuts</code>
Title of the currently playing song, also available are "MusicPlayer.offset(number).Title" offset is relative to the current playing item and "MusicPlayer.Position(number).Title" position is relative to the start of the playlist
'''Returns'''
:The EDL cut markers of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
|
|
|-
|-
|  <code>MusicPlayer.Album</code>
|  <code>Player.Editlist</code>
Album from which the current song is from,   also available are "MusicPlayer.offset(number).Album" offset is relative to the current playing item and "MusicPlayer.Position(number).Album" position is relative to the start of the playlist
'''Returns'''
:The editlist of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
{{highlight|'''Note'''<br>This infolabel does not contain EDL cuts. Edits start and end times are adjusted according to cuts defined for the media item.}}
|
|
|-
|-
|  <code>MusicPlayer.Property(Album_Mood)</code>
|  <code>Player.offset(number).Filename</code>
Shows the moods of the currently playing Album
'''Returns'''
:The filename of audio or video file which has an offset <code>number</code> with respect to the currently playing item.
|
|
|-
|-
|  <code>MusicPlayer.Property(Album_Style)</code>
|  <code>Player.offset(number).FilenameAndPath</code>
Shows the styles of the currently playing Album
'''Returns'''
:The full path with filename of audio or video file which has an offset <code>number</code> with respect to the currently playing item.
|
|
|-
|-
|  <code>MusicPlayer.Property(Album_Theme)</code>
|  <code>Player.offset(number).Folderpath</code>
Shows the themes of the currently playing Album
'''Returns'''
:The full path of the audio or video file which has an offset <code>number</code> with respect to the currently playing item.
|
|
|-
|-
|  <code>MusicPlayer.Property(Album_Type)</code>
|  <code>Player.offset(number).Title</code>
Shows the Album Type (e.g. compilation, enhanced, explicit lyrics) of the currently playing Album
'''Returns'''
:The title of audio or video which has an offset <code>number</code> with respect to the currently playing item.
|
|
|-
|-
|  <code>MusicPlayer.Property(Album_Label)</code>
|  <code>Player.position(number).Filename</code>
Shows the record label of the currently playing Album
'''Returns'''
:The filename of the audio or video file which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>MusicPlayer.Property(Album_Description)</code>
|  <code>Player.position(number).FilenameAndPath</code>
Shows a review of the currently playing Album
'''Returns'''
:The full path with filename of the audio or video file which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>MusicPlayer.Artist</code>
|  <code>Player.position(number).Folderpath</code>
Artist(s) of current song,  also available are "MusicPlayer.offset(number).Artist" offset is relative to the current playing item and "MusicPlayer.Position(number).Artist" position is relative to the start of the playlist
'''Returns'''
:The full path of the audio or video file which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Born)</code>
|  <code>Player.position(number).Title</code>
Date of Birth of the currently playing Artist
'''Returns'''
:The title of the audio or video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Died)</code>
|  <code>Player.SceneMarkers</code>
Date of Death of the currently playing Artist
'''Returns'''
:The EDL scene markers of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Formed)</code>
|  <code>Player.SeekNumeric([format])</code>
Formation date of the currently playing Artist/Band
'''Returns'''
:The time at which the playing media began (in a specified format).
'''Parameters'''
:format [opt] The format of the return time value. See TIME_FORMAT for the list of possible values.
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Disbanded)</code>
|  <code>Player.SubtitleDelay</code>
Disbanding date of the currently playing Artist/Band
'''Returns'''
:The used subtitle delay with the format <code>%2.3f</code> s
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_YearsActive)</code>
|  <code>Player.TimeSpeed</code>
Years the currently Playing artist has been active
'''Returns'''
:The time and the playspeed formatted: "1:23 (2x)".
|
|
|}
=== Player labels ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>MusicPlayer.Property(Artist_Instrument)</code>
|  <code>Player.Chapter</code>
Instruments played by the currently playing artist
Current chapter of current playing media
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Description)</code>
|  <code>Player.ChapterCount</code>
Shows a biography of the currently playing artist
Total number of chapters of current playing media
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Mood)</code>
|  <code>Player.Chapters</code>
Shows the moods of the currently playing artist
this infolabel can be used with the [[Ranges Control]], as EDL and chapter markers
|
| v19
|-
|-
|  <code>MusicPlayer.Property(Artist_Style)</code>
|  <code>Player.CutList</code>
Shows the styles of the currently playing artist
this infolabel can be used with the [[Ranges Control]], as EDL and chapter markers
|  v19
|-
|  <code>Player.Duration</code>
|  Total duration of the current playing media
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Genre)</code>
|  <code>Player.Duration(format)</code>
|  Shows the genre of the currently playing artist
|  Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Sortname)</code>
|  <code>Player.Filename</code>
Sortname of the currently playing Artist
Returns the filename of the currently playing media. (supports .offset() and .position())
| v18
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Type)</code>
|  <code>Player.Filenameandpath</code>
Type of the currently playing Artist - person, group, orchestra, choir, etc.
Shows the full path with filename of the currently playing song or movie. (supports .offset() and .position())
| v18
|
|-
|-
|  <code>MusicPlayer.Property(Artist_Gender)</code>
|  <code>Player.FinishTime</code>
Gender of the currently playing Artist - male, female, other
Time playing media will end
|  v18
|-
|  <code>MusicPlayer.Property(Artist_Disambiguation)</code>
|  Brief description of the currently playing Artist that differentiates them from others with the same name
|  v18
|-
|  <code>MusicPlayer.Genre</code>
|  Genre(s) of current song,  also available are "MusicPlayer.offset(number).Genre" offset is relative to the current playing item and "MusicPlayer.Position(number).Genre" position is relative to the start of the playlist
|
|
|-
|-
|  <code>MusicPlayer.Lyrics</code>
|  <code>Player.FinishTime(format)</code>
Lyrics of current song stored in ID tag info
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
|  <code>MusicPlayer.Year</code>
|  <code>Player.Folderpath</code>
Year of release of current song,  also available are "MusicPlayer.offset(number).Year" offset is relative to the current playing item and "MusicPlayer.Position(number).Year" position is relative to the start of the playlist
Shows the full path of the currently playing song or movie. (supports .offset() and .position())
|
|
|-
|-
|  <code>MusicPlayer.Rating</code>
|  <code>Player.PlaySpeed</code>
Numeric Rating of current song,  also available are "MusicPlayer.offset(number).Rating" offset is relative to the current playing item and "MusicPlayer.Position(number).Rating" position is relative to the start of the playlist
Current playspeed. (range:0.8 to 1.5)
|
|
|-
|-
|  <code>MusicPlayer.DiscNumber</code>
|  <code>Player.Process(AudioBitsPerSample)</code>
Disc Number of current song stored in ID tag info,  also available are "MusicPlayer.offset(number).DiscNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).DiscNumber" position is relative to the start of the playlist
Bits per sample of the currently playing item
|
|
|-
|-
|  <code>MusicPlayer.Comment</code>
|  <code>Player.Process(AudioChannels)</code>
Comment of current song stored in ID tag info,  also available are "MusicPlayer.offset(number).Comment" offset is relative to the current playing item and "MusicPlayer.Position(number).Comment" position is relative to the start of the playlist
List of audio channels of the currently playing item (e.g. FL+FR)
|
|
|-
|-
|  <code>MusicPlayer.Time</code>
|  <code>Player.Process(AudioDecoder)</code>
Current time in song
Audiodecoder name of the currently playing item
|
|
|-
|-
|  <code>MusicPlayer.TimeRemaining</code>
|  <code>Player.Process(AudioSamplerate)</code>
Current remaining time in song
Samplerate  f the currently playing item
|
|
|-
|-
|  <code>MusicPlayer.TimeSpeed</code>
|  <code>Player.Process(DeintMethod)</code>
Both the time and the playspeed formatted up. e.g. 1:23 (2x)
Deinterlace method of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.TrackNumber</code>
|  <code>Player.Process(PixFormat)</code>
Track number of current song,  also available are "MusicPlayer.offset(number).TrackNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).TrackNumber" position is relative to the start of the playlist
Pixel format of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.Duration</code>
|  <code>Player.Process(VideoDAR)</code>
Duration of current song,  also available are "MusicPlayer.offset(number).Duration" offset is relative to the current playing item and "MusicPlayer.Position(number).Duration" position is relative to the start of the playlist
Display aspect ratio of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.BitRate</code>
|  <code>Player.Process(VideoDecoder)</code>
Bitrate of current song
Videodecoder name of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.Channels</code>
|  <code>Player.Process(VideoFPS)</code>
Number of channels of current song
Video framerate of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.BitsPerSample</code>
|  <code>Player.Process(VideoHeight)</code>
Number of bits per sample of current song
Height of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.SampleRate</code>
|  <code>Player.Process(VideoScanType)</code>
Samplerate of current song
The scan type identifier of the currently playing video '''p''' (for progressive) or '''i''' (for interlaced)
|  v20
|-
|  <code>Player.Process(VideoWidth)</code>
|  Width of the currently playing video
|
|
|-
|-
|  <code>MusicPlayer.Codec</code>
|  <code>Player.Progress</code>
Codec of current song
Shows how much (percentage) of the file has been played
|
|
|-
|-
|  <code>MusicPlayer.PlaylistPosition</code>
|  <code>Player.ProgressCache</code>
Position of the current song in the current music playlist
Shows how much of the file is cached above current play percentage
|
|
|-
|-
|  <code>MusicPlayer.PlaylistLength</code>
|  <code>Player.SeekBar</code>
Total size of the current music playlist
Time to which the user is seeking as a percentage (for use in slider controls)
|
|
|-
|-
|  <code>MusicPlayer.ChannelName</code>
|  <code>Player.SeekOffset</code>
Channel name of the radio programme that's currently playing (PVR).
Indicates the seek offset after a seek press (e.g. user presses BigStepForward, player.seekoffset returns +10:00)
|
|
|-
|-
|  <code>MusicPlayer.ChannelNumberLabel</code>
|  <code>Player.SeekOffset(format)</code>
Channel and subchannel number of the radio channel that's currently playing (PVR).
Shows hours (hh), minutes (mm) or seconds (ss). Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
|  <code>MusicPlayer.ChannelGroup</code>
|  <code>Player.SeekStepSize</code>
Channel group of  of the radio programme that's currently playing (PVR).
Displays the seek step size. (v15 addition)
|
|
|-
|-
|  <code>MusicPlayer.Contributors</code>
|  <code>Player.SeekTime</code>
List of all people who've contributed to the currently playing song
Time to which the user is seeking
|
|
|-
|-
|  <code>MusicPlayer.ContributorAndRole</code>
|  <code>Player.StartTime</code>
List of all people and their role who've contributed to the currently playing song
Returns the starttime (from the epg) of a tv program, for all other videos it will return the time you started watching this video.
|
|
|-
|-
|  <code>MusicPlayer.Mood</code>
|  <code>Player.StartTime(format)</code>
Mood of the currently playing song
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Arranger)</code>
|  <code>Player.Time</code>
Returns the name of the person who arranged the selected song
Elapsed time of current playing media
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Composer)</code>
|  <code>Player.Time(format)</code>
Returns the name of the person who composed the selected song
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Conductor)</code>
|  <code>Player.TimeRemaining</code>
Returns the name of the person who conducted the selected song
Remaining time of current playing media
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.DJMixer)</code>
|  <code>Player.TimeRemaining(format)</code>
Returns the name of the dj who remixed the selected song
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Engineer)</code>
|  <code>Player.Title</code>
|  Returns the name of the person who was the engineer of the selected song
|  Returns the musicplayer title for audio and the videoplayer title for videos. (supports .offset() and .position())
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Lyricist)</code>
|  <code>Player.Volume</code>
|  Returns the name of the person who wrote the lyrics of the selected song
|  Returns the volume level in dB
|
|
|}
==== Music player ====
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>MusicPlayer.Property(Role.Mixer)</code>
|  <code>MusicPlayer.AlbumArtist</code>
|  Returns the name of the person who mixed the selected song
'''Returns'''
:The album artist of the currently playing song.
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Orchestra)</code>
|  <code>MusicPlayer.LastPlayed</code>
|  Returns the name of the orchestra performing the selected song
'''Returns'''
:The last play date of currently playing song, if it's in the database.
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Producer)</code>
|  <code>MusicPlayer.MediaProviders</code>
|  Returns the name of the person who produced the selected song
'''Returns'''
:string containing the names of the providers of the currently playing media, separated by commas if multiple are present.
|
|
|-
|-
|  <code>MusicPlayer.Property(Role.Remixer)</code>
|  <code>MusicPlayer.offset(number).Album</code>
|  Returns the name of the person who remixed the selected song
'''Returns'''
:The album from which the song with offset <code>number</code> with respect to the current song is from.
'''Parameters'''
:number - the offset number with respect to the current playing song
|
|
|-
|-
|  <code>MusicPlayer.UserRating</code>
|  <code>MusicPlayer.offset(number).Artist</code>
The rating the user gave to the currently playing song
'''Returns'''
:Artist(s) of the song which has an offset <code>number</code> with respect to the current playing song.
'''Parameters'''
:number - the offset of the song with respect to the current playing song
|
|
|-
|-
|  <code>MusicPlayer.DBID</code>
|  <code>MusicPlayer.offset(number).Comment</code>
|  The database id of the currently playing song
'''Returns'''
v17
:The Comment of current song stored in ID tag info for the song with an offset <code>number</code> with respect to the playing song.
'''Parameters'''
:number - The offset value for the song with respect to the playing song.
|
|-
<code>MusicPlayer.offset(number).DiscNumber</code>
|  '''Returns'''
:The Disc Number of current song stored in ID tag info for the song with an offset <code>number</code> with respect to the playing song.
'''Parameters'''
:number - The offset value for the song with respect to the playing song.
|
|-
|-
|  <code>MusicPlayer.DiscTitle</code>
|  <code>MusicPlayer.offset(number).Duration</code>
|  The title of the disc currently playing
'''Returns'''
| v19
:The duration of the song with an offset <code>number</code> with respect to the current playing song.
'''Parameters'''
:number - the offset number of the song with respect to the current playing song
|
|-
|-
|  <code>MusicPlayer.ReleaseDate</code>
|  <code>MusicPlayer.offset(number).Genre</code>
|  Returns the release date of the song currently playing
'''Returns'''
| v19
:The genre(s) of the song with an offset <code>number</code> with respect to the current playing song.
'''Parameters'''
:number - the offset song number with respect to the current playing song.
|
|-
|-
|  <code>MusicPlayer.OriginalDate</code>
|  <code>MusicPlayer.offset(number).Rating</code>
|  Returns the original release date of the song currently playing
'''Returns'''
| v19
:The numeric Rating of song with an offset <code>number</code> with respect to the current playing song.
'''Parameters'''
:number - the offset with respect to the current playing song
|
|-
|-
|  <code>MusicPlayer.BPM</code>
|  <code>MusicPlayer.offset(number).Title</code>
|  Returns the Beats Per Minute of the currently playing song
'''Returns'''
| v19
:The title of the song which has an offset <code>number</code> with respect to the current playing song.
'''Parameters'''
:number - the offset number with respect to the current playing song
|
|-
|-
|  <code>MusicPlayer.TotalDiscs</code>
|  <code>MusicPlayer.offset(number).TrackNumber</code>
|  Returns the number of discs associated with the album of the currently playing song
'''Returns'''
| v19
:The track number of the song with an offset <code>number</code> with respect to the current playing song.
|}
'''Parameters'''
 
:number - The offset number of the song with respect to the playing song
==== Video player ====
|
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|-
|  <code>VideoPlayer.AudioStreamCount</code>
|  <code>MusicPlayer.offset(number).Year</code>
|  Returns the number of audio streams of the currently playing video
'''Returns'''
| v21
:The year of release of the song with an offset <code>number</code> with respect to the current playing song.
'''Parameters'''
:number - the offset number with respect to the current song.
|
|-
|-
|  <code>VideoPlayer.VideoStreamCount</code>
|  <code>MusicPlayer.ParentalRatingCode</code>
|  Returns the number of video streams of the currently playing video
|  v22
|-
|  <code>VideoPlayer.ParentalRatingCode</code>
|  Shows the parental rating code
|  Shows the parental rating code
|  v22
|  v22
|-
|-
|  <code>VideoPlayer.ParentalRatingIcon</code>
|  <code>MusicPlayer.ParentalRatingIcon</code>
|  Shows the parental rating icon
|  Shows the parental rating icon
|  v22
|  v22
|-
|-
|  <code>VideoPlayer.ParentalRatingSource</code>
|  <code>MusicPlayer.ParentalRatingSource</code>
|  Shows the parental rating source
|  Shows the parental rating source
|  v22
|  v22
|-
|-
|  <code>VideoPlayer.ChannelLogo</code>
|  <code>MusicPlayer.ChannelLogo</code>
|  Shows the logo of the currently selected radio or TV channel
|  Shows the logo of the currently selected radio or TV channel
|  v22
|  v22
|-
|-
|  <code>VideoPlayer.VideoVersionName</code>
|  <code>MusicPlayer.PlayCount</code>
Show the name of the video version
'''Returns'''
|  v21
:The play count of currently playing song, if it's in the database.
|-
|  <code>VideoPlayer.Time</code>
|  Current time in movie
|
|
|-
|-
|  <code>VideoPlayer.TimeRemaining</code>
|  <code>MusicPlayer.Position(number).Album</code>
Current remaining time in movie
'''Returns'''
:The album from which the song with offset <code>number</code> with respect to the start of the playlist is from.
'''Parameters'''
:number - the offset number with respect to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.TimeSpeed</code>
|  <code>MusicPlayer.Position(number).Artist</code>
Current time + playspeed. e.g. 1:23:14 (-4x)
'''Returns'''
:Artist(s) of the song which has an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset of the song with respect to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.Duration</code>
|  <code>MusicPlayer.Position(number).Comment</code>
Length of current movie
'''Returns'''
:The Comment of current song stored in ID tag info for the song with an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - The offset value for the song with respect to the start of the playlist.
|
|
|-
|-
|  <code>VideoPlayer.Title</code>
|  <code>MusicPlayer.Position(number).DiscNumber</code>
Title of currently playing video. If it's in the database it will return the database title, else the filename. (supports .offset() and .position())
'''Returns'''
:The Disc Number of current song stored in ID tag info for the song with an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - The offset value for the song with respect to the start of the playlist.
|
|
|-
|-
|  <code>VideoPlayer.OriginalTitle</code>
|  <code>MusicPlayer.Position(number).Duration</code>
|  The original title of currently playing video. (supports .offset() and .position())
'''Returns'''
:The duration of the song with an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset number of the song with respect to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.TVShowTitle</code>
|  <code>MusicPlayer.Position(number).Genre</code>
Title of currently playing episode's tvshow name. (supports .offset() and .position())
|  '''Returns'''
:The genre(s) of the song with an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset song number with respect to the start of the playlist song.
|
|
|-
|-
|  <code>VideoPlayer.Season</code>
|  <code>MusicPlayer.Position(number).Rating</code>
Season number of the currently playing episode, if it's in the database. (supports .offset() and .position())
'''Returns'''
:The numeric Rating of song with an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset with respect to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.Episode</code>
|  <code>MusicPlayer.Position(number).Title</code>
Episode number of the currently playing episode. (supports .offset() and .position())
'''Returns'''
:The title of the song which as an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset number with respect to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.Genre</code>
|  <code>MusicPlayer.Position(number).TrackNumber</code>
Genre(s) of current movie, if it's in the database. (supports .offset() and .position())
'''Returns'''
:The track number of the song with an offset <code>number</code> with respect to start of the playlist.
'''Parameters'''
:number - The offset number of the song with respect to start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.Director</code>
|  <code>MusicPlayer.Position(number).Year</code>
Director of current movie, if it's in the database. (supports .offset() and .position())
'''Returns'''
:The year of release of the song with an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset number with respect to the start of the playlist.
|
|
|-
|-
|  <code>VideoPlayer.Country</code>
|  <code>MusicPlayer.RatingAndVotes</code>
Production country of current movie, if it's in the database. (supports .offset() and .position())
'''Returns'''
:The scraped rating and votes of currently playing song, if it's in the database.
|
|
|-
|-
|  <code>VideoPlayer.Year</code>
|  <code>MusicPlayer.Station</code>
Year of release of current movie, if it's in the database. (supports .offset() and .position())
'''Returns'''
:The name of the radio station currently playing (if available).
|
|
|-
|-
|  <code>VideoPlayer.Premiered</code>
|  <code>MusicPlayer.Title</code>
The release/aired date of the currently selected episode, show, movie or EPG item. (supports .offset() and .position())
Title of the currently playing song, also available are "MusicPlayer.offset(number).Title" offset is relative to the current playing item and "MusicPlayer.Position(number).Title" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.Rating</code>
|  <code>MusicPlayer.Album</code>
IMDb user rating of current movie, if it's in the database. (supports .offset() and .position())
Album from which the current song is from,   also available are "MusicPlayer.offset(number).Album" offset is relative to the current playing item and "MusicPlayer.Position(number).Album" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.UserRating</code>
|  <code>MusicPlayer.Property(Album_Mood)</code>
|  Shows the user rating of the currently playing item. (supports .offset() and .position())
|  Shows the moods of the currently playing Album
|
|
|-
|-
|  <code>VideoPlayer.Votes</code>
|  <code>MusicPlayer.Property(Album_Style)</code>
IMDb votes of current movie, if it's in the database. (supports .offset() and .position())
Shows the styles of the currently playing Album
|
|
|-
|-
|  <code>VideoPlayer.RatingAndVotes</code>
|  <code>MusicPlayer.Property(Album_Theme)</code>
IMDb user rating and votes of current movie, if it's in the database. (supports .offset() and .position())
Shows the themes of the currently playing Album
|
|
|-
|-
|  <code>VideoPlayer.mpaa</code>
|  <code>MusicPlayer.Property(Album_Type)</code>
MPAA rating of current movie, if it's in the database. (supports .offset() and .position())
Shows the Album Type (e.g. compilation, enhanced, explicit lyrics) of the currently playing Album
|
|
|-
|-
|  <code>VideoPlayer.IMDBNumber</code>
|  <code>MusicPlayer.Property(Album_Label)</code>
The IMDB iD of the current video, if it's in the database. (supports .offset() and .position())
Shows the record label of the currently playing Album
|
|
|-
|-
|  <code>VideoPlayer.EpisodeName</code>
|  <code>MusicPlayer.Property(Album_Description)</code>
(PVR only) The name of the episode if the playing video is a TV Show, if it's in the database
Shows a review of the currently playing Album
|
|
|-
|-
|  <code>VideoPlayer.PlaylistPosition</code>
|  <code>MusicPlayer.Artist</code>
Position of the current song in the current video playlist
Artist(s) of current song,  also available are "MusicPlayer.offset(number).Artist" offset is relative to the current playing item and "MusicPlayer.Position(number).Artist" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.PlaylistLength</code>
|  <code>MusicPlayer.Property(Artist_Born)</code>
Total size of the current video playlist
Date of Birth of the currently playing Artist
|
|
|-
|-
|  <code>VideoPlayer.Cast</code>
|  <code>MusicPlayer.Property(Artist_Died)</code>
A list of cast members, separated by carriage returns, if it's in the database
Date of Death of the currently playing Artist
|
|
|-
|-
|  <code>VideoPlayer.CastAndRole</code>
|  <code>MusicPlayer.Property(Artist_Formed)</code>
A list of cast members and roles, separated by carriage returns. Every cast/role combination is formatted 'cast' as 'role' where 'as' is localised, if it's in the database
Formation date of the currently playing Artist/Band
|
|
|-
|-
|  <code>VideoPlayer.Trailer</code>
|  <code>MusicPlayer.Property(Artist_Disbanded)</code>
The trailer of the current movie. (supports .offset() and .position())
Disbanding date of the currently playing Artist/Band
|
|
|-
|-
|  <code>VideoPlayer.Album</code>
|  <code>MusicPlayer.Property(Artist_YearsActive)</code>
Album from which the current Music Video is from, if it's in the database. (supports .offset() and .position())
Years the currently Playing artist has been active
|
|
|-
|-
|  <code>VideoPlayer.Artist</code>
|  <code>MusicPlayer.Property(Artist_Instrument)</code>
Artist(s) of current Music Video, if it's in the database. (supports .offset() and .position())
Instruments played by the currently playing artist
|
|
|-
|-
|  <code>VideoPlayer.Studio</code>
|  <code>MusicPlayer.Property(Artist_Description)</code>
Studio of current Music Video, if it's in the database. (supports .offset() and .position())
Shows a biography of the currently playing artist
|
|
|-
|-
|  <code>VideoPlayer.Writer</code>
|  <code>MusicPlayer.Property(Artist_Mood)</code>
Name of Writer of current playing Video, if it's in the database. (supports .offset() and .position())
Shows the moods of the currently playing artist
|
|
|-
|-
|  <code>VideoPlayer.Tagline</code>
|  <code>MusicPlayer.Property(Artist_Style)</code>
Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
Shows the styles of the currently playing artist
|
|
|-
|-
|  <code>VideoPlayer.PlotOutline</code>
|  <code>MusicPlayer.Property(Artist_Genre)</code>
Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
Shows the genre of the currently playing artist
|
|
|-
|-
|  <code>VideoPlayer.Plot</code>
|  <code>MusicPlayer.Property(Artist_Sortname)</code>
Complete Text Summary of current playing Video, if it's in the database. (supports .offset() and .position())
Sortname of the currently playing Artist
|
|  v18
|-
|  <code>MusicPlayer.Property(Artist_Type)</code>
|  Type of the currently playing Artist - person, group, orchestra, choir, etc.
| v18
|-
|-
|  <code>VideoPlayer.Top250</code>
|  <code>MusicPlayer.Property(Artist_Gender)</code>
Shows the IMDb top250 position of the current playing Video. (supports .offset() and .position())
Gender of the currently playing Artist - male, female, other
|
| v18
|-
|-
|  <code>VideoPlayer.LastPlayed</code>
|  <code>MusicPlayer.Property(Artist_Disambiguation)</code>
Last play date of current playing Video, if it's in the database. (supports .offset() and .position())
Brief description of the currently playing Artist that differentiates them from others with the same name
|
| v18
|-
|-
|  <code>VideoPlayer.PlayCount</code>
|  <code>MusicPlayer.Genre</code>
Playcount of current playing Video, if it's in the database. (supports .offset() and .position())
Genre(s) of current song, also available are "MusicPlayer.offset(number).Genre" offset is relative to the current playing item and "MusicPlayer.Position(number).Genre" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.HdrType</code>
|  <code>MusicPlayer.Genre(separator)</code>
Shows the HDR type of the currently playing video (possible values: hdr10, dolbyvision and hlg)
'''Returns'''
| v20
: A list of genres of current song, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for music. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>VideoPlayer.VideoCodec</code>
|  <code>MusicPlayer.Lyrics</code>
Shows the video codec of the currently playing video (common values: see ListItem.VideoCodec)
Lyrics of current song stored in ID tag info
|
|
|-
|-
|  <code>VideoPlayer.VideoResolution</code>
|  <code>MusicPlayer.Votes</code>
Shows the video resolution of the currently playing video (possible values: see ListItem.VideoResolution)
'''Returns'''
:The scraped votes of currently playing song, if it's in the database.
|
|
|-
|-
|  <code>VideoPlayer.VideoAspect</code>
|  <code>MusicPlayer.Year</code>
Shows the aspect ratio of the currently playing video (possible values: see ListItem.VideoAspect)
Year of release of current song,  also available are "MusicPlayer.offset(number).Year" offset is relative to the current playing item and "MusicPlayer.Position(number).Year" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.AudioCodec</code>
|  <code>MusicPlayer.Rating</code>
Shows the audio codec of the currently playing video, optionally 'n' defines the number of the audiostream (common values: see ListItem.AudioCodec)
Numeric Rating of current song,  also available are "MusicPlayer.offset(number).Rating" offset is relative to the current playing item and "MusicPlayer.Position(number).Rating" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.AudioChannels</code>
|  <code>MusicPlayer.DiscNumber</code>
Shows the number of audio channels of the currently playing video (possible values: see ListItem.AudioChannels)
Disc Number of current song stored in ID tag info,  also available are "MusicPlayer.offset(number).DiscNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).DiscNumber" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.AudioLanguage</code>
|  <code>MusicPlayer.Comment</code>
Shows the language of the audio of the currently playing video(possible values: see ListItem.AudioLanguage)
Comment of current song stored in ID tag info,  also available are "MusicPlayer.offset(number).Comment" offset is relative to the current playing item and "MusicPlayer.Position(number).Comment" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.SubtitlesLanguage</code>
|  <code>MusicPlayer.Time</code>
Shows the language of the subtitle of the currently playing video (possible values: see ListItem.SubtitlesLanguage)
Current time in song
|
|
|-
|-
|  <code>VideoPlayer.StereoscopicMode</code>
|  <code>MusicPlayer.TimeRemaining</code>
Shows the stereoscopic mode of the currently playing video (possible values: see ListItem.StereoscopicMode)
Current remaining time in song
|
|
|-
|-
|  <code>VideoPlayer.EndTime</code>
|  <code>MusicPlayer.TimeSpeed</code>
End date of the currently playing programme (PVR).
Both the time and the playspeed formatted up. e.g. 1:23 (2x)
|
|
|-
|-
|  <code>VideoPlayer.NextTitle</code>
|  <code>MusicPlayer.TrackNumber</code>
Title of the programme that will be played next (PVR).
Track number of current song,  also available are "MusicPlayer.offset(number).TrackNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).TrackNumber" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.NextGenre</code>
|  <code>MusicPlayer.Duration</code>
Genre of the programme that will be played next (PVR).
Duration of current song,  also available are "MusicPlayer.offset(number).Duration" offset is relative to the current playing item and "MusicPlayer.Position(number).Duration" position is relative to the start of the playlist
|
|
|-
|-
|  <code>VideoPlayer.NextPlot</code>
|  <code>MusicPlayer.BitRate</code>
Plot of the programme that will be played next (PVR).
Bitrate of current song
|
|
|-
|-
|  <code>VideoPlayer.NextPlotOutline</code>
|  <code>MusicPlayer.Channels</code>
Plot outline of the programme that will be played next (PVR).
Number of channels of current song
|
|
|-
|-
|  <code>VideoPlayer.NextStartTime</code>
|  <code>MusicPlayer.BitsPerSample</code>
Start time of the programme that will be played next (PVR).
Number of bits per sample of current song
|
|
|-
|-
|  <code>VideoPlayer.NextEndTime</code>
|  <code>MusicPlayer.SampleRate</code>
End time of the programme that will be played next (PVR).
Samplerate of current song
|
|
|-
|-
|  <code>VideoPlayer.NextDuration</code>
|  <code>MusicPlayer.Codec</code>
Duration of the programme that will be played next (PVR).
Codec of current song
|
|
|-
|-
|  <code>VideoPlayer.ChannelName</code>
|  <code>MusicPlayer.PlaylistPosition</code>
Name of the curently tuned channel (PVR).
Position of the current song in the current music playlist
|
|
|-
|-
|  <code>VideoPlayer.ChannelNumberLabel</code>
|  <code>MusicPlayer.PlaylistLength</code>
Channel and subchannel number of the tv channel that's currently playing (PVR).
Total size of the current music playlist
|
|
|-
|-
|  <code>VideoPlayer.ChannelGroup</code>
|  <code>MusicPlayer.ChannelName</code>
Group of the curently tuned channel (PVR).
Channel name of the radio programme that's currently playing (PVR).
|
|
|-
|-
|  <code>VideoPlayer.ParentalRating</code>
|  <code>MusicPlayer.ChannelNumberLabel</code>
Parental rating of the currently playing programme (PVR).
Channel and subchannel number of the radio channel that's currently playing (PVR).
|
|
|-
|-
|  <code>VideoPlayer.DBID</code>
|  <code>MusicPlayer.ChannelGroup</code>
The database id of the currently playing video. (supports .offset() and .position())
Channel group of  of the radio programme that's currently playing (PVR).
| v17
|
|-
|-
|  <code>VideoPlayer.UniqueID()</code>
|  <code>MusicPlayer.Contributors</code>
Returns the UniqueID of the currently playing video
List of all people who've contributed to the currently playing song
| v19
|
|-
|-
|  <code>VideoPlayer.TvShowDBID</code>
|  <code>MusicPlayer.ContributorAndRole</code>
Returns the tv show DBID of the currently playing episode
List of all people and their role who've contributed to the currently playing song
|  v19
|}
 
=== Playlist ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|  <code>Playlist.Length(media)</code>
|  Total size of the current playlist. optional parameter media is either video or music.
|
|
|-
|-
|  <code>Playlist.Position(media)</code>
|  <code>MusicPlayer.Mood</code>
Position of the current item in the current playlist. optional parameter media is either video or music.
Mood of the currently playing song
|
|
|-
|-
|  <code>Playlist.Random</code>
|  <code>MusicPlayer.Property(Role.Arranger)</code>
|  Returns 'On' or 'Off'
|  Returns the name of the person who arranged the selected song
|
|
|-
|-
|  <code>Playlist.Repeat</code>
|  <code>MusicPlayer.Property(Role.Composer)</code>
|  Returns string ID's 592 (Repeat One), 593 (Repeat All), or 594 (Repeat Off)
|  Returns the name of the person who composed the selected song
|
|
|}
=== PVR ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|-
|  <code>PVR.NowRecordingTitle</code>
|  <code>MusicPlayer.Property(Role.Conductor)</code>
Title of the programme being recorded
Returns the name of the person who conducted the selected song
|
|
|-
|-
|  <code>PVR.NowRecordingDateTime</code>
|  <code>MusicPlayer.Property(Role.DJMixer)</code>
Start date and time of the current recording
Returns the name of the dj who remixed the selected song
|
|
|-
|-
|  <code>PVR.NowRecordingChannel</code>
|  <code>MusicPlayer.Property(Role.Engineer)</code>
Channel number that's being recorded
Returns the name of the person who was the engineer of the selected song
|
|
|-
|-
|  <code>PVR.NextRecordingTitle</code>
|  <code>MusicPlayer.Property(Role.Lyricist)</code>
Title of the next programme that will be recorded
Returns the name of the person who wrote the lyrics of the selected song
|
|
|-
|-
|  <code>PVR.NextRecordingDateTime</code>
|  <code>MusicPlayer.Property(Role.Mixer)</code>
Start date and time of the next recording
Returns the name of the person who mixed the selected song
|
|
|-
|-
|  <code>PVR.NextRecordingChannel</code>
|  <code>MusicPlayer.Property(Role.Orchestra)</code>
Channel name of the next recording
Returns the name of the orchestra performing the selected song
|
|
|-
|-
|  <code>PVR.BackendName</code>
|  <code>MusicPlayer.Property(Role.Producer)</code>
Name of the backend being used
Returns the name of the person who produced the selected song
|
|
|-
|-
|  <code>PVR.BackendVersion</code>
|  <code>MusicPlayer.Property(Role.Remixer)</code>
version of the backend that's being used
Returns the name of the person who remixed the selected song
|
|
|-
|-
|  <code>PVR.BackendHost</code>
|  <code>MusicPlayer.UserRating</code>
Backend hostname
The rating the user gave to the currently playing song
|
|
|-
|-
|  <code>PVR.BackendDiskSpace</code>
|  <code>MusicPlayer.DBID</code>
Available diskspace on the backend
The database id of the currently playing song
|
| v17
|-
|-
|  <code>PVR.BackendChannels</code>
|  <code>MusicPlayer.DiscTitle</code>
Number of available channels the backend provides
The title of the disc currently playing
|
| v19
|-
|-
|  <code>PVR.BackendTimers</code>
|  <code>MusicPlayer.ReleaseDate</code>
Number of timers set for the backend
Returns the release date of the song currently playing
|  v19
|-
|  <code>MusicPlayer.OriginalDate</code>
|  Returns the original release date of the song currently playing
|  v19
|-
|  <code>MusicPlayer.BPM</code>
|  Returns the Beats Per Minute of the currently playing song
|  v19
|-
|  <code>MusicPlayer.TotalDiscs</code>
|  Returns the number of discs associated with the album of the currently playing song
|  v19
|}
 
=== RetroPlayer ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>RetroPlayer.Developer</code>
|  '''Returns'''
:The developer of the currently-playing game (e.g. "Square").
|
|
|-
|-
|  <code>PVR.BackendRecordings</code>
|  <code>RetroPlayer.DiscLabel</code>
Number of recording available on the backend
'''Returns'''
:The human-readable label of the currently inserted disc, or an empty string if no disc is in the tray/floppy drive or the game isn't disc-based.
|
|
|-
|-
|  <code>PVR.BackendDiskspace</code>
|  <code>RetroPlayer.GameClient</code>
Free diskspace available for recordings on the backend
'''Returns'''
:The add-on ID of the game client (a.k.a. emulator) used to play the currently-playing game (e.g. <code>game.libretro.beetle-psx</code> ).
|
|
|-
|-
|  <code>PVR.BackendNumber</code>
|  <code>RetroPlayer.GameClientName</code>
Backend number
'''Returns'''
:The emulator/core name parsed from the game client's add-on name (e.g. <code>bsnes-mercury Performance</code> ).
|
|
|-
|-
|  <code>PVR.ClientCount</code>
|  <code>RetroPlayer.GameClientPlatforms</code>
Number of PVR clients enabled
'''Returns'''
|  v22
:The platform or platform group supported by the game client (e.g. an emulator might report "Nintendo - SNES / SFC / Game Boy / Color").
|-
|  <code>PVR.TotalDiscSpace</code>
|  Total diskspace available for recordings
|
|
|-
|-
|  <code>PVR.NextTimer</code>
|  <code>RetroPlayer.Genres</code>
Next timer date
'''Returns'''
:The genres of the currently-playing game, joined by ", ".
|
|
|-
|-
|  <code>PVR.EpgEventDuration[(format)]</code>
|  <code>RetroPlayer.Overview</code>
|  Returns the duration of the currently played title on TV. See ListItem.Duration for optinional formatting options
'''Returns'''
:The overview/summary of the currently-playing game.
|
|
|-
|-
|  <code>PVR.EpgEventElapsedTime[(format)]</code>
|  <code>RetroPlayer.Platform</code>
|  Returns the time position of the currently played title on TV. See ListItem.Duration for optinional formatting options
'''Returns'''
:The platform of the currently-playing game, or an empty string if the platform is unknown.
|
|
|-
|-
|  <code>PVR.EpgEventRemainingTime[(format)]</code>
|  <code>RetroPlayer.Publisher</code>
|  Returns the remaining time for currently playing epg event. See ListItem.Duration for optinional formatting options
'''Returns'''
|  v18
:The publisher of the currently-playing game (e.g. "Nintendo").
|-
|  <code>PVR.EpgEventFinishTime[(format)]</code>
|  Returns the time the currently playing epg event will end. See ListItem.Duration for optinional formatting options
|  v18
|-
|  <code>PVR.EpgEventSeekTime[(format)]</code>
|  Returns the seek time of the currently playing epg event. See ListItem.Duration for optinional formatting options
|  v18
|-
|  <code>PVR.EpgEventProgress</code>
|  Returns the position of currently played title on TV as integer
|
|
|-
|-
|  <code>PVR.TimeShiftStart[(format)]</code>
|  <code>RetroPlayer.StretchMode</code>
Start position of the timeshift. See ListItem.Duration for optinional formatting options
'''Returns'''
:The stretch mode of the currently-playing game. The following values are possible:
:<code>normal</code> (Show the game normally)
:<code>4:3</code> (Stretch to a 4:3 aspect ratio)
:<code>fullscreen</code> (Stretch to the full viewing area)
:<code>original</code> (Shrink to the original resolution)
|
|
|-
|-
|  <code>PVR.TimeShiftEnd[(format)]</code>
|  <code>RetroPlayer.Title</code>
End position of the timeshift. See ListItem.Duration for optinional formatting options
'''Returns'''
:The title of the currently-playing game.
|
|
|-
|-
|  <code>PVR.TimeShiftCur[(format)]</code>
|  <code>RetroPlayer.VideoFilter</code>
Current position of the timeshift. See ListItem.Duration for optinional formatting options
'''Returns'''
|-
:The video filter of the currently-playing game. The following values are possible:
<code>PVR.TimeShiftOffset[(format)]</code>
:<code>nearest</code> (Nearest neighbor, i.e. pixelate)
|  Current offset of the timeshift. See ListItem.Duration for optinional formatting options
:<code>linear</code> (Bilinear filtering, i.e. smooth blur)
|
|
|-
|-
|  <code>PVR.TimeShiftProgress</code>
|  <code>RetroPlayer.VideoRotation</code>
|  Returns the position of currently timeshifted title on TV as interger
'''Returns'''
:The video rotation of the currently-playing game in degrees counter-clockwise. The following values are possible:
:<code>0</code>
:<code>90</code> (Shown in the GUI as 270 degrees)
:<code>180</code>
:<code>270</code> (Shown in the GUI as 90 degrees)
|
|
|}
==== Video player ====
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>PVR.ActStreamClient</code>
|  <code>VideoPlayer.Art(type)</code>
Stream client name
'''Returns'''
:The art path for the requested arttype and for the currently playing video.
'''Parameters'''
:type - can virtually be anything, refers to the art type keyword in the art map (poster, fanart, banner, thumb, etc)
|
|
|-
|-
|  <code>PVR.ActStreamDevice</code>
|  <code>VideoPlayer.AudioLanguageEx</code>
Stream device name
'''Returns'''
:The English name of the language of the current audio stream of the currently playing item.
|
|
|-
|-
|  <code>PVR.ActStreamStatus</code>
|  <code>VideoPlayer.AudioName</code>
Status of the stream
'''Returns'''
:The name of the active audio stream of the currently playing video.
|
|
|-
|-
|  <code>PVR.ActStreamSignal</code>
|  <code>VideoPlayer.AudioStreamCount</code>
Signal quality of the stream
Returns the number of audio streams of the currently playing video
|  v21
|-
|  <code>VideoPlayer.EpisodePart</code>
|  '''Returns'''
:string containing the number of parts of a single episode - empty if no data provided
:[Infolabel Updated] <code>VideoPlayer.EpisodePart</code> also supports EPG.
|
|
|-
|-
|  <code>PVR.ActStreamSnr</code>
|  <code>VideoPlayer.HdrDetail</code>
Signal to noise ratio of the stream
'''Returns'''
:String containing details for the HDR type (currently only for DV - profile and EL type) or empty if not HDR. Prints eg 5, 7FEL, and compatibility ID for profile 8 eg 8.4.
|
|
|-
|-
|  <code>PVR.ActStreamBer</code>
|  <code>VideoPlayer.MediaProviders</code>
Bit error rate of the stream
'''Returns'''
:string containing the names of the providers of the currently playing media, separated by commas if multiple are present.
|
|
|-
|-
|  <code>PVR.ActStreamUnc</code>
|  <code>VideoPlayer.offset(number).Album</code>
UNC value of the stream
'''Returns'''
:The album from which the video which has an offset <code>number</code> with respect to the currently playing video.
|
|
|-
|-
|  <code>PVR.ActStreamVideoBitRate</code>
|  <code>VideoPlayer.offset(number).Art(type)</code>
Video bitrate of the stream
'''Returns'''
:The art path for the requested arttype and for the video which has an offset <code>number</code> with respect to the currently playing video.
'''Parameters'''
:number - the offset with respect to the start of the playlist
:type - can virtually be anything, refers to the art type keyword in the art map (poster, fanart, banner, thumb, etc)
|
|
|-
|-
|  <code>PVR.ActStreamAudioBitRate</code>
|  <code>VideoPlayer.offset(number).Artist</code>
Audio bitrate of the stream
'''Returns'''
:The artist(s) of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|
|-
|-
|  <code>PVR.ActStreamDolbyBitRate</code>
|  <code>VideoPlayer.offset(number).Country</code>
Dolby bitrate of the stream
'''Returns'''
:The production country of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|
|-
|-
|  <code>PVR.ActStreamProgrSignal</code>
|  <code>VideoPlayer.offset(number).Cover</code>
Signal quality of the programme
'''Returns'''
:The cover of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|
|-
|-
|  <code>PVR.ActStreamProgrSnr</code>
|  <code>VideoPlayer.offset(number).DBID</code>
Signal to noise ratio of the programme
'''Returns'''
:The database id of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|
|-
|-
|  <code>PVR.ActStreamEncryptionName</code>
|  <code>VideoPlayer.offset(number).Director</code>
Encryption used on the stream
'''Returns'''
:The director of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|
|-
|-
|  <code>PVR.TVNowRecordingTitle</code>
|  <code>VideoPlayer.offset(number).Episode</code>
Title of the tv programme being recorded
'''Returns'''
| v17
:The episode number of the episode which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNowRecordingDateTime</code>
|  <code>VideoPlayer.offset(number).Genre</code>
Start date and time of the current tv recording
'''Returns'''
| v17
:The genre(s) of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNowRecordingChannel</code>
|  <code>VideoPlayer.offset(number).IMDBNumber</code>
Channel name of the current tv recording
'''Returns'''
| v17
:The IMDb ID of the the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNowRecordingChannelIcon</code>
|  <code>VideoPlayer.offset(number).LastPlayed</code>
Icon of the current recording TV channel
'''Returns'''
| v17
:The last play date of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNextRecordingTitle</code>
|  <code>VideoPlayer.offset(number).mpaa</code>
Title of the next tv programme that will be recorded
'''Returns'''
| v17
:The MPAA rating of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNextRecordingDateTime</code>
|  <code>VideoPlayer.offset(number).OriginalTitle</code>
Start date and time of the next tv recording
'''Returns'''
| v17
:The original title of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNextRecordingChannel</code>
|  <code>VideoPlayer.offset(number).PlayCount</code>
Channel name of the next tv recording
'''Returns'''
| v17
:The playcount of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TVNextRecordingChannelIcon</code>
|  <code>VideoPlayer.offset(number).Plot</code>
Icon of the next recording tv channel
'''Returns'''
| v17
:The complete Text Summary of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNowRecordingTitle</code>
|  <code>VideoPlayer.offset(number).PlotOutline</code>
Title of the radio programme being recorded
'''Returns'''
| v17
:The small Summary of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNowRecordingDateTime</code>
|  <code>VideoPlayer.offset(number).Premiered</code>
Start date and time of the current radio recording
'''Returns'''
| v17
:The release or aired date of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNowRecordingChannel</code>
|  <code>VideoPlayer.offset(number).Rating</code>
Channel name of the current radio recording
'''Returns'''
| v17
:The scraped rating of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNowRecordingChannelIcon</code>
|  <code>VideoPlayer.offset(number).RatingAndVotes</code>
Icon of the current recording radio channel
'''Returns'''
| v17
:The scraped rating and votes of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNextRecordingTitle</code>
|  <code>VideoPlayer.offset(number).Season</code>
Title of the next radio programme that will be recorded
'''Returns'''
| v17
:The season number of the episode which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNextRecordingDateTime</code>
|  <code>VideoPlayer.offset(number).Studio</code>
Start date and time of the next radio recording
'''Returns'''
| v17
:The studio of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.RadioNextRecordingChannel</code>
|  <code>VideoPlayer.offset(number).Tagline</code>
Channel name of the next radio recording
'''Returns'''
| v17
:The small Summary of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.ChannelNumberInput</code>
|  <code>VideoPlayer.offset(number).Title</code>
Label displaying the number the user entered on remote or keyboard
'''Returns'''
| v18
:The title of video which has an offset <code>number</code> with respect to the currently playing video.
{{highlight|'''Note'''<br>If it's in the database it will return the database title, else the filename.}}
|
|-
|-
|  <code>PVR.TimeshiftProgressDuration</code>
|  <code>VideoPlayer.offset(number).Top250</code>
|  Returns the duration of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
'''Returns'''
| v18
:The IMDb Top250 position of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressDuration(format)</code>
|  <code>VideoPlayer.offset(number).Trailer</code>
|  Returns the duration of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
'''Returns'''
| v18
:The path to the trailer of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressStartTime</code>
|  <code>VideoPlayer.offset(number).TVShowTitle</code>
|  Returns the start time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
'''Returns'''
| v18
:The title of the episode's tvshow name which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressStartTime(format)</code>
|  <code>VideoPlayer.offset(number).UserRating</code>
|  Returns the start time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
'''Returns'''
| v18
:The user rating of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressEndTime</code>
|  <code>VideoPlayer.offset(number).Votes</code>
|  Returns the end time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
'''Returns'''
| v18
:The scraped votes of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressEndTime(format)</code>
|  <code>VideoPlayer.offset(number).Writer</code>
|  Returns the end time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
'''Returns'''
| v18
:The name of Writer of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressPlayPos</code>
|  <code>VideoPlayer.offset(number).Year</code>
|  Returns the percentage of the current play position within the PVR timeshift progress
'''Returns'''
| v18
:The year of release of the video which has an offset <code>number</code> with respect to the currently playing video.
|
|-
|-
|  <code>PVR.TimeshiftProgressEpgStart</code>
|  <code>VideoPlayer.position(number).Album</code>
|  Returns the percentage of the start of the currently playing epg event within the PVR timeshift progress
'''Returns'''
| v18
:The album from which the music video which has an offset <code>number</code> with respect to the start of the playlist.
|
|-
|-
|  <code>PVR.TimeshiftProgressEpgEnd</code>
|  <code>VideoPlayer.position(number).Art(type)</code>
|  Returns the percentage of the end of the currently playing epg event within the PVR timeshift progress
'''Returns'''
| v18
:The art path for the requested arttype and for the video which has an offset <code>number</code> with respect to the start of the playlist.
'''Parameters'''
:number - the offset with respect to the start of the playlist
:type - can virtually be anything, refers to the art type keyword in the art map (poster, fanart, banner, thumb, etc)
|
|-
|-
|  <code>PVR.TimeshiftProgressBufferStart</code>
|  <code>VideoPlayer.position(number).Artist</code>
|  Returns the percentage of the start of the timeshift buffer within the PVR timeshift progress
'''Returns'''
| v18
:The artist(s) of the music video which has an offset <code>number</code> with respect to the start of the playlist.
|
|-
|-
|  <code>PVR.TimeshiftProgressBufferEnd</code>
|  <code>VideoPlayer.position(number).Country</code>
|  Returns the percentage of the end of the timeshift buffer within the PVR timeshift progress
'''Returns'''
| v18
:The production country of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|-
|-
|  <code>PVR.TimeShiftSeekbar</code>
|  <code>VideoPlayer.position(number).Cover</code>
This is the equivalent of Player.Seekbar, but for LiveTV (can be used in a slider control and indicates the position being seeked to)
'''Returns'''
|  v19
:The cover of the video which has an offset <code>number</code> with respect to the start of the playlist.
|}
 
=== RDS ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
<code>RDS.AudioLanguage</code>
|  The from RDS reported audio language of channel
|
|
|-
|-
|  <code>RDS.ChannelCountry</code>
|  <code>VideoPlayer.position(number).DBID</code>
Country where the radio channel is sended
'''Returns'''
:The database id of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.GetLine(number)</code>
|  <code>VideoPlayer.position(number).Director</code>
|  Returns the last sended RDS text messages on givern number, 0 is thelast and 4 rows are supported (0-3)
'''Returns'''
:The director of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Title</code>
|  <code>VideoPlayer.position(number).Episode</code>
Title of item; e.g. track title of an album (Only be available on RadiotextPlus)
'''Returns'''
:The episode number of the episode which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Artist</code>
|  <code>VideoPlayer.position(number).Genre</code>
A person or band/collective generally considered responsible for the work (Only be available on RadiotextPlus)
'''Returns'''
:The genre(s) of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Band</code>
|  <code>VideoPlayer.position(number).IMDBNumber</code>
Band/orchestra/accompaniment/musician (Only be available on RadiotextPlus)
'''Returns'''
:The IMDb ID of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Composer</code>
|  <code>VideoPlayer.position(number).LastPlayed</code>
Name of the original composer/author (Only be available on RadiotextPlus)
'''Returns'''
:The last play date of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Conductor</code>
|  <code>VideoPlayer.position(number).mpaa</code>
|  The artist(s) who performed the work. In classical music this would bethe conductor (Only be available on RadiotextPlus)
'''Returns'''
:The MPAA rating of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Album</code>
|  <code>VideoPlayer.position(number).OriginalTitle</code>
|  The collection name to which this track belongs (Only be available on RadiotextPlus)
'''Returns'''
:The original title of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.TrackNumber</code>
|  <code>VideoPlayer.position(number).PlayCount</code>
|  The track number of the item on the album on which it was originallyreleased. (Only be available on RadiotextPlus)
'''Returns'''
:The playcount of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.RadioStyle</code>
|  <code>VideoPlayer.position(number).Plot</code>
|  The from radio channel used style of currently played part, e.g "popmusic", "news" or "weather"
'''Returns'''
:The complete Text Summary of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.Comment</code>
|  <code>VideoPlayer.position(number).PlotOutline</code>
Radio station comment string if available (Only be available on RadiotextPlus)
'''Returns'''
:The small Summary of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoNews</code>
|  <code>VideoPlayer.position(number).Premiered</code>
Message / headline (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The release or aired date of the video which has an offset <code>number</code> with respect to the start of the playlist. if it's in the database.
|
|
|-
|-
|  <code>RDS.InfoNewsLocal</code>
|  <code>VideoPlayer.position(number).Rating</code>
Local information news sended from radio channel (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The scraped rating of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoStock</code>
|  <code>VideoPlayer.position(number).RatingAndVotes</code>
Quote information; either as one part or as several distinct parts:"name 99latest value 99change 99high 99low 99volume" (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The scraped rating and votes of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoStockSize</code>
|  <code>VideoPlayer.position(number).Season</code>
Number of rows present in stock information (Only be available on RadiotextPlus)
'''Returns'''
:The season number of the episode which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoSport</code>
|  <code>VideoPlayer.position(number).Studio</code>
Result of a game; either as one part or as several distinct parts:"match 99result", e.g. "Bayern München : Borussia 995:5"  (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The studio of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoSportSize</code>
|  <code>VideoPlayer.position(number).Tagline</code>
Number of rows present in sport information (Only be available on RadiotextPlus)
'''Returns'''
:The small Summary of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoLottery</code>
|  <code>VideoPlayer.position(number).Title</code>
Raffle / lottery: "key word 99values" (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The title of the video which has an offset <code>number</code> with respect to the start of the playlist.
{{highlight|'''Note'''<br>If it's in the database it will return the database title, else the filename.}}
|
|
|-
|-
|  <code>RDS.InfoLotterySize</code>
|  <code>VideoPlayer.position(number).Top250</code>
Number of rows present in lottery information (Only be available on RadiotextPlus)
'''Returns'''
:The IMDb Top250 position of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoWeather</code>
|  <code>VideoPlayer.position(number).Trailer</code>
Weather informations sended from radio channel (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The path to the trailer of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoWeatherSize</code>
|  <code>VideoPlayer.position(number).TVShowTitle</code>
Number of rows present in weather information (Only be available on RadiotextPlus)
'''Returns'''
:The title of the episode's tvshow name which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoCinema</code>
|  <code>VideoPlayer.position(number).UserRating</code>
Information about movies in cinema (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The user rating of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoCinemaSize</code>
|  <code>VideoPlayer.position(number).Votes</code>
Number of rows present in cinema information (Only be available on RadiotextPlus)
'''Returns'''
:The scraped votes of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoHoroscope</code>
|  <code>VideoPlayer.position(number).Writer</code>
Horoscope; either as one part or as two distinct parts:"key word 99text", e.g. "sign of the zodiac 99blablabla" (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The name of Writer of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoHoroscopeSize</code>
|  <code>VideoPlayer.position(number).Year</code>
Number of rows present in horoscope information (Only be available on RadiotextPlus)
'''Returns'''
:The year of release of the video which has an offset <code>number</code> with respect to the start of the playlist.
|
|
|-
|-
|  <code>RDS.InfoOther</code>
|  <code>VideoPlayer.StartTime</code>
Other information, not especially specified: "key word 99info" (if available) (Only be available on RadiotextPlus)
'''Returns'''
:The start date and time of the currently playing epg event or recording ( PVR ).
|
|
|-
|-
|  <code>RDS.InfoOtherSize</code>
|  <code>VideoPlayer.SubtitleCodec</code>
Number of rows present with other informations (Only be available on RadiotextPlus)
'''Returns'''
:The codec of the current subtitles of the currently playing video. Possible values include:
:ass
:dvb_subtitle
:dvb_teletext
:dvd_subtitle
:hdmv_pgs_subtitle
:microdvd
:mov_text
:mpl2
:realtext
:sami
:srt
:ssa
:subrip
:text
:ttml
:vplayer
:webvtt
:xsub
{{highlight|'''Note'''<br><code>VideoPlayer.SubtitleCodec</code> holds the codec of the next available subtitles stream if subtitles are disabled in the player.}}
|
|
|-
|-
|  <code>RDS.ProgStation</code>
|  <code>VideoPlayer.SubtitleLanguageEx</code>
Name of the radio channel@note becomes also be set from epg if from RDS not available
'''Returns'''
:The English name of the language of the current subtitle stream of the currently playing item.
|
|
|-
|-
|  <code>RDS.ProgNow</code>
|  <code>VideoPlayer.SubtitleName</code>
Now played program name@note becomes also be set from epg if from RDS not available
'''Returns'''
:The name of the active subtitle stream of the currently playing video.
|
|
|-
|-
|  <code>RDS.ProgNext</code>
|  <code>VideoPlayer.TitleExtraInfo</code>
Next played program name (if available)@note becomes also be set from epg if from RDS not available
'''Returns'''
:string containing extra information, enriching the title of the currently playing media, if any.
|
|
|-
|-
|  <code>RDS.ProgHost</code>
|  <code>VideoPlayer.VideoStreamCount</code>
Name of the host of the radio show
Returns the number of video streams of the currently playing video
|
| v22
|-
|-
|  <code>RDS.ProgEditStaff</code>
|  <code>VideoPlayer.ParentalRatingCode</code>
Name of the editorial staff; e.g. name of editorial journalist (Only be available on RadiotextPlus)
Shows the parental rating code
|
| v22
|-
|-
|  <code>RDS.ProgHomepage</code>
|  <code>VideoPlayer.ParentalRatingIcon</code>
Link to radio station homepage (Only be available on RadiotextPlus)
Shows the parental rating icon
|
| v22
|-
|-
|  <code>RDS.ProgStyle</code>
|  <code>VideoPlayer.ParentalRatingSource</code>
Human readable string about radiostyle defined from RDS or RBDS
Shows the parental rating source
|
| v22
|-
|-
|  <code>RDS.PhoneHotline</code>
|  <code>VideoPlayer.ChannelLogo</code>
The telephone number of the radio station's hotline (Only be available on RadiotextPlus)
Shows the logo of the currently selected radio or TV channel
|
| v22
|-
|-
|  <code>RDS.PhoneStudio</code>
|  <code>VideoPlayer.VideoVersionName</code>
The telephone number of the radio station's studio (Only be available on RadiotextPlus)
Show the name of the video version
|  v21
|-
|  <code>VideoPlayer.Time</code>
|  Current time in movie
|
|
|-
|-
|  <code>RDS.SmsStudio</code>
|  <code>VideoPlayer.TimeRemaining</code>
The sms number of the radio stations studio (to send directly a sms to the studio) (if available) (Only be available on RadiotextPlus)
Current remaining time in movie
|
|
|-
|-
|  <code>RDS.EmailHotline</code>
|  <code>VideoPlayer.TimeSpeed</code>
The email adress of the radio stations hotline (if available) (Only be available on RadiotextPlus)
Current time + playspeed. e.g. 1:23:14 (-4x)
|
|
|-
|-
|  <code>RDS.EmailStudio</code>
|  <code>VideoPlayer.Duration</code>
The email adress of the radio stations studio (if available) (Only be available on RadiotextPlus)
Length of current movie
|
|
|}
 
=== Skin ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|-
|  <code>Skin.CurrentTheme</code>
|  <code>VideoPlayer.Title</code>
Returns the current selected skin theme.
Title of currently playing video. If it's in the database it will return the database title, else the filename. (supports .offset() and .position())
|
|
|-
|-
|  <code>Skin.CurrentColourTheme</code>
|  <code>VideoPlayer.OriginalTitle</code>
Returns the current selected colour theme of the skin.
The original title of currently playing video. (supports .offset() and .position())
|
|
|-
|-
|  <code>Skin.Font</code>
|  <code>VideoPlayer.TVShowTitle</code>
Returns the current fontset from Font.xml.
Title of currently playing episode's tvshow name. (supports .offset() and .position())
|  v18 addition
|-
|  <code>Skin.String(name)</code>
|  Returns the <span class="nobr">user-set</span> skin string, set via the Skin.SetString(name) '''[[List of Built In Functions]]'''. Allows skinners to have <span class="nobr">user-customisable</span> labels.
|
|
|-
|-
|  <code>Skin.AspectRatio</code>
|  <code>VideoPlayer.Season</code>
Returns the closest aspect ratio match using the resolution info from the skin's addon.xml file.
Season number of the currently playing episode, if it's in the database. (supports .offset() and .position())
|
|
|}
=== Slideshow ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|-
|  <code>Slideshow.Altitude</code>
|  <code>VideoPlayer.Episode</code>
Shows the altitude in meters where the current picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
Episode number of the currently playing episode. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Aperture</code>
|  <code>VideoPlayer.Genre</code>
Shows the F-stop used to take the current picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
Genre(s) of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Author</code>
|  <code>VideoPlayer.Genre(separator)</code>
Shows the name of the person involved in writing about the current picture. This is the value of the IPTC Writer tag (hex code 0x7A).
'''Returns'''
|
:A list of genres of current movie, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for videos. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>Slideshow.Byline</code>
|  <code>VideoPlayer.Director</code>
Shows the name of the person who created the current picture. This is the value of the IPTC Byline tag (hex code 0x50).
Director of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.BylineTitle</code>
|  <code>VideoPlayer.Director(separator)</code>
Shows the title of the person who created the current picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
'''Returns'''
|
:A list of directors of the currently playing video, separated by given separator, or if no separator was given separated by the advanced settings value \“itemseparator\” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>Slideshow.CameraMake</code>
|  <code>VideoPlayer.Country</code>
Shows the manufacturer of the camera used to take the current picture. This is the value of the EXIF Make tag (hex code 0x010F).
Production country of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.CameraModel</code>
|  <code>VideoPlayer.Year</code>
Shows the manufacturer's model name or number of the camera used to take the current picture. This is the value of the EXIF Model tag (hex code 0x0110).
Year of release of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Caption</code>
|  <code>VideoPlayer.Premiered</code>
Shows a description of the current picture. This is the value of the IPTC Caption tag (hex code 0x78).
The release/aired date of the currently selected episode, show, movie or EPG item. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Category</code>
|  <code>VideoPlayer.Rating</code>
Shows the subject of the current picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
IMDb user rating of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.CCDWidth</code>
|  <code>VideoPlayer.UserRating</code>
|  Shows the width of the CCD in the camera used to take the current picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
|  Shows the user rating of the currently playing item. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.City</code>
|  <code>VideoPlayer.Votes</code>
Shows the city where the current picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
IMDb votes of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Colour</code>
|  <code>VideoPlayer.RatingAndVotes</code>
Shows whether the current picture is "Colour" or "Black and White".
IMDb user rating and votes of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.CopyrightNotice</code>
|  <code>VideoPlayer.mpaa</code>
Shows the copyright notice of the current picture. This is the value of the IPTC Copyright tag (hex code 0x74).
MPAA rating of current movie, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Country</code>
|  <code>VideoPlayer.IMDBNumber</code>
Shows the full name of the country where the current picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
The IMDB iD of the current video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.CountryCode</code>
|  <code>VideoPlayer.EpisodeName</code>
Shows the country code of the country where the current picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
(PVR only) The name of the episode if the playing video is a TV Show, if it's in the database
|
|
|-
|-
|  <code>Slideshow.Credit</code>
|  <code>VideoPlayer.PlaylistPosition</code>
Shows who provided the current picture. This is the value of the IPTC Credit tag (hex code 0x6E).
Position of the current song in the current video playlist
|
|
|-
|-
|  <code>Slideshow.DigitalZoom</code>
|  <code>VideoPlayer.PlaylistLength</code>
Shows the digital zoom ratio when the current picture was taken. This is the value of the EXIF .DigitalZoomRatio tag (hex code 0xA404). 
Total size of the current video playlist
|
|
|-
|-
|  <code>Slideshow.EXIFComment</code>
|  <code>VideoPlayer.Cast</code>
Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
A list of cast members, separated by carriage returns, if it's in the database
|
|
|-
|-
|  <code>Slideshow.EXIFDate</code>
|  <code>VideoPlayer.Cast(separator)</code>
Shows the localized date of the current picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
'''Returns'''
:A list of cast members of the currently playing video, separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|  <code>VideoPlayer.CastAndRole</code>
|  A list of cast members and roles, separated by carriage returns. Every cast/role combination is formatted 'cast' as 'role' where 'as' is localised, if it's in the database
|
|
|-
|-
|  <code>Slideshow.EXIFDescription</code>
|  <code>VideoPlayer.CastAndRole(separator)</code>
Shows a short description of the current picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
'''Returns'''
:A list of cast members and roles of the currently playing video, pairs separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|  <code>VideoPlayer.Trailer</code>
|  The trailer of the current movie. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.EXIFSoftware</code>
|  <code>VideoPlayer.Album</code>
Shows the name and version of the firmware used by the camera that took the current picture. This is the value of the EXIF Software tag (hex code 0x0131).
Album from which the current Music Video is from, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.EXIFTime</code>
|  <code>VideoPlayer.Artist</code>
Shows the date/timestamp of the current picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
Artist(s) of current Music Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Exposure</code>
|  <code>VideoPlayer.Studio</code>
Shows the class of the program used by the camera to set exposure when the current picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
Studio of current Music Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.ExposureBias</code>
|  <code>VideoPlayer.Writer</code>
Shows the exposure bias of the current picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
Name of Writer of current playing Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.ExposureMode</code>
|  <code>VideoPlayer.Writer(separator)</code>
Shows the exposure mode of the current picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
'''Returns'''
|
:A list of writers of the currently playing video, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>Slideshow.ExposureTime</code>
|  <code>VideoPlayer.Tagline</code>
Shows the exposure time of the current picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Filedate</code>
|  <code>VideoPlayer.PlotOutline</code>
Shows the file date of the current picture
Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Filename</code>
|  <code>VideoPlayer.Plot</code>
Shows the file name of the current picture
Complete Text Summary of current playing Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.Filesize</code>
|  <code>VideoPlayer.Top250</code>
|  Shows the file size of the current picture
|  Shows the IMDb top250 position of the current playing Video. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.FlashUsed</code>
|  <code>VideoPlayer.LastPlayed</code>
Shows the status of flash when the current picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209)
Last play date of current playing Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.FocalLength</code>
|  <code>VideoPlayer.PlayCount</code>
Shows the focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
Playcount of current playing Video, if it's in the database. (supports .offset() and .position())
|
|
|-
|-
|  <code>Slideshow.FocusDistance</code>
|  <code>VideoPlayer.HdrType</code>
|  Shows the distance to the subject, in meters. This is the value of the EXIF SubjectDistance tag (hex code 0x9206).
|  Shows the HDR type of the currently playing video (possible values: hdr10, dolbyvision and hlg)
|
| v20
|-
|-
|  <code>Slideshow.Headline</code>
|  <code>VideoPlayer.VideoCodec</code>
|  Shows a synopsis of the contents of the current picture. This is the value of the IPTC Headline tag (hex code 0x69).
|  Shows the video codec of the currently playing video (common values: see ListItem.VideoCodec)
|
|
|-
|-
|  <code>Slideshow.ImageType</code>
|  <code>VideoPlayer.VideoResolution</code>
|  Shows the color components of the current picture. This is the value of the IPTC ImageType tag (hex code 0x82).
|  Shows the video resolution of the currently playing video (possible values: see ListItem.VideoResolution)
|
|
|-
|-
|  <code>Slideshow.IPTCDate</code>
|  <code>VideoPlayer.VideoAspect</code>
|  Shows the date when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
|  Shows the aspect ratio of the currently playing video (possible values: see ListItem.VideoAspect)
|
|
|-
|-
|  <code>Slideshow.ISOEquivalence</code>
|  <code>VideoPlayer.AudioCodec</code>
|  Shows the ISO speed of the camera when the current picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
|  Shows the audio codec of the currently playing video, optionally 'n' defines the number of the audiostream (common values: see ListItem.AudioCodec)
|
|
|-
|-
|  <code>Slideshow.Keywords</code>
|  <code>VideoPlayer.AudioChannels</code>
|  Shows keywords assigned to the current picture. This is the value of the IPTC Keywords tag (hex code 0x19).
|  Shows the number of audio channels of the currently playing video (possible values: see ListItem.AudioChannels)
|
|
|-
|-
|  <code>Slideshow.Latitude</code>
|  <code>VideoPlayer.AudioLanguage</code>
|  Shows the latitude where the current picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
|  Shows the language of the audio of the currently playing video (possible values: see ListItem.AudioLanguage)
|
|
|-
|-
|  <code>Slideshow.LightSource</code>
|  <code>VideoPlayer.SubtitlesLanguage</code>
|  Shows the kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
|  Shows the language of the subtitle of the currently playing video (possible values: see ListItem.SubtitlesLanguage)
|
|
|-
|-
|  <code>Slideshow.LongEXIFDate</code>
|  <code>VideoPlayer.StereoscopicMode</code>
|  Shows only the localized date of the current picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|  Shows the stereoscopic mode of the currently playing video (possible values: see ListItem.StereoscopicMode)
|
|
|-
|-
|  <code>Slideshow.LongEXIFTime</code>
|  <code>VideoPlayer.EndTime</code>
Shows the date/timestamp of the current picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
End date of the currently playing programme (PVR).
|
|
|-
|-
|  <code>Slideshow.Longitude</code>
|  <code>VideoPlayer.NextTitle</code>
Shows the longitude where the current picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
Title of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.MeteringMode</code>
|  <code>VideoPlayer.NextGenre</code>
Shows the metering mode used when the current picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
Genre of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.ObjectName</code>
|  <code>VideoPlayer.NextGenre(separator)</code>
Shows a shorthand reference for the current picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
'''Returns'''
|
:A list of genres of the programme that will be played next (PVR), separated by given separator, or if no separator was given separated by the advanced settings value \“itemseparator\” for videos. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
| [https://forum.kodi.tv/showthread.php?tid=377306&pid=3230987#pid3230987 v22]
|-
|-
|  <code>Slideshow.Orientation</code>
|  <code>VideoPlayer.NextPlot</code>
Shows the orientation of the current picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
Plot of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.Path</code>
|  <code>VideoPlayer.NextPlotOutline</code>
Shows the file path of the current picture
Plot outline of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.Process</code>
|  <code>VideoPlayer.NextStartTime</code>
Shows the process used to compress the current picture
Start time of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.ReferenceService</code>
|  <code>VideoPlayer.NextEndTime</code>
Shows the Service Identifier of a prior envelope to which the current picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
End time of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.Resolution</code>
|  <code>VideoPlayer.NextDuration</code>
Shows the dimensions of the current picture (Width x Height)
Duration of the programme that will be played next (PVR).
|
|
|-
|-
|  <code>Slideshow.SlideComment</code>
|  <code>VideoPlayer.ChannelName</code>
Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.EXIFComment.
Name of the curently tuned channel (PVR).
|
|
|-
|-
|  <code>Slideshow.SlideIndex</code>
|  <code>VideoPlayer.ChannelNumberLabel</code>
Shows the slide index of the current picture
Channel and subchannel number of the tv channel that's currently playing (PVR).
|
|
|-
|-
|  <code>Slideshow.Source</code>
|  <code>VideoPlayer.ChannelGroup</code>
Shows the original owner of the current picture. This is the value of the IPTC Source tag (hex code 0x73).
Group of the curently tuned channel (PVR).
|
|
|-
|-
|  <code>Slideshow.SpecialInstructions</code>
|  <code>VideoPlayer.ParentalRating</code>
Shows other editorial instructions concerning the use of the current picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
Parental rating of the currently playing programme (PVR).
|
|
|-
|-
|  <code>Slideshow.State</code>
|  <code>VideoPlayer.DBID</code>
Shows the State/Province where the current picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
The database id of the currently playing video. (supports .offset() and .position())
|
| v17
|-
|-
|  <code>Slideshow.Sublocation</code>
|  <code>VideoPlayer.UniqueID()</code>
Shows the location within a city where the current picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
Returns the UniqueID of the currently playing video
|
| v19
|-
|-
|  <code>Slideshow.SupplementalCategories</code>
|  <code>VideoPlayer.TvShowDBID</code>
Shows supplemental category codes to further refine the subject of the current picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
Returns the tv show DBID of the currently playing episode
|
|  v19
|}
 
=== Playlist ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>Slideshow.TimeCreated</code>
|  <code>Playlist.Length(media)</code>
Shows the time when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
Total size of the current playlist. optional parameter media is either video or music.
|
|
|-
|-
|  <code>Slideshow.TransmissionReference</code>
|  <code>Playlist.Position(media)</code>
Shows a code representing the location of original transmission of the current picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
Position of the current item in the current playlist. optional parameter media is either video or music.
|
|
|-
|-
|  <code>Slideshow.Urgency</code>
|  <code>Playlist.Random</code>
Shows the urgency of the current picture. Values are 1-9. The 1 is most urgent. Some image management programs use urgency to indicate picture rating, where urgency 1 is 5 stars and urgency 5 is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
Returns 'On' or 'Off'
|
|
|-
|-
|  <code>Slideshow.WhiteBalance</code>
|  <code>Playlist.Repeat</code>
Shows the white balance mode set when the current picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
Returns string ID's 592 (Repeat One), 593 (Repeat All), or 594 (Repeat Off)
|
|
|}
|}


=== System ===
=== PVR ===
 
{|  class="wikitable sortable" width="100%"
{|  class="wikitable sortable" width="100%"
! InfoLabels
! InfoLabels
! style="80%" | Definition
! style="80%" | Description
! Version
! Version
|-
|-
|  <code>System.Time</code>
|  <code>PVR.ActStreamAudioBitRate</code>
Current time
Audio bitrate of the stream
|
|
|-
|-
|  <code>System.Time(format)</code>
|  <code>PVR.ActStreamBer</code>
Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss). (xx) option added after dharma
Bit error rate of the stream
|
|
|-
|-
|  <code>System.Date</code>
|  <code>PVR.ActStreamClient</code>
Current date
Stream client name
|
|
|-
|-
|  <code>System.Date(format)</code>
|  <code>PVR.ActStreamDevice</code>
Show current date using format, available markings: d (day of month 1-31), dd (day of month 01-31), ddd (short day of the week Mon-Sun), DDD (long day of the week Monday-Sunday), m (month 1-12), mm (month 01-12), mmm (short month name Jan-Dec), MMM (long month name January-December), yy (2-digit year), yyyy (4-digit year). Added after dharma.
Stream device name
|
|
|-
|-
|  <code>System.AlarmPos</code>
|  <code>PVR.ActStreamDolbyBitRate</code>
Shutdown Timer position
Dolby bitrate of the stream
|
|
|-
|-
|  <code>System.BatteryLevel</code>
|  <code>PVR.ActStreamEncryptionName</code>
Returns the remaining battery level in range 0-100
Encryption used on the stream
|
|
|-
|-
|  <code>System.FreeSpace</code>
|  <code>PVR.ActStreamMux</code>
Total Freespace on the drive
'''Returns'''
:The multiplex type of played channel if available.
|
|
|-
|-
|  <code>System.UsedSpace</code>
|  <code>PVR.ActStreamProgrSignal</code>
Total Usedspace on the drive
Signal quality of the programme
|
|
|-
|-
|  <code>System.TotalSpace</code>
|  <code>PVR.ActStreamProgrSnr</code>
Totalspace on the drive
Signal to noise ratio of the programme
|
|
|-
|-
|  <code>System.UsedSpacePercent</code>
|  <code>PVR.ActStreamProviderName</code>
Total Usedspace Percent on the drive
'''Returns'''
:The provider name of the played channel if available.
|
|
|-
|-
|  <code>System.FreeSpacePercent</code>
|  <code>PVR.ActStreamServiceName</code>
Total Freespace Percent on the drive
'''Returns'''
:The service name of played channel if available.
|
|
|-
|-
|  <code>System.CPUTemperature</code>
|  <code>PVR.ActStreamSignal</code>
Current CPU temperature
Signal quality of the stream
|
|
|-
|-
|  <code>System.CpuUsage</code>
|  <code>PVR.ActStreamSnr</code>
Displays the cpu usage for each individual cpu core.
Signal to noise ratio of the stream
|
|
|-
|-
|  <code>System.CoreUsage(id)</code>
|  <code>PVR.ActStreamStatus</code>
Displays the usage of the cpu core with the given 'id'
Status of the stream
|
|
|-
|-
|  <code>System.GPUTemperature</code>
|  <code>PVR.ActStreamUnc</code>
Current GPU temperature
UNC value of the stream
|
|
|-
|-
|  <code>System.FanSpeed</code>
|  <code>PVR.ActStreamVideoBitRate</code>
Current fan speed
Video bitrate of the stream
|
|
|-
|-
|  <code>System.BuildVersion</code>
|  <code>PVR.BackendChannels</code>
version of build
Number of available channels the backend provides
|
|
|-
|-
|  <code>System.BuildDate</code>
|  <code>PVR.BackendDeletedRecordings</code>
Date of build
'''Returns'''
:The number of deleted recordings present on the backend.
|
|
|-
|-
|  <code>System.FriendlyName</code>
|  <code>PVR.BackendDiskSpace</code>
Returns the Kodi instance name. It will auto append (%hostname%) in case the device name was not changed. e.g. "Kodi (htpc)"
Available diskspace on the backend
|
|
|-
|-
|  <code>System.FPS</code>
|  <code>PVR.BackendDiskspace</code>
Current rendering speed (frames per second)
Free diskspace available for recordings on the backend
|
|
|-
|-
|  <code>System.FreeMemory</code>
|  <code>PVR.BackendDiskSpaceProgr</code>
Amount of free memory in Mb
'''Returns'''
:The available diskspace on the backend as percent value.
|
|
|-
|-
|  <code>System.Memory(format)</code>
|  <code>PVR.BackendHost</code>
Available formats: used, used.percent, free, free.percent, total
Backend hostname
|
|
|-
|-
|  <code>System.ScreenMode</code>
|  <code>PVR.BackendName</code>
Screenmode (e.g. windowed / fullscreen)
Name of the backend being used
|
|
|-
|-
|  <code>System.ScreenWidth</code>
|  <code>PVR.BackendNumber</code>
Width of screen in pixels
Backend number
|
|
|-
|-
|  <code>System.ScreenHeight</code>
|  <code>PVR.BackendRecordings</code>
Height of screen in pixels
Number of recording available on the backend
|
|
|-
|-
|  <code>System.StartupWindow</code>
|  <code>PVR.BackendTimers</code>
The Window Kodi will load on startup
Number of timers set for the backend
|
|
|-
|-
|  <code>System.CurrentWindow</code>
|  <code>PVR.BackendVersion</code>
Current Window we are in
version of the backend that's being used
|
|
|-
|-
|  <code>System.CurrentControl</code>
|  <code>PVR.ChannelNumberInput</code>
Current focused control
Label displaying the number the user entered on remote or keyboard
|
| v18
|-
|  <code>PVR.ClientCount</code>
|  Number of PVR clients enabled
|  v22
|-
|-
|  <code>System.CurrentControlID</code>
|  <code>PVR.ClientName</code>
ID of the currently focused control.
'''Returns'''
:The name of the PVR client add-on, as specified by the add-on developer.
|
|
|-
|-
|  <code>System.DVDLabel</code>
|  <code>PVR.EpgEventDuration[(format)]</code>
Label of the disk in the <span class="nobr">DVD-ROM</span> drive
Returns the duration of the currently played title on TV. See ListItem.Duration for optinional formatting options
|
|
|-
|-
|  <code>System.HddTemperature</code>
|  <code>PVR.EpgEventElapsedTime[(format)]</code>
Hdd temperature
Returns the time position of the currently played title on TV. See ListItem.Duration for optinional formatting options
|
|
|-
|-
|  <code>System.OSVersionInfo</code>
|  <code>PVR.EpgEventFinishTime[(format)]</code>
System name + kernel version
Returns the time the currently playing epg event will end. See ListItem.Duration for optinional formatting options
|  v18
|-
|  <code>PVR.EpgEventProgress</code>
|  Returns the position of currently played title on TV as integer
|
|
|-
|-
|  <code>System.KernelVersion (deprecated)</code>
|  <code>PVR.EpgEventRemainingTime[(format)]</code>
System name + kernel version
Returns the remaining time for currently playing epg event. See ListItem.Duration for optinional formatting options
|
|  v18
|-
|  <code>PVR.EpgEventSeekTime[(format)]</code>
| Returns the seek time of the currently playing epg event. See ListItem.Duration for optinional formatting options
|  v18
|-
|-
|  <code>System.Uptime</code>
|  <code>PVR.InstanceName</code>
System current uptime
'''Returns'''
:The name of the instance of the PVR client add-on, as specified by the user in the add-on settings. Empty if the PVR client add-on does not support multiple instances.
|
|
|-
|-
|  <code>System.TotalUptime</code>
|  <code>PVR.NextRecordingChannel</code>
System total uptime
Channel name of the next recording
|
|
|-
|-
|  <code>System.CpuFrequency</code>
|  <code>PVR.NextRecordingDateTime</code>
System cpu frequency
Start date and time of the next recording
|
|
|-
|-
|  <code>System.ScreenResolution</code>
|  <code>PVR.NextRecordingTitle</code>
Screen resolution
Title of the next programme that will be recorded
|
|
|-
|-
|  <code>System.VideoEncoderInfo</code>
|  <code>PVR.NextTimer</code>
video encoder info
Next timer date
|
|
|-
|-
|  <code>System.InternetState</code>
|  <code>PVR.NowRecordingChannel</code>
Will return the internet state, 'connected' or 'not connected' (localized)
Channel number that's being recorded
|
|
|-
|-
|  <code>System.Language</code>
|  <code>PVR.NowRecordingDateTime</code>
Shows the current language
Start date and time of the current recording
|
|
|-
|-
|  <code>System.ProfileName</code>
|  <code>PVR.NowRecordingTitle</code>
Shows the User name of the currently logged in Kodi user
Title of the programme being recorded
|
|
|-
|-
|  <code>System.ProfileCount</code>
|  <code>PVR.RadioNextRecordingChannel</code>
Shows the number of defined profiles
Channel name of the next radio recording
|
| v17
|-
|-
|  <code>System.ProfileAutoLogin</code>
|  <code>PVR.RadioNextRecordingChannelIcon</code>
|  The profile Kodi will auto login to
'''Returns'''
:The icon of the next recording radio channel.
|
|
|-
|-
|  <code>System.Progressbar</code>
|  <code>PVR.RadioNextRecordingDateTime</code>
The percentage of the currently active progress.
Start date and time of the next radio recording
|
| v17
|-
|-
|  <code>System.StereoscopicMode</code>
|  <code>PVR.RadioNextRecordingTitle</code>
The prefered stereoscopic mode (settings > video > playback)
Title of the next radio programme that will be recorded
|
|  v17
|-
|  <code>PVR.RadioNowRecordingChannel</code>
|  Channel name of the current radio recording
|  v17
|-
|  <code>PVR.RadioNowRecordingChannelIcon</code>
|  Icon of the current recording radio channel
|  v17
|-
|  <code>PVR.RadioNowRecordingDateTime</code>
|  Start date and time of the current radio recording
|  v17
|-
|  <code>PVR.RadioNowRecordingTitle</code>
|  Title of the radio programme being recorded
|  v17
|-
|  <code>PVR.TimeShiftCur[(format)]</code>
| Current position of the timeshift. See ListItem.Duration for optinional formatting options
|-
|-
|  <code>System.TemperatureUnits</code>
|  <code>PVR.TimeShiftEnd[(format)]</code>
Shows Celsius or Fahrenheit symbol
End position of the timeshift. See ListItem.Duration for optinional formatting options
|
|
|-
|-
|  <code>System.AddonTitle(id)</code>
|  <code>PVR.TimeShiftOffset[(format)]</code>
Returns the title of the addon with the given id
Current offset of the timeshift. See ListItem.Duration for optinional formatting options
|
|
|-
|-
|  <code>System.AddonVersion(id)</code>
|  <code>PVR.TimeShiftProgress</code>
|  Returns the version of the addon with the given id
|  Returns the position of currently timeshifted title on TV as interger
|
|
|-
|-
|  <code>System.BuildVersionCode</code>
|  <code>PVR.TimeshiftProgressBufferEnd</code>
The internal version of the kodi build
Returns the percentage of the end of the timeshift buffer within the PVR timeshift progress
v19
v18
|-
|-
|  <code>System.BuildVersionGit</code>
|  <code>PVR.TimeshiftProgressBufferStart</code>
The git version (sha) of the kodi build
Returns the percentage of the start of the timeshift buffer within the PVR timeshift progress
v19
v18
|-
|-
|  <code>System.AddonUpdateCount</code>
|  <code>PVR.TimeshiftProgressDuration</code>
The number of available addon updates
Returns the duration of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
|  v19
v18
|}
 
=== Visualisation ===
 
{class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" |  Definition
! Version
|-
|-
|  <code>Visualisation.Preset</code>
|  <code>PVR.TimeshiftProgressDuration(format)</code>
Shows the current preset of the visualisation.
Returns the duration of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
|
| v18
|-
|-
|  <code>Visualisation.Name</code>
|  <code>PVR.TimeshiftProgressEndTime</code>
Shows the name of the visualisation.
Returns the end time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
|
v18
|}
 
=== Weather labels ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" Definition
! Version
|-
|-
|  <code>Weather.Conditions</code>
|  <code>PVR.TimeshiftProgressEndTime(format)</code>
Current weather conditions – this is looked up in a background process.
Returns the end time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
|
| v18
|-
|-
|  <code>Weather.Temperature</code>
|  <code>PVR.TimeshiftProgressEpgEnd</code>
Current weather temperature
Returns the percentage of the end of the currently playing epg event within the PVR timeshift progress
|
| v18
|-
|-
|  <code>Weather.Location</code>
|  <code>PVR.TimeshiftProgressEpgStart</code>
City/town which the above two items are for
Returns the percentage of the start of the currently playing epg event within the PVR timeshift progress
|
| v18
|-
|-
|  <code>Weather.fanartcode</code>
|  <code>PVR.TimeshiftProgressPlayPos</code>
Current weather fanartcode.
Returns the percentage of the current play position within the PVR timeshift progress
|
| v18
|-
|-
|  <code>Weather.plugin</code>
|  <code>PVR.TimeshiftProgressStartTime</code>
Current weather plugin.
Returns the start time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero
|
v18
|}
 
=== Window ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" Definition
! Version
|-
|-
|  <code>Window([window]).Property(key)</code>
|  <code>PVR.TimeshiftProgressStartTime(format)</code>
Window property. (key can be any value, optional window can be id or name)
Returns the start time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss)
|
| v18
|-
|-
|  <code>Window.Property(xmlfile)</code>
|  <code>PVR.TimeShiftSeekbar</code>
Displays the name of the xml file currently shown
This is the equivalent of Player.Seekbar, but for LiveTV (can be used in a slider control and indicates the position being seeked to)
|
| v19
|-
|-
|  <code>Window.Property(IsRadio)</code>
|  <code>PVR.TimeShiftStart[(format)]</code>
Returns "true" if the window is a radio window, empty string otherwise (for use in the PVR windows)
Start position of the timeshift. See ListItem.Duration for optinional formatting options
|
|
|-
|-
|  <code>Window(AddonBrowser).Property(Updated)</code>
|  <code>PVR.TotalDiscSpace</code>
Shows the date and time the addon repo was last checked for updates
Total diskspace available for recordings
|
|
|-
|-
|  <code>Window.Property(Addon.ID)</code>
|  <code>PVR.TVNextRecordingChannel</code>
Returns the id of the selected addon, in DialogAddonSettings.xml
Channel name of the next tv recording
|
| v17
|-
|-
|  <code>Window(Home).Property(key)</code>
|  <code>PVR.TVNextRecordingChannelIcon</code>
The home window has the following info labels.
Icon of the next recording tv channel
Movies.Count, Movies.Watched, Movies.UnWatched, TVShows.Count, TVShows.Watched, TVShows.UnWatched, Episodes.Count, Episodes.Watched, Episodes.UnWatched, MusicVideos.Count, MusicVideos.Watched, MusicVideos.UnWatched, Music.SongsCount, Music.AlbumsCount, Music.ArtistsCount
| v17
 
LatestMovie.[1-10].Title, LatestMovie.[1-10].Year, LatestMovie.[1-10].RunningTime, LatestMovie.[1-10].Rating, LatestMovie.[1-10].Plot, LatestMovie.[1-10].Trailer, LatestMovie.[1-10].Thumb, LatestMovie.[1-10].Fanart, LatestMovie.[1-10].Path
 
LatestEpisode.[1-10].ShowTitle, LatestEpisode.[1-10].EpisodeTitle, LatestEpisode.[1-10].EpisodeNo, LatestEpisode.[1-10].EpisodeSeason, LatestEpisode.[1-10].EpisodeNumber, LatestEpisode.[1-10].Rating, LatestEpisode.[1-10].Plot, LatestEpisode.[1-10].Thumb, LatestEpisode.[1-10].ShowThumb, LatestEpisode.[1-10].SeasonThumb, LatestEpisode.[1-10].Fanart, LatestEpisode.[1-10].Path
 
LatestMusicVideo.[1-10].Title, LatestMusicVideo.[1-10].Thumb, LatestMusicVideo.[1-10].Year, LatestMusicVideo.[1-10].Plot, LatestMusicVideo.[1-10].RunningTime, LatestMusicVideo.[1-10].Path, LatestMusicVideo.[1-10].Artist, LatestMusicVideo.[1-10].Fanart
 
LatestSong.[1-10].Title, LatestSong.[1-10].Artist, LatestSong.[1-10].Album, LatestSong.[1-10].Year, LatestSong.[1-10].Rating, LatestSong.[1-10].Thumb, LatestSong.[1-10].Fanart, LatestSong.[1-10].Path
 
LatestAlbum.[1-10].Title, LatestAlbum.[1-10].Artist, LatestAlbum.[1-10].Year, LatestAlbum.[1-10].Rating, LatestAlbum.[1-10].Thumb, LatestAlbum.[1-10].Fanart, LatestAlbum.[1-10].Path
|
|-
|-
|  <code>Window(Weather).Property(key)</code>
|  <code>PVR.TVNextRecordingDateTime</code>
The weather window has the following info labels.
Start date and time of the next tv recording
Location, Updated, Current.Condition, Current.Temperature, Current.FeelsLike, Current.UVIndex, Current.Wind (From <wind dir.> at <speed> <unit>), Current.WindSpeed, Current.WindDirection, Current.DewPoint, Current.Humidity, Day[0-6].Title, Day[0-6].HighTemp, Day[0-6].LowTemp, Day[0-6].Outlook, WeatherProvider
v17
 
 
Data set in Current.Temperature, Current.FeelsLike, Day[0-6].HighTemp, Day[0-6].LowTemp should be provided in Celsius, and will be autoconverted according to System.TemperatureUnits
|
|}
 
=== Images Available in Kodi ===
 
See '''[[Artwork/Accessing with skins and JSON-RPC]]''' for the general pattern of accessing artwork for media items. Below is a list of other possible images available as InfoLabels.
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" Definition
! Version
|-
|-
|  <code>ListItem.Art(type)</code>
|  <code>PVR.TVNextRecordingTitle</code>
Artwork for the current listitem.
Title of the next tv programme that will be recorded
|
|  v17
|-
|  <code>PVR.TVNowRecordingChannel</code>
|  Channel name of the current tv recording
|  v17
|-
|  <code>PVR.TVNowRecordingChannelIcon</code>
|  Icon of the current recording TV channel
| v17
|-
|-
|  <code>Fanart.Image</code>
|  <code>PVR.TVNowRecordingDateTime</code>
Fanart image for the parent TV Show. Note: Deprecated, use ListItem.Art(tvshow.fanart) instead.
Start date and time of the current tv recording
|
| v17
|-
|-
|  <code>ListItem.Thumb</code>
|  <code>PVR.TVNowRecordingTitle</code>
Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. Note: Deprecated but still available, returns the same as ListItem.Art(thumb).
Title of the tv programme being recorded
|
|  v17
|}
 
=== RDS ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|-
|  <code>ListItem.Icon</code>
|  <code>RDS.Album</code>
Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. If no thumbnail image exists, it will show the default icon.
The collection name to which this track belongs (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>ListItem.ActualIcon</code>
|  <code>RDS.Artist</code>
Shows the default icon of the currently selected item in a list or thumb control.
A person or band/collective generally considered responsible for the work (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>ListItem.Overlay</code>
|  <code>RDS.AudioLanguage</code>
Shows the Overlay Icon status (compressed file [OverlayRAR.png], watched [OverlayWatched.png], unwatched [OverlayUnwatched.png], locked [OverlayLocked.png]) of the currently selected item in a list or thumb control.
The from RDS reported audio language of channel
|
|
|-
|-
|  <code>ListItem.EPGEventIcon</code>
|  <code>RDS.Band</code>
Returns the icon of the EPG programme (if available).
Band/orchestra/accompaniment/musician (Only be available on RadiotextPlus)
| v18
|
|-
|-
|  <code>ListItem.Property(Fanart_Image)</code>
|  <code>RDS.ChannelCountry</code>
Fanart Image currently selected item or of the parent TV show. Note: Deprecated, use ListItem.Art(fanart) or ListItem.Art(tvshow.fanart) instead.
Country where the radio channel is sended
|
|
|-
|-
|  <code>MusicPlayer.Cover</code>
|  <code>RDS.Comment</code>
Cover of currently playing album
Radio station comment string if available (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>MusicPlayer.Property(Fanart_Image)</code>
|  <code>RDS.Composer</code>
Fanart image of the currently playing artist
Name of the original composer/author (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>Player.Art(type)</code>
|  <code>RDS.Conductor</code>
Artwork for the currently playing item.
The artist(s) who performed the work. In classical music this would bethe conductor (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>Player.Icon</code>
|  <code>RDS.EmailHotline</code>
Shows the thumbnail (if it exists) of the currently playing item. If no thumbnail image exists, it will show the icon.
The email adress of the radio stations hotline (if available) (Only be available on RadiotextPlus)
| v18
|
|-
|-
|  <code>Player.StarRating</code>
|  <code>RDS.EmailStudio</code>
|  Returns a value of 0 to 5 as a graphical display from images named rating0.png to rating5.png of the skin
|  The email adress of the radio stations studio (if available) (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.GetLine(number)</code>
|  Returns the last sended RDS text messages on givern number, 0 is thelast and 4 rows are supported (0-3)
|
|-
|  <code>RDS.InfoCinema</code>
|  Information about movies in cinema (if available) (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoCinemaSize</code>
|  Number of rows present in cinema information (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoHoroscope</code>
|  Horoscope; either as one part or as two distinct parts:"key word 99text", e.g. "sign of the zodiac 99blablabla" (if available) (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoHoroscopeSize</code>
|  Number of rows present in horoscope information (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoLottery</code>
|  Raffle / lottery: "key word 99values" (if available) (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoLotterySize</code>
|  Number of rows present in lottery information (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoNews</code>
|  Message / headline (if available) (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>Pvr.NowRecordingChannelIcon</code>
|  <code>RDS.InfoNewsLocal</code>
Channel icon of the programme currently being recorded.
Local information news sended from radio channel (if available) (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>Pvr.NextRecordingChannelIcon</code>
|  <code>RDS.InfoOther</code>
Channel icon of the programme that will be recorded next.
Other information, not especially specified: "key word 99info" (if available) (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>Pvr.EPGEventIcon</code>
|  <code>RDS.InfoOtherSize</code>
Returns the icon of the currently playing EPG programme (if available).
Number of rows present with other informations (Only be available on RadiotextPlus)
| v18
|
|-
|-
|  <code>Skin.String(name)</code>
|  <code>RDS.InfoSport</code>
Returns the image or image folder set by the user via a Skin.SetPath(name) or Skin.SetImage(name) '''[[List of Built In Functions]]'''. Allows skinners to have <span class="nobr">user-customisable</span> images and multiimages.
Result of a game; either as one part or as several distinct parts:"match 99result", e.g. "Bayern München : Borussia 995:5"  (if available) (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>System.AddonIcon(id)</code>
<code>RDS.InfoSportSize</code>
Returns the Icon of the specified addon. Instead of specifying the id directly, one can also use an infolabel (e.g. $INFO[Skin.String(Foo)])
|  Number of rows present in sport information (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>System.ProfileThumb</code>
|  <code>RDS.InfoStock</code>
Shows the Thumbnail image of the currently logged in Kodi user
Quote information; either as one part or as several distinct parts:"name 99latest value 99change 99high 99low 99volume" (if available) (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>VideoPlayer.Cover</code>
|  <code>RDS.InfoStockSize</code>
Cover of currently playing movie.  Note: Deprecated, use Player.Art(type) instead.
Number of rows present in stock information (Only be available on RadiotextPlus)
|
|
|-
|-
|  <code>Weather.ConditionsIcon</code>
|  <code>RDS.InfoWeather</code>
Image of current weather conditions (NOTE: Can be used to load/refresh weather conditions)
Weather informations sended from radio channel (if available) (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.InfoWeatherSize</code>
Number of rows present in weather information (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.PhoneHotline</code>
|  The telephone number of the radio station's hotline (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.PhoneStudio</code>
|  The telephone number of the radio station's studio (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.ProgEditStaff</code>
|  Name of the editorial staff; e.g. name of editorial journalist (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.ProgHomepage</code>
|  Link to radio station homepage (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.ProgHost</code>
|  Name of the host of the radio show
|
|-
|  <code>RDS.ProgNext</code>
|  Next played program name (if available)@note becomes also be set from epg if from RDS not available
|
|-
|  <code>RDS.ProgNow</code>
|  Now played program name@note becomes also be set from epg if from RDS not available
|
|-
|  <code>RDS.ProgStation</code>
|  Name of the radio channel@note becomes also be set from epg if from RDS not available
|
|-
|  <code>RDS.ProgStyle</code>
|  Human readable string about radiostyle defined from RDS or RBDS
|
|-
|  <code>RDS.RadioStyle</code>
|  The from radio channel used style of currently played part, e.g "popmusic", "news" or "weather"
|
|-
|  <code>RDS.SmsStudio</code>
|  The sms number of the radio stations studio (to send directly a sms to the studio) (if available) (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.Title</code>
|  Title of item; e.g. track title of an album (Only be available on RadiotextPlus)
|
|-
|  <code>RDS.TrackNumber</code>
|  The track number of the item on the album on which it was originallyreleased. (Only be available on RadiotextPlus)
|
|}
 
=== Skin ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Skin.AspectRatio</code>
|  Returns the closest aspect ratio match using the resolution info from the skin's addon.xml file.
|
|-
|  <code>Skin.CurrentColourTheme</code>
|  Returns the current selected colour theme of the skin.
|
|-
|  <code>Skin.CurrentTheme</code>
|  Returns the current selected skin theme.
|
|-
|  <code>Skin.Font</code>
|  Returns the current fontset from Font.xml.
|  v18 addition
|-
|  <code>Skin.Numeric(settingid)</code>
|  '''Returns'''
:return the setting value as an integer/numeric value.
'''See also'''
:<code>Skin.SetNumeric(settingid)</code>
|
|-
|  <code>Skin.String(name)</code>
|  Returns the <span class="nobr">user-set</span> skin string, set via the Skin.SetString(name) '''[[List of Built In Functions]]'''. Allows skinners to have <span class="nobr">user-customisable</span> labels.
|
|-
|  <code>Skin.TimerElapsedSecs(timer)</code>
|  '''Returns'''
:The elapsed time in seconds for the provided <code>timer</code>.
'''Parameters'''
:timer - the timer name
|
|}
 
=== Slideshow ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Slideshow.Altitude</code>
|  Shows the altitude in meters where the current picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
|
|-
|  <code>Slideshow.Aperture</code>
|  Shows the F-stop used to take the current picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
|
|-
|  <code>Slideshow.Author</code>
|  Shows the name of the person involved in writing about the current picture. This is the value of the IPTC Writer tag (hex code 0x7A).
|
|-
|  <code>Slideshow.Byline</code>
|  Shows the name of the person who created the current picture.  This is the value of the IPTC Byline tag (hex code 0x50).
|
|-
|  <code>Slideshow.BylineTitle</code>
|  Shows the title of the person who created the current picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
|
|-
|  <code>Slideshow.CameraMake</code>
|  Shows the manufacturer of the camera used to take the current picture. This is the value of the EXIF Make tag (hex code 0x010F).
|
|-
|  <code>Slideshow.CameraModel</code>
|  Shows the manufacturer's model name or number of the camera used to take the current picture. This is the value of the EXIF Model tag (hex code 0x0110).
|
|-
|  <code>Slideshow.Caption</code>
|  Shows a description of the current picture. This is the value of the IPTC Caption tag (hex code 0x78).
|
|-
|  <code>Slideshow.Category</code>
|  Shows the subject of the current picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
|
|-
|  <code>Slideshow.CCDWidth</code>
|  Shows the width of the CCD in the camera used to take the current picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
|
|-
|  <code>Slideshow.City</code>
|  Shows the city where the current picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
|
|-
|  <code>Slideshow.Colour</code>
|  Shows whether the current picture is "Colour" or "Black and White".
|
|-
|  <code>Slideshow.CopyrightNotice</code>
|  Shows the copyright notice of the current picture. This is the value of the IPTC Copyright tag (hex code 0x74).
|
|-
|  <code>Slideshow.Country</code>
|  Shows the full name of the country where the current picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
|
|-
|  <code>Slideshow.CountryCode</code>
|  Shows the country code of the country where the current picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
|
|-
|  <code>Slideshow.Credit</code>
|  Shows who provided the current picture. This is the value of the IPTC Credit tag (hex code 0x6E).
|
|-
|  <code>Slideshow.DigitalZoom</code>
|  Shows the digital zoom ratio when the current picture was taken. This is the value of the EXIF .DigitalZoomRatio tag (hex code 0xA404). 
|
|-
|  <code>Slideshow.EXIFComment</code>
|  Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
|
|-
|  <code>Slideshow.EXIFDate</code>
|  Shows the localized date of the current picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
|  <code>Slideshow.EXIFDescription</code>
|  Shows a short description of the current picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
|
|-
|  <code>Slideshow.EXIFSoftware</code>
|  Shows the name and version of the firmware used by the camera that took the current picture. This is the value of the EXIF Software tag (hex code 0x0131).
|
|-
|  <code>Slideshow.EXIFTime</code>
|  Shows the date/timestamp of the current picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
|  <code>Slideshow.Exposure</code>
|  Shows the class of the program used by the camera to set exposure when the current picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
|
|-
|  <code>Slideshow.ExposureBias</code>
|  Shows the exposure bias of the current picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
|
|-
|  <code>Slideshow.ExposureMode</code>
|  Shows the exposure mode of the current picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
|
|-
|  <code>Slideshow.ExposureTime</code>
|  Shows the exposure time of the current picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
|
|-
|  <code>Slideshow.Filedate</code>
|  Shows the file date of the current picture
|
|-
|  <code>Slideshow.Filename</code>
|  Shows the file name of the current picture
|
|-
|  <code>Slideshow.Filesize</code>
|  Shows the file size of the current picture
|
|-
|  <code>Slideshow.FlashUsed</code>
|  Shows the status of flash when the current picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209). 
|
|-
|  <code>Slideshow.FocalLength</code>
|  Shows the focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
|
|-
|  <code>Slideshow.FocusDistance</code>
|  Shows the distance to the subject, in meters. This is the value of the EXIF SubjectDistance tag (hex code 0x9206).
|
|-
|  <code>Slideshow.Headline</code>
|  Shows a synopsis of the contents of the current picture. This is the value of the IPTC Headline tag (hex code 0x69).
|
|-
|  <code>Slideshow.ImageType</code>
|  Shows the color components of the current picture. This is the value of the IPTC ImageType tag (hex code 0x82).
|
|-
|  <code>Slideshow.IPTCDate</code>
|  Shows the date when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
|
|-
|  <code>Slideshow.ISOEquivalence</code>
|  Shows the ISO speed of the camera when the current picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
|
|-
|  <code>Slideshow.Keywords</code>
|  Shows keywords assigned to the current picture. This is the value of the IPTC Keywords tag (hex code 0x19).
|
|-
|  <code>Slideshow.Latitude</code>
|  Shows the latitude where the current picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
|
|-
|  <code>Slideshow.LightSource</code>
|  Shows the kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
|
|-
|  <code>Slideshow.LongEXIFDate</code>
|  Shows only the localized date of the current picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
|  <code>Slideshow.LongEXIFTime</code>
|  Shows the date/timestamp of the current picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
|
|-
|  <code>Slideshow.Longitude</code>
|  Shows the longitude where the current picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
|
|-
|  <code>Slideshow.MeteringMode</code>
|  Shows the metering mode used when the current picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
|
|-
|  <code>Slideshow.ObjectName</code>
|  Shows a shorthand reference for the current picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
|
|-
|  <code>Slideshow.Orientation</code>
|  Shows the orientation of the current picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
|
|-
|  <code>Slideshow.Path</code>
|  Shows the file path of the current picture
|
|-
|  <code>Slideshow.Process</code>
|  Shows the process used to compress the current picture
|
|-
|  <code>Slideshow.ReferenceService</code>
|  Shows the Service Identifier of a prior envelope to which the current picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
|
|-
|  <code>Slideshow.Resolution</code>
|  Shows the dimensions of the current picture (Width x Height)
|
|-
|  <code>Slideshow.SlideComment</code>
|  Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.EXIFComment.
|
|-
|  <code>Slideshow.SlideIndex</code>
|  Shows the slide index of the current picture
|
|-
|  <code>Slideshow.Source</code>
|  Shows the original owner of the current picture. This is the value of the IPTC Source tag (hex code 0x73).
|
|-
|  <code>Slideshow.SpecialInstructions</code>
|  Shows other editorial instructions concerning the use of the current picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
|
|-
|  <code>Slideshow.State</code>
|  Shows the State/Province where the current picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
|
|-
|  <code>Slideshow.Sublocation</code>
|  Shows the location within a city where the current picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
|
|-
|  <code>Slideshow.SupplementalCategories</code>
|  Shows supplemental category codes to further refine the subject of the current picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
|
|-
|  <code>Slideshow.TimeCreated</code>
|  Shows the time when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
|
|-
|  <code>Slideshow.TransmissionReference</code>
|  Shows a code representing the location of original transmission of the current picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
|
|-
|  <code>Slideshow.Urgency</code>
|  Shows the urgency of the current picture. Values are 1-9. The 1 is most urgent. Some image management programs use urgency to indicate picture rating, where urgency 1 is 5 stars and urgency 5 is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
|
|-
|  <code>Slideshow.WhiteBalance</code>
|  Shows the white balance mode set when the current picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
|
|}
 
=== System ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>System.AddonTitle(id)</code>
|  Returns the title of the addon with the given id
|
|-
|  <code>System.AddonUpdateCount</code>
|  The number of available addon updates
|  v19
|-
|  <code>System.AddonVersion(id)</code>
|  Returns the version of the addon with the given id
|
|-
|  <code>System.AlarmPos</code>
|  Shutdown Timer position
|
|-
|  <code>System.BatteryLevel</code>
|  Returns the remaining battery level in range 0-100
|
|-
|  <code>System.BuildDate</code>
|  Date of build
|
|-
|  <code>System.BuildVersion</code>
|  version of build
|
|-
|  <code>System.BuildVersionCode</code>
|  The internal version of the kodi build
|  v19
|-
|  <code>System.BuildVersionGit</code>
|  The git version (sha) of the kodi build
|  v19
|-
|  <code>System.BuildVersionShort</code>
|  '''Returns'''
:The shorter string with version of build.
|
|-
|  <code>System.CoreUsage(id)</code>
|  Displays the usage of the cpu core with the given 'id'
|
|-
|  <code>System.CpuFrequency</code>
|  System cpu frequency
|
|-
|  <code>System.CPUTemperature</code>
|  Current CPU temperature
|
|-
|  <code>System.CpuUsage</code>
|  Displays the cpu usage for each individual cpu core.
|
|-
|  <code>System.CurrentControl</code>
|  Current focused control
|
|-
|  <code>System.CurrentControlID</code>
|  ID of the currently focused control.
|
|-
|  <code>System.CurrentWindow</code>
|  Current Window we are in
|
|-
|  <code>System.Date</code>
|  Current date
|
|-
|  <code>System.Date(format)</code>
|  Show current date using format, available markings: d (day of month 1-31), dd (day of month 01-31), ddd (short day of the week Mon-Sun), DDD (long day of the week Monday-Sunday), m (month 1-12), mm (month 01-12), mmm (short month name Jan-Dec), MMM (long month name January-December), yy (2-digit year), yyyy (4-digit year). Added after dharma.
|
|-
|  <code>System.DVDLabel</code>
|  Label of the disk in the <span class="nobr">DVD-ROM</span> drive
|
|-
|  <code>System.FanSpeed</code>
|  Current fan speed
|
|-
|  <code>System.FPS</code>
|  Current rendering speed (frames per second)
|
|-
|  <code>System.FreeMemory</code>
|  Amount of free memory in Mb
|
|-
|  <code>System.FreeSpace</code>
|  Total Freespace on the drive
|
|-
|  <code>System.FreeSpacePercent</code>
|  Total Freespace Percent on the drive
|
|-
|  <code>System.FriendlyName</code>
|  Returns the Kodi instance name. It will auto append (%hostname%) in case the device name was not changed. e.g. "Kodi (htpc)"
|
|-
|  <code>System.GetBool(boolean)</code>
|  '''Returns'''
:The value of any standard system boolean setting.
{{highlight|'''Note'''<br>Will not work with settings in advancedsettings.xml}}
|
|-
|  <code>System.GPUTemperature</code>
|  Current GPU temperature
|
|-
|  <code>System.HddTemperature</code>
|  Hdd temperature
|
|-
|  <code>System.InternetState</code>
|  Will return the internet state, 'connected' or 'not connected' (localized)
|
|-
|  <code>System.KernelVersion (deprecated)</code>
|  System name + kernel version
|
|-
|  <code>System.Language</code>
|  Shows the current language
|
|-
|  <code>System.Locale(type)</code>
|  '''Returns'''
:Locale-specific information depending on the requested type.
'''Parameters'''
:type - Can be one of the following:
:region The currently selected region name within the selected language ( <code>System.Language</code> ).
:iso The country code of the currently selected region as specified in langinfo.xml.
:[Removed options] <code>timezonecountry</code> and <code>timezone</code> from <code>System.Locale(type)</code>
|
|-
|  <code>System.Memory(format)</code>
|  Available formats: used, used.percent, free, free.percent, total
|
|-
|  <code>System.OSVersionInfo</code>
|  System name + kernel version
|
|-
|  <code>System.PrivacyPolicy</code>
|  '''Returns'''
:The official Kodi privacy policy.
|
|-
|  <code>System.ProfileAutoLogin</code>
|  The profile Kodi will auto login to
|
|-
|  <code>System.ProfileCount</code>
|  Shows the number of defined profiles
|
|-
|  <code>System.ProfileName</code>
|  Shows the User name of the currently logged in Kodi user
|
|-
|  <code>System.Progressbar</code>
|  The percentage of the currently active progress.
|
|-
|  <code>System.ScreenHeight</code>
|  Height of screen in pixels
|
|-
|  <code>System.ScreenMode</code>
|  Screenmode (e.g. windowed / fullscreen)
|
|-
|  <code>System.ScreenResolution</code>
|  Screen resolution
|
|-
|  <code>System.ScreenWidth</code>
|  Width of screen in pixels
|
|-
|  <code>System.StartupWindow</code>
|  The Window Kodi will load on startup
|
|-
|  <code>System.StereoscopicMode</code>
|  The prefered stereoscopic mode (settings > video > playback)
|
|-
|  <code>System.SupportedHDRTypes</code>
|  '''Returns'''
:The display's supported HDR types.
|
|-
|  <code>System.TemperatureUnits</code>
|  Shows Celsius or Fahrenheit symbol
|
|-
|  <code>System.Time</code>
|  Current time
|
|-
|  <code>System.Time(format)</code>
|  Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss). (xx) option added after dharma
|
|-
|  <code>System.TotalSpace</code>
|  Totalspace on the drive
|
|-
|  <code>System.TotalUptime</code>
|  System total uptime
|
|-
|  <code>System.Uptime</code>
|  System current uptime
|
|-
|  <code>System.UsedSpace</code>
|  Total Usedspace on the drive
|
|-
|  <code>System.UsedSpacePercent</code>
|  Total Usedspace Percent on the drive
|
|-
|  <code>System.VideoEncoderInfo</code>
|  video encoder info
|
|}
 
=== Visualisation ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Visualisation.Name</code>
|  Shows the name of the visualisation.
|
|-
|  <code>Visualisation.Preset</code>
|  Shows the current preset of the visualisation.
|
|}
 
=== Weather ===
 
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Weather.Data(property)</code>
|  '''Returns'''
:Weather data, as specified by the parameter.
|
|-
|  <code>Weather.LastUpdated</code>
|  '''Returns'''
:The localized date and time weather data were last updated, empty string if not available.
|
|}
 
=== Weather labels ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Weather.Conditions</code>
|  Current weather conditions – this is looked up in a background process.
|
|-
|  <code>Weather.fanartcode</code>
|  Current weather fanartcode.
|
|-
|  <code>Weather.Location</code>
|  City/town which the above two items are for
|
|-
|  <code>Weather.plugin</code>
|  Current weather plugin.
|
|-
|  <code>Weather.Temperature</code>
|  Current weather temperature
|
|}
 
=== Window ===
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Window(AddonBrowser).Property(Updated)</code>
|  Shows the date and time the addon repo was last checked for updates
|
|-
|  <code>Window(Home).Property(key)</code>
|  The home window has the following info labels.
Movies.Count, Movies.Watched, Movies.UnWatched, TVShows.Count, TVShows.Watched, TVShows.UnWatched, Episodes.Count, Episodes.Watched, Episodes.UnWatched, MusicVideos.Count, MusicVideos.Watched, MusicVideos.UnWatched, Music.SongsCount, Music.AlbumsCount, Music.ArtistsCount
 
LatestMovie.[1-10].Title, LatestMovie.[1-10].Year, LatestMovie.[1-10].RunningTime, LatestMovie.[1-10].Rating, LatestMovie.[1-10].Plot, LatestMovie.[1-10].Trailer, LatestMovie.[1-10].Thumb, LatestMovie.[1-10].Fanart, LatestMovie.[1-10].Path
 
LatestEpisode.[1-10].ShowTitle, LatestEpisode.[1-10].EpisodeTitle, LatestEpisode.[1-10].EpisodeNo, LatestEpisode.[1-10].EpisodeSeason, LatestEpisode.[1-10].EpisodeNumber, LatestEpisode.[1-10].Rating, LatestEpisode.[1-10].Plot, LatestEpisode.[1-10].Thumb, LatestEpisode.[1-10].ShowThumb, LatestEpisode.[1-10].SeasonThumb, LatestEpisode.[1-10].Fanart, LatestEpisode.[1-10].Path
 
LatestMusicVideo.[1-10].Title, LatestMusicVideo.[1-10].Thumb, LatestMusicVideo.[1-10].Year, LatestMusicVideo.[1-10].Plot, LatestMusicVideo.[1-10].RunningTime, LatestMusicVideo.[1-10].Path, LatestMusicVideo.[1-10].Artist, LatestMusicVideo.[1-10].Fanart
 
LatestSong.[1-10].Title, LatestSong.[1-10].Artist, LatestSong.[1-10].Album, LatestSong.[1-10].Year, LatestSong.[1-10].Rating, LatestSong.[1-10].Thumb, LatestSong.[1-10].Fanart, LatestSong.[1-10].Path
 
LatestAlbum.[1-10].Title, LatestAlbum.[1-10].Artist, LatestAlbum.[1-10].Year, LatestAlbum.[1-10].Rating, LatestAlbum.[1-10].Thumb, LatestAlbum.[1-10].Fanart, LatestAlbum.[1-10].Path
|
|-
|  <code>Window(Weather).Property(key)</code>
|  The weather window has the following info labels.
Location, Updated, Current.Condition, Current.Temperature, Current.FeelsLike, Current.UVIndex, Current.Wind (From <wind dir.> at <speed> <unit>), Current.WindSpeed, Current.WindDirection, Current.DewPoint, Current.Humidity, Day[0-6].Title, Day[0-6].HighTemp, Day[0-6].LowTemp, Day[0-6].Outlook, WeatherProvider
 
 
Data set in Current.Temperature, Current.FeelsLike, Day[0-6].HighTemp, Day[0-6].LowTemp should be provided in Celsius, and will be autoconverted according to System.TemperatureUnits
|
|-
|  <code>Window([window]).Property(key)</code>
|  Window property. (key can be any value, optional window can be id or name)
|
|-
|  <code>Window.Property(Addon.ID)</code>
|  Returns the id of the selected addon, in DialogAddonSettings.xml
|
|-
|  <code>Window.Property(IsRadio)</code>
|  Returns "true" if the window is a radio window, empty string otherwise (for use in the PVR windows)
|
|-
|  <code>Window.Property(xmlfile)</code>
|  Displays the name of the xml file currently shown
|
|}
 
=== Images Available in Kodi ===
 
See '''[[Artwork/Accessing with skins and JSON-RPC]]''' for the general pattern of accessing artwork for media items. Below is a list of other possible images available as InfoLabels.
{|  class="wikitable sortable" width="100%"
! InfoLabels
! style="80%" | Description
! Version
|-
|  <code>Fanart.Image</code>
|  Fanart image for the parent TV Show. Note: Deprecated, use ListItem.Art(tvshow.fanart) instead.
|
|-
|  <code>ListItem.ActualIcon</code>
|  Shows the default icon of the currently selected item in a list or thumb control.
|
|-
|  <code>ListItem.Art(type)</code>
|  Artwork for the current listitem.
|
|-
|  <code>ListItem.EPGEventIcon</code>
|  Returns the icon of the EPG programme (if available).
|  v18
|-
|  <code>ListItem.Icon</code>
|  Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. If no thumbnail image exists, it will show the default icon.
|
|-
|  <code>ListItem.Overlay</code>
|  Shows the Overlay Icon status (compressed file [OverlayRAR.png], watched [OverlayWatched.png], unwatched [OverlayUnwatched.png], locked [OverlayLocked.png]) of the currently selected item in a list or thumb control.
|
|-
|  <code>ListItem.Property(Fanart_Image)</code>
|  Fanart Image currently selected item or of the parent TV show. Note: Deprecated, use ListItem.Art(fanart) or ListItem.Art(tvshow.fanart) instead.
|
|-
|  <code>ListItem.Thumb</code>
|  Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. Note: Deprecated but still available, returns the same as ListItem.Art(thumb).
|
|-
|  <code>MusicPlayer.Cover</code>
|  Cover of currently playing album
|
|-
|  <code>MusicPlayer.Property(Fanart_Image)</code>
|  Fanart image of the currently playing artist
|
|-
|  <code>Player.Art(type)</code>
|  Artwork for the currently playing item.
|
|-
|  <code>Player.Icon</code>
|  Shows the thumbnail (if it exists) of the currently playing item. If no thumbnail image exists, it will show the icon.
|  v18
|-
|  <code>Player.StarRating</code>
|  Returns a value of 0 to 5 as a graphical display from images named rating0.png to rating5.png of the skin
|
|-
|  <code>Pvr.EPGEventIcon</code>
|  Returns the icon of the currently playing EPG programme (if available).
|  v18
|-
|  <code>Pvr.NextRecordingChannelIcon</code>
|  Channel icon of the programme that will be recorded next.
|
|-
|  <code>Pvr.NowRecordingChannelIcon</code>
|  Channel icon of the programme currently being recorded.
|
|-
|  <code>Skin.String(name)</code>
|  Returns the image or image folder set by the user via a Skin.SetPath(name) or Skin.SetImage(name) '''[[List of Built In Functions]]'''. Allows skinners to have <span class="nobr">user-customisable</span> images and multiimages.
|
|-
|  <code>System.AddonIcon(id)</code>
|  Returns the Icon of the specified addon. Instead of specifying the id directly, one can also use an infolabel (e.g. $INFO[Skin.String(Foo)])
|
|-
|  <code>System.ProfileThumb</code>
|  Shows the Thumbnail image of the currently logged in Kodi user
|
|-
|  <code>VideoPlayer.Cover</code>
|  Cover of currently playing movie.  Note: Deprecated, use Player.Art(type) instead.
|
|-
|  <code>Weather.ConditionsIcon</code>
|  Image of current weather conditions (NOTE: Can be used to load/refresh weather conditions)
|
|-
|  <code>Window(Weather).Property(key)</code>
|  The weather window has the following info images.
Current.ConditionIcon, Day[0-6].OutlookIcon, Current.FanartCode, Day[0-6].FanartCode, WeatherProviderLogo
|
|
|-
|-
|  <code>Window([window]).Property(key)</code>
|  <code>Window([window]).Property(key)</code>
|  Window property. (key can be any value, optional window can be id or name)
|  Window property. (key can be any value, optional window can be id or name)
|
|-
|  <code>Window(Weather).Property(key)</code>
|  The weather window has the following info images.
Current.ConditionIcon, Day[0-6].OutlookIcon, Current.FanartCode, Day[0-6].FanartCode, WeatherProviderLogo
|
|
|}
|}

Latest revision as of 13:57, 22 June 2026

  ▶ Development ▶ Add-on development ▶ Skinning ▶ InfoLabels


Skins can use infolabels with $INFO[infolabel] or the <info> tag. Scripts can read infolabels with xbmc.getInfoLabel('infolabel').

Addon

InfoLabels Description Version
Addon.SettingInt(addon_id,setting_id) Returns
The integer value of the setting setting_id belonging to the addon with the id addon_id.

Parameters

addon_id - The id of the addon
setting_id - The addon setting

Note
The provided setting with setting_id must be an integer setting type.
Otherwise it will return the integer info default value (which is 0).

v20
Addon.SettingStr(addon_id,setting_id) Returns
The string value of the setting setting_id belonging to the addon with the id addon_id.

Parameters

addon_id - The id of the addon
setting_id - The addon setting
v20

Container

Note
If no id is specified it grabs the current container.

InfoLabels Description Version
Container(id).Column Returns
The column number of the focused position in a panel container.
Container(id).CurrentItem Returns
The current item in the container or grouplist with given id.
Container(id).CurrentPage Returns
The current page in the container with given id.
Container(id).ListItem(offset).Property Returns
The property of the ListItem with a given offset.

Parameters

offset - The offset for the listitem.

Note
Property has to be replaced with Label, Label2, Icon, etc.
Example: Container(50).Listitem(2).Label

Container(id).ListItemAbsolute(x).[infolabel] Returns
The infolabel for an item in a container.

Parameters

x - The absolute position in the container.

Note
Example: Container(50).ListItemAbsolute(4).Genre

Container(id).ListItemNoWrap(offset).Property Returns
The same as Container(id).ListItemNoWrap(offset).Property but it won't wrap.
This means if the last item of a list is focused, ListItemNoWrap(1) will be empty while ListItem(1) will return the first item of the list.

Parameters

offset - The offset for the listitem.

Note
Property has to be replaced with Label, Label2, Icon, etc.
Example: Container(50).ListitemNoWrap(1).Plot

Container(id).ListItemPosition(x).[infolabel] Returns
The infolabel for an item in a container.

Parameters

x - The position in the container relative to the cursor position.

Note
Example: Container(50).ListItemAbsolute(4).Genre

Container(id).NumAllItems Returns
The number of all items in the container or grouplist with given id including parent folder item.
v18
Container(id).NumItems Returns
The number of items in the container or grouplist with given id excluding parent folder item.
Container(id).NumNonFolderItems Returns
The number of items in the container or grouplist with given id excluding all folder items (e.g. pvr recordings folders, parent ".." folder, "All albums", etc).
v18
Container(id).NumPages Returns
The number of pages in the container with given id.
Container(id).Position Returns
The current focused position of container / grouplist (id) as a numeric label.
Container(id).Row Returns
The row number of the focused position in a panel container.
Container(id).TotalUnWatched Returns
The number of unwatched items in the container.
v16
Container(id).TotalWatched Returns
The number of watched items in the container.
v16
Container.Art(type) Returns
The path to the art image file for the given type of the current container.

Parameters

type - The art type to request.

Todo
List of all art types.

v16

v15

Container.Content Returns
The content of the current container.
v16
Container.FolderName Returns
The top most folder in currently displayed folder.
Container.FolderPath Returns
The complete path of currently displayed folder.
Container.PluginCategory Returns
The current plugins category (set by the scripter).
v17
Container.PluginName Returns
The current plugins base folder name.
Container.Property(addoncategory) Returns
The current add-on category.
Container.Property(reponame) Returns
The current add-on repository name.
Container.ShowPlot Returns
The TV Show plot of the current container and can be used at season and episode level.
Container.ShowTitle Returns
The TV Show title of the current container and can be used at season and episode level.
v17
Container.SortMethod Returns
The current sort method (returns a localized value).
Container.SortOrder Returns
The current sort order (Ascending/Descending).
v16
Container.Totaltime Returns
The total time of all items in the current container.
Container.ViewCount Returns
The number of available skin view modes for the current container listing.
v17
Container.Viewmode Returns
The current viewmode (e.g. list, icons, etc).

Control

InfoLabels Description Version
Control.GetLabel(id)[.index()] Returns
The label value or texture name of the control with the given id.

Parameters

id - The id of the control.
index - [opt] Optionally you can specify index(1) to retrieve label2 from an Edit control.
v15

Fanart

Note
Colors are arranged Lightest to Darkest.

InfoLabels Description Version
Fanart.Color1 Returns the first of three colors included in the currently selected Fanart theme for the parent TV Show.
Fanart.Color2 Returns the second of three colors included in the currently selected Fanart theme for the parent TV Show.
Fanart.Color3 Returns the third of three colors included in the currently selected Fanart theme for the parent TV Show.

Game

InfoLabels Description Version
Game.Developer Returns
The developer of the game (e.g. Activision).
v18
Game.GameClient Returns
The add-on ID of the emulator used to play the game.
v18
Game.Genres Returns
The genre of the game (e.g. Action).
v18
Game.Overview Returns
The game description.
v18
Game.Platform Returns
The platform the game runs on (e.g. Atari 2600).
v18
Game.Publisher Returns
The publishing company of the game (e.g. Nintendo).
v18
Game.Title Returns
The name of the game.
v18
Game.Year Returns
The year the game was released.
v18

Integer

InfoLabels Description Version
Integer.ValueOf(number) Returns
An integer info label that represents the provided number

Parameters

number - the number to compute

Note
Example: Integer.ValueOf(4) will be evaluated to 4.
Will return -1 if not able to convert the provided value to an integer. Example: Integer.ValueOf(some string) will evaluate to -1 as the provided argument is not an integer.

ListItem

InfoLabels Description Version
ListItem.AddonBroken Deprecated! use ListItem.AddonLifecycleDesc instead.
ListItem.AddonCreator Returns
The name of the author the currently selected addon.
ListItem.AddonDescription Returns
The full description of the currently selected addon.
ListItem.AddonDisclaimer Returns
The disclaimer of the currently selected addon.
ListItem.AddonInstallDate Returns
The date the addon was installed.
ListItem.AddonLastUpdated Returns
The date the addon was last updated.
ListItem.AddonLastUsed Returns
The date the addon was used last.
ListItem.AddonLifecycleDesc Returns
The description of the lifecycle type (e.g. broken due to website changes).
v19
ListItem.AddonLifecycleType Returns
The lifecycle type of the addon as a localized string (e.g. normal, broken, or deprecated).
v19
ListItem.AddonName Returns
The name of the currently selected addon.
ListItem.AddonNews Returns
A brief changelog, taken from the addons' addon.xml file.
ListItem.AddonOrigin Returns
The name of the repository the add-on originates from.
ListItem.AddonSize Returns
The filesize of the addon.
ListItem.AddonSummary Returns
A short description of the currently selected addon.
ListItem.AddonType Returns
The type of the currently selected addon (e.g. screensaver, script, skin, etc).
ListItem.AddonVersion Returns
The version of the currently selected addon.
ListItem.Album Returns
The album of the currently selected song in a container.
ListItem.AlbumArtist Returns
The artist of the currently selected album in a list.
ListItem.AlbumStatus Returns
The Musicbrainz release status of the album (e.g. offical, bootleg, promotion, etc).
v19
ListItem.Appearances Returns
The number of movies featuring the selected actor or directed by the selected director.
v17
ListItem.Artist Returns
The artist of the currently selected song in a container.
ListItem.AudioChannels Returns
The number of audio channels of the currently selected video (e.g. 1, 2, 4, 5, 6, 7, 8, 10, etc).
ListItem.AudioCodec Returns
The audio codec of the currently selected video.
Possible values:
  • aac
  • aac_latm
  • aac_lc*
  • aac_ltp*
  • aac_ssr*
  • ac3
  • aif
  • aifc
  • aiff
  • alac
  • ape
  • avc
  • cdda
  • dca**
  • dts***
  • dolbydigital
  • dtshd_hra
  • dtshd_ma
  • dtshd_ma_x*
  • dtshd_ma_x_imax*
  • dtsma
  • eac3
  • eac3_ddp_atmos*
  • flac
  • he_aac*
  • he_aac_v2*
  • mp1
  • mp2
  • mp3
  • mp3float
  • ogg
  • opus
  • pcm
  • pcm_bluray
  • pcm_s16le
  • pcm_s24le
  • truehd
  • truehd_atmos*
  • vorbis
  • wav
  • wavpack
  • wmapro
  • wmav2
** note: dca replaced dts in 2011. Deprecated in 2026 / v22.
*** note: dts used before 2011 and reintroduced in 2026 / v22.
*v22
ListItem.AudioLanguage Returns
The audio language of the currently selected video as an ISO 639-2 three character code (e.g. eng, epo, deu).
ListItem.BitRate Returns
The actual bitrate for CBR or average bitrate for VBR of the currently selected song.
v19
ListItem.BPM Returns
The Beats Per Minute of the currently selected song.
v19
ListItem.Cast Returns
The list of cast members, separated by carriage returns, for use in dialogvideoinfo.xml.
ListItem.Cast(separator) Returns
A list of cast members, separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
ListItem.CastAndRole Returns
The list of cast members and roles, separated by carriage returns. Every cast/role combination is formatted 'cast' as 'role' where 'as' is localised, for use in dialogvideoinfo.xml.
ListItem.CastAndRole(separator) Returns
A list of cast members and roles, separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
ListItem.ChannelGroup Returns
The channel group of the selected item ( PVR ).
ListItem.ChannelLogo Returns
The logo of the currently selected radio or TV channel (PVR).
v22
ListItem.ChannelName Returns
The name of current selected TV channel in a container (PVR).
ListItem.ChannelName Returns
The channel name of the selected item (PVR).
ListItem.ChannelNumber Returns
The channel number of the selected item (PVR).
ListItem.ChannelNumberLabel Returns
The channel and subchannel number of the currently selected channel that's currently playing (PVR).
ListItem.Comment Returns
The comment assigned to the item (PVR/MUSIC).
ListItem.ContributorAndRole Returns
The list of all people and their role who've contributed to the selected song.
ListItem.Contributors Returns
The list of all people who've contributed to the selected song.
ListItem.Country Returns
The production country of the currently selected movie in a container.
ListItem.CurrentItem Returns
The current index of the item in a container starting at 1.
v19
ListItem.Date Returns
The file date of the currently selected song or movie in a container, the aired date of an episode, or the day, start time, and end time of the currently selected TV programme (PVR).
ListItem.DateAdded Returns
The date the currently selected item was added to the library or date and time of an event in the EventLog window.
ListItem.DateTime Returns
The date and time a certain event happened (event log).
ListItem.DBID Returns
The database id of the currently selected ListItem in a container.
ListItem.DBTYPE Returns
The database type of the ListItem.DBID for videos (video, movie, set, tvshow, season, episode, musicvideo) or for audio (music, song, album, artist).

Note
With season, the "*all seasons" entry does give a DBTYPE "season" and a DBID, but you can't get the details of that entry since it's a virtual entry in the Video Library.

ListItem.DecodedFileNameAndPath Returns
The full path with filename of the currently selected song or movie in a container decoded.
ListItem.Developer Returns
The game developer (e.g. "Square") (RETROPLAYER).
ListItem.Director Returns
The director of the currently selected movie in a container.
ListItem.Director(separator) Returns
A list of directors, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
ListItem.DiscNumber Returns
The disc number of the currently selected song in a container.
ListItem.DiscTitle Returns
The disc title of the currently selected album or song.
v19
ListItem.Duration[(format)] Returns
The song or movie duration of the currently selected movie in a container. Optionally specify a time format, hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
ListItem.EndDate Returns
The end date of the selected item (PVR).
ListItem.EndTime Returns
The end time of current selected TV programme in a container (PVR).
ListItem.EndTimeResume Returns
The time a video will end if you resume it, instead of playing it from the beginning.
ListItem.EpgEventTitle Returns
The title of the epg event associated with the item, if any.
ListItem.Episode Returns
The episode number value for the currently selected episode. It also shows the number of total, watched or unwatched episodes for the currently selected TV show or season, based on the the current watched filter.
ListItem.EpisodeName Returns
The name of the episode if the selected EPG item is a TV Show (PVR).
ListItem.EpisodePart Returns
string containing the number of parts of a single episode - empty if no data provided
ListItem.ExpirationDate Returns
The expiration date of the selected item in a container, empty string if not supported.
ListItem.ExpirationTime Returns
The expiration time of the selected item in a container, empty string if not supported
ListItem.FileExtension Returns
The file extension (without leading dot) of the currently selected item in a container.
ListItem.FileName Returns
The filename of the currently selected song or movie in a container.
ListItem.FileNameAndPath Returns
The full path with filename of the currently selected song or movie in a container.
ListItem.FileNameNoExtension Returns
The filename without its extension.
v19
ListItem.FolderName Returns
The top most folder of the path of the currently selected song or movie in a container.
ListItem.FolderPath Returns
The complete path of the currently selected song or movie in a container (without user details).
ListItem.GameClient Returns
The add-on ID of the game client (a.k.a. emulator) to use for playing the game (e.g. game.libretro.fceumm) (RETROPLAYER).
ListItem.Genre Returns
The genre of the currently selected song, album, or movie in a container.
ListItem.Genre(separator) Returns
A list of genres, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for videos or music. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
ListItem.Genres Returns
The game genres (e.g. "["Action","Strategy"]") (RETROPLAYER).
ListItem.HdrDetail Returns
String containing details for the HDR type (currently only for DV - profile and EL type) or empty if not HDR. Prints eg 5, 7FEL, and compatibility ID for profile 8 eg 8.4.
ListItem.HdrType Returns
The HDR type of the currently selected video (e.g. hdr10, dolbyvision, or hlg).
v20
ListItem.IMDBNumber Returns
The IMDB iD of the selected Video in a container.
ListItem.Label Returns
The left label of the currently selected item in a container.
ListItem.Label2 Returns
The right label of the currently selected item in a container.
ListItem.LastPlayed Returns
The last play date of video in a container.
ListItem.MediaProviders Returns
string containing the names of the media providers of the item, separated by commas if multiple are present.
ListItem.Mood Returns
The mood of the selected song.
ListItem.Mpaa Returns
The MPAA rating of the currently selected movie in a container.
ListItem.MusicChannels Returns
The number of audio channels for a song.
v19
ListItem.NextDuration Returns
The duration of the next item (PVR).
v18
ListItem.NextEndDate Returns
The end date of the next item (PVR).
ListItem.NextEndTime Returns
The end of the next item (PVR).
ListItem.NextGenre Returns
The genre of the next item (PVR).
ListItem.NextGenre(separator) Returns
A list of genres of the the next item (PVR), separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for videos. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
ListItem.NextPlot Returns
The plot of the next item (PVR).
ListItem.NextPlotOutline Returns
The plot outline of the next item (PVR).
ListItem.NextStartDate Returns
The start date of the next item (PVR).
ListItem.NextStartTime Returns
The start time of the next item (PVR).
ListItem.NextTitle Returns
The title of the next item (PVR).
ListItem.OriginalDate Returns
The original release date of the item.
v19
ListItem.OriginalTitle Returns
The original title of the currently selected movie in a container.
ListItem.Overview Returns
The game overview/summary (RETROPLAYER).
ListItem.ParentalRating Returns
The parental rating of the list item ( PVR ).
ListItem.ParentalRatingCode Returns
The parental rating code.
v22
ListItem.ParentalRatingIcon Returns
The parental rating icon.
v22
ListItem.ParentalRatingSource Returns
The parental rating source.
v22
ListItem.Path Returns
The complete path of the currently selected song or movie in a container.
ListItem.PercentPlayed Returns
The returns percentage value [0-100] of how far the selected video has been played.
ListItem.PictureAperture Returns
The f-stop used to take the selected picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
ListItem.PictureAuthor Returns
The name of the person involved in writing about the selected picture. This is the value of the IPTC Writer tag (hex code 0x7A).
ListItem.PictureByline Returns
The name of the person who created the selected picture. This is the value of the IPTC Byline tag (hex code 0x50).
ListItem.PictureBylineTitle Returns
The title of the person who created the selected picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
ListItem.PictureCamMake Returns
The manufacturer of the camera used to take the selected picture. This is the value of the EXIF Make tag (hex code 0x010F).
ListItem.PictureCamModel Returns
The manufacturer's model name or number of the camera used to take the selected picture. This is the value of the EXIF Model tag (hex code 0x0110).
ListItem.PictureCaption Returns
The description of the selected picture. This is the value of the IPTC Caption tag (hex code 0x78).
ListItem.PictureCategory Returns
The subject of the selected picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
ListItem.PictureCCDWidth Returns
The width of the CCD in the camera used to take the selected picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
ListItem.PictureCity Returns
The city where the selected picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
ListItem.PictureColour Returns
Whether the selected picture is "Colour" or "Black and White".
ListItem.PictureComment Returns
The description of the selected picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
ListItem.PictureCopyrightNotice Returns
The copyright notice of the selected picture. This is the value of the IPTC Copyright tag (hex code 0x74).
ListItem.PictureCountry Returns
The full name of the country where the selected picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
ListItem.PictureCountryCode Returns
The country code of the country where the selected picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
ListItem.PictureCredit Returns
The provider of the selected picture. This is the value of the IPTC Credit tag (hex code 0x6E).
ListItem.PictureDate Returns
The localized date of the selected picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
ListItem.PictureDatetime Returns
The date/timestamp of the selected picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
ListItem.PictureDesc Returns
The short description of the selected picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
ListItem.PictureDigitalZoom Returns
The digital zoom ratio when the selected picture was taken. This is the value of the EXIF DigitalZoomRatio tag (hex code 0xA404).
ListItem.PictureExpMode Returns
The exposure mode of the selected picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
ListItem.PictureExposure Returns
The class of the program used by the camera to set exposure when the selected picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
ListItem.PictureExposureBias Returns
The exposure bias of the selected picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
ListItem.PictureExpTime Returns
The exposure time of the selected picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
ListItem.PictureFlashUsed Returns
The status of flash when the selected picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209).
ListItem.PictureFocalLen Returns
The lens focal length of the selected picture.
ListItem.PictureFocusDist Returns
The focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
ListItem.PictureGPSAlt Returns
The altitude in meters where the selected picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
ListItem.PictureGPSLat Returns
The latitude where the selected picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
ListItem.PictureGPSLon Returns
The longitude where the selected picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
ListItem.PictureHeadline Returns
The synopsis of the contents of the selected picture. This is the value of the IPTC Headline tag (hex code 0x69).
ListItem.PictureImageType Returns
The color components of the selected picture. This is the value of the IPTC ImageType tag (hex code 0x82).
ListItem.PictureIPTCDate Returns
The date when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
ListItem.PictureIPTCTime Returns
The time when the intellectual content of the selected picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
ListItem.PictureISO Returns
The ISO speed of the camera when the selected picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
ListItem.PictureKeywords Returns
The keywords assigned to the selected picture. This is the value of the IPTC Keywords tag (hex code 0x19).
ListItem.PictureLightSource Returns
The kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
ListItem.PictureLongDate Returns
The localized date of the selected picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
ListItem.PictureLongDatetime Returns
The date/timestamp of the selected picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
ListItem.PictureMeteringMode Returns
The metering mode used when the selected picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
ListItem.PictureObjectName Returns
The shorthand reference for the selected picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
ListItem.PictureOrientation Returns
The orientation of the selected picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
ListItem.PicturePath Returns
The filename and path of the selected picture.
ListItem.PictureProcess Returns
The process used to compress the selected picture.
ListItem.PictureReferenceService Returns
The service identifier of a prior envelope to which the selected picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
ListItem.PictureResolution Returns
The dimensions of the selected picture.
ListItem.PictureSource Returns
The original owner of the selected picture. This is the value of the IPTC Source tag (hex code 0x73).
ListItem.PictureSpecialInstructions Returns
The editorial instructions concerning the use of the selected picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
ListItem.PictureState Returns
The State/Province where the selected picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
ListItem.PictureSublocation Returns
The location within a city where the selected picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
ListItem.PictureSupplementalCategories Returns
The supplemental category codes to further refine the subject of the selected picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
ListItem.PictureTransmissionReference Returns
The code representing the location of original transmission of the selected picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
ListItem.PictureUrgency Returns
The urgency of the selected picture. Values are 1-9. The "1" is most urgent. Some image management programs use urgency to indicate picture rating, where urgency "1" is 5 stars and urgency "5" is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
ListItem.PictureWhiteBalance Returns
The white balance mode set when the selected picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).
ListItem.Platform Returns
The game platform (e.g. "Atari 2600") (RETROPLAYER).
ListItem.PlayCount Returns
The playcount of video in a container.
ListItem.Plot Returns
The complete text summary of video in a container.
ListItem.PlotOutline Returns
The small summary of current video in a container.
ListItem.Premiered Returns
The release/aired date of the currently selected episode, show, movie, or EPG item in a container.
ListItem.PrivacyPolicy Returns
The official Kodi privacy-policy.
v17
ListItem.ProgramCount Returns
The number of times an xbe has been run from "my programs".
ListItem.Progress Returns
The part of the programme that's being played (PVR).
ListItem.Property(Addon.Changelog) Returns
The changelog of the currently selected addon.
ListItem.Property(Addon.ID) Returns
The identifier of the currently selected addon.
ListItem.Property(Addon.Path) Returns
The path of the currently selected addon.
ListItem.Property(Addon.Status) Returns
The status of the currently selected addon.
ListItem.Property(Album_Description) Returns
The review of the currently selected album.
ListItem.Property(Album_Duration) Returns
The duration of an album in HH:MM:SS.
v19
ListItem.Property(Album_Label) Returns
The record label of the currently selected album.
ListItem.Property(Album_Mood) Returns
The moods of the currently selected album.
ListItem.Property(Album_Rating) Returns
The scraped rating of the currently selected album.
ListItem.Property(Album_Style) Returns
The styles of the currently selected album.
ListItem.Property(Album_Theme) Returns
The themes of the currently selected album.
ListItem.Property(Album_Type) Returns
The album type of the currently selected album (e.g. compilation, enhanced, or explicit lyrics).
ListItem.Property(Album_UserRating) Returns
The user rating of the currently selected album.
ListItem.Property(Artist_Born) Returns
The Date of Birth of the currently selected artist.
ListItem.Property(Artist_Description) Returns
The biography of the currently selected artist.
ListItem.Property(Artist_Died) Returns
The Date of Death of the currently selected artist.
ListItem.Property(Artist_Disambiguation) Returns
The brief description of the currently selected artist that differentiates them from others with the same name.
v18
ListItem.Property(Artist_Disbanded) Returns
The disbanding date of the currently selected band.
ListItem.Property(Artist_Formed) Returns
The formation date of the currently selected band.
ListItem.Property(Artist_Gender) Returns
The gender of the currently selected artist (e.g.male, female, or other).
v18
ListItem.Property(Artist_Genre) Returns
The genre of the currently selected artist.
ListItem.Property(Artist_Instrument) Returns
The instruments played by the currently selected artist.
ListItem.Property(Artist_Mood) Returns
The moods of the currently selected artist.
ListItem.Property(Artist_Sortname) Returns
The sortname of the currently selected artist.
v18
ListItem.Property(Artist_Style) Returns
The styles of the currently selected artist.
ListItem.Property(Artist_Type) Returns
The type of the currently selected artist (person, group, orchestra, choir, etc).
v18
ListItem.Property(Artist_YearsActive) Returns
The years the currently selected artist has been active.
ListItem.Property(AudioChannels.[n]) Returns
The number of audio channels of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioChannels).
ListItem.Property(AudioCodec.[n]) Returns
The audio codec of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioCodec).
ListItem.Property(AudioLanguage.[n]) Returns
The audio language of the currently selected video, 'n' defines the number of the audiostream (values: see ListItem.AudioLanguage).
ListItem.Property(game.stretchmode) Returns
The name of the stretch mode (e.g. Stretch 4:3).
v18
ListItem.Property(game.videofilter) Returns
The name of the video filter (e.g. Bilinear).
v18
ListItem.Property(game.videorotation) Returns
The angle of the rotation.
v18
ListItem.Property(NumEpisodes) Returns
The number of total, watched, or unwatched episodes for the currently selected TV show or season, based on the the current watched filter.
ListItem.Property(Role.Arranger) Returns
The name of the person who arranged the selected song.
ListItem.Property(Role.Composer) Returns
The name of the person who composed the selected song.
ListItem.Property(Role.Conductor) Returns
The name of the person who conducted the selected song.
ListItem.Property(Role.DJMixer) Returns
The name of the DJ who remixed the selected song.
ListItem.Property(Role.Engineer) Returns
The name of the person who was the engineer of the selected song.
ListItem.Property(Role.Lyricist) Returns
The name of the person who wrote the lyrics of the selected song.
ListItem.Property(Role.Mixer) Returns
The name of the person who mixed the selected song.
ListItem.Property(Role.Orchestra) Returns
The name of the orchestra performing the selected song.
ListItem.Property(Role.Producer) Returns
The name of the person who produced the selected song.
ListItem.Property(Role.Remixer) Returns
The name of the person who remixed the selected song.
ListItem.Property(Stream.Bitrate) Returns
The video bitrate (kbps) of the currently playing video.
v22
ListItem.Property(Stream.Channels) Returns
The number of audio channels of the currently playing video.
v22
ListItem.Property(Stream.Codec) Returns
The audio, video, or subtitle codec of the currently playing video.
v22
ListItem.Property(Stream.CodecDesc) Returns
The audio description of the currently playing video.
v22
ListItem.Property(Stream.Description) Returns
The audio, video, or subtitle title/name of the currently playing video.
v22
ListItem.Property(Stream.FPS) Returns
The Frames per Second of the currently playing video.
v22
ListItem.Property(Stream.HDRType) Returns
The HDR type of the currently playing video (e.g. hdr10, dolbyvision, or hlg).
v22
ListItem.Property(Stream.Language) Returns
The audio language of the currently playing video as an ISO 639-2 three character code (e.g. eng, epo, deu, etc).
v22
ListItem.Property(Stream.Resolution) Returns
The video resolution of the currently playing video.
v22
ListItem.Property(Stream.StereoMode) Returns
The 3D stereo mode of the playing video (e.g. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, or anaglyph_green_magenta).
v22
ListItem.Property(SubtitleLanguage.[n]) Returns
The subtitle language of the currently selected stream, 'n' defines the number of the subtitle (values: see ListItem.SubtitleLanguage).
ListItem.Property(TotalEpisodes) Returns
The total number of episodes for the currently selected TV show or season.
ListItem.Property(TotalSeasons) Returns
The total number of seasons for the currently selected TV show.
ListItem.Property(UnWatchedEpisodes) Returns
The number of unwatched episodes for the currently selected TV show or season.
ListItem.Property(WatchedEpisodes) Returns
The number of watched episodes for the currently selected TV show or season.
ListItem.Publisher Returns
The game publisher (e.g. "Nintendo") (RETROPLAYER).
ListItem.PVRClientName Returns
The name of the PVR client addon for the selected PVR list item.
v22
ListItem.PVRGroupOrigin Returns
If selected item is of type PVR channel group, the creator (user, system, client) of the group.
ListItem.PVRInstanceName Returns
The name of the instance of the PVR client addon for the selected PVR list item.
v22
ListItem.Rating[(name)] Returns
The scraped rating of the currently selected item in a container. Optionally you can specify the name of the scraper to retrieve a specific rating, for use in dialogvideoinfo.xml.
ListItem.RatingAndVotes[(name)] Returns
The IMDB rating and votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve a specific rating and votes, for use in dialogvideoinfo.xml.
ListItem.ReleaseDate Returns
The release date of the current item.
v19
ListItem.SampleRate Returns
The sample rate of a song / 1000.0 (e.g. 44.1, 48, 96 etc).
v19
ListItem.Season Returns
The season value for the currently selected TV show.
ListItem.Set Returns
The name of the set the movie is part of.
ListItem.SetId Returns
The id of the set the movie is part of.
ListItem.Size Returns
The file size of the currently selected song or movie in a container.
ListItem.SongVideoURL Returns
Link to a video of a song
ListItem.SortLetter Returns
The first letter of the current file in a container.
ListItem.StartDate Returns
The start date of current selected TV programme in a container.
ListItem.StartDate Returns
The start date of the selected item (PVR).
ListItem.StartTime Returns
The start time of current selected TV programme in a container.
ListItem.StartTime Returns
The start time of the selected item (PVR).
ListItem.Status Returns
The status of the selected TV show (e.g. 'returning series','in production','planned','cancelled' or 'ended').
ListItem.StereoscopicMode Returns
The stereomode of the selected video (ie.g. mono, split_vertical, split_horizontal, row_interleaved, anaglyph_cyan_red, or anaglyph_green_magenta).
ListItem.Studio Returns
The studio of current selected music video in a container.
ListItem.SubtitleLanguage Returns
The subtitle language of the currently selected video as an ISO 639-2 three character code (e.g. eng, epo, deu).
ListItem.Tag Returns
The name of the 'tag' this movie is part of.
ListItem.Tagline Returns
The small summary of current video in a container.
ListItem.TimerType Returns
The type of the PVR timer / timer rule item as a human readable string.
ListItem.Title Returns
The title of the currently selected song or movie in a container.
ListItem.TitleExtraInfo Returns
string containing extra information, enriching the title of the item.
ListItem.Top250 Returns
The IMDB top 250 position of the currently selected ListItem in a container.
ListItem.TotalDiscs Returns
The total amount of discs belonging to an album.
v19
ListItem.TrackNumber Returns
The track number of the currently selected song in a container.
ListItem.Trailer Returns
The full trailer path with filename of the currently selected movie in a container.
ListItem.TVShowDBID Returns
The TV show DBID of the selected season or episode a container.
v19
ListItem.TVShowTitle Returns
The name value for the currently selected TV show in the season and episode depth of the video library.
ListItem.UniqueID() Returns
The UniqueID of the selected item in a container.
v19
ListItem.UserRating Returns
The user rating of the currently selected item in a container.
ListItem.VideoAspect Returns
The aspect ratio of the currently selected video.
Possible values:
  • 1.00*
  • 1.19*
  • 1.33
  • 1.37
  • 1.66
  • 1.78
  • 1.85
  • 2.00*
  • 2.20
  • 2.35
  • 2.40
  • 2.55
  • 2.76
*v20
ListItem.VideoCodec Returns
The video codec of the currently selected video.
Possible values:
  • 3iv2
  • av1
  • avc1
  • div2
  • div3
  • divx
  • divx 4
  • dx50
  • flv
  • h264
  • hev1
  • hevc
  • hvc1
  • microsoft
  • mp42
  • mp43
  • mp4v
  • mpeg1
  • mpeg1video
  • mpeg2
  • mpeg2video
  • mpeg4
  • mpg4
  • rv40
  • svq1
  • svq3
  • theora
  • vc-1
  • vc1
  • vp6f
  • vp8
  • vp9
  • wmv
  • wmv2
  • wmv3
  • wvc1
  • xvid
ListItem.VideoHeight Returns
String containing height of video in pixels - empty if unknown.
ListItem.VideoResolution Returns
The resolution of the currently selected video.
Possible values:
  • 480
  • 576
  • 540
  • 720
  • 1080
  • 4K
  • 8K*

Note
That 540 usually means a widescreen format (around 960x540) while 576 means PAL resolutions (normally 720x576), therefore 540 is actually better resolution than 576.

*v18
ListItem.VideoVersionName Returns
The name of the video version.
v21
ListItem.VideoWidth Returns
String containing width of video in pixels - empty if unknown.
ListItem.Votes[(name)] Returns
The IMDB votes of the currently selected movie in a container. Optionally you can specify the name of the scraper to retrieve specific votes, for use in dialogvideoinfo.xml.
ListItem.Writer Returns
The name of Writer of current video in a container.
ListItem.Writer(separator) Returns
A list of writers, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
ListItem.Year Returns
The year of the currently selected song, album, or movie in a container.

MusicPartyMode

InfoLabels Description Version
MusicPartyMode.MatchingSongs Returns
The number of songs available to Party Mode.
MusicPartyMode.MatchingSongsLeft Returns
The number of songs left to be picked from for Party Mode.
MusicPartyMode.MatchingSongsPicked Returns
The number of songs picked already for Party Mode.
MusicPartyMode.RandomSongsPicked Returns
The number of unique random songs picked during Party Mode.
MusicPartyMode.RelaxedSongsPicked Returns
The number of relaxed songs picked during Party Mode.
MusicPartyMode.SongsPlayed Returns
The number of songs played during Party Mode.

Network

InfoLabels Description Version
Network.DHCPAddress Returns
The DHCP server ip address.
Network.DNS1Address Returns
The network dns server 1 address.
Network.DNS2Address Returns
The network dns server 2 address.
Network.GatewayAddress Returns
The network gateway address.
Network.IPAddress Returns
The system's IP Address. e.g. 192.168.1.15
Network.LinkState Returns
The network linkstate (e.g. 10mbit/100mbit etc).
Network.MacAddress Returns
The system's mac address.
Network.SubnetMask Returns
The network subnet mask.

Player

InfoLabels Description Version
Player.AudioDelay Returns
The used audio delay with the format %2.3f s
Player.Bookmarks Returns
The bookmarks of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
Player.CacheLevel Returns
The used cache level as a string with an integer number.
Player.ChapterName Returns
The name of currently used chapter if available.
Player.Cuts Returns
The EDL cut markers of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
Player.Editlist Returns
The editlist of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.

Note
This infolabel does not contain EDL cuts. Edits start and end times are adjusted according to cuts defined for the media item.

Player.offset(number).Filename Returns
The filename of audio or video file which has an offset number with respect to the currently playing item.
Player.offset(number).FilenameAndPath Returns
The full path with filename of audio or video file which has an offset number with respect to the currently playing item.
Player.offset(number).Folderpath Returns
The full path of the audio or video file which has an offset number with respect to the currently playing item.
Player.offset(number).Title Returns
The title of audio or video which has an offset number with respect to the currently playing item.
Player.position(number).Filename Returns
The filename of the audio or video file which has an offset number with respect to the start of the playlist.
Player.position(number).FilenameAndPath Returns
The full path with filename of the audio or video file which has an offset number with respect to the start of the playlist.
Player.position(number).Folderpath Returns
The full path of the audio or video file which has an offset number with respect to the start of the playlist.
Player.position(number).Title Returns
The title of the audio or video which has an offset number with respect to the start of the playlist.
Player.SceneMarkers Returns
The EDL scene markers of the currently playing item as csv in the format start1,end1,start2,end2,... Tokens have values in the range from 0.0 to 100.0. end token is greater or equal to the start token.
Player.SeekNumeric([format]) Returns
The time at which the playing media began (in a specified format).

Parameters

format [opt] The format of the return time value. See TIME_FORMAT for the list of possible values.
Player.SubtitleDelay Returns
The used subtitle delay with the format %2.3f s
Player.TimeSpeed Returns
The time and the playspeed formatted: "1:23 (2x)".

Player labels

InfoLabels Description Version
Player.Chapter Current chapter of current playing media
Player.ChapterCount Total number of chapters of current playing media
Player.Chapters this infolabel can be used with the Ranges Control, as EDL and chapter markers v19
Player.CutList this infolabel can be used with the Ranges Control, as EDL and chapter markers v19
Player.Duration Total duration of the current playing media
Player.Duration(format) Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
Player.Filename Returns the filename of the currently playing media. (supports .offset() and .position())
Player.Filenameandpath Shows the full path with filename of the currently playing song or movie. (supports .offset() and .position())
Player.FinishTime Time playing media will end
Player.FinishTime(format) Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
Player.Folderpath Shows the full path of the currently playing song or movie. (supports .offset() and .position())
Player.PlaySpeed Current playspeed. (range:0.8 to 1.5)
Player.Process(AudioBitsPerSample) Bits per sample of the currently playing item
Player.Process(AudioChannels) List of audio channels of the currently playing item (e.g. FL+FR)
Player.Process(AudioDecoder) Audiodecoder name of the currently playing item
Player.Process(AudioSamplerate) Samplerate f the currently playing item
Player.Process(DeintMethod) Deinterlace method of the currently playing video
Player.Process(PixFormat) Pixel format of the currently playing video
Player.Process(VideoDAR) Display aspect ratio of the currently playing video
Player.Process(VideoDecoder) Videodecoder name of the currently playing video
Player.Process(VideoFPS) Video framerate of the currently playing video
Player.Process(VideoHeight) Height of the currently playing video
Player.Process(VideoScanType) The scan type identifier of the currently playing video p (for progressive) or i (for interlaced) v20
Player.Process(VideoWidth) Width of the currently playing video
Player.Progress Shows how much (percentage) of the file has been played
Player.ProgressCache Shows how much of the file is cached above current play percentage
Player.SeekBar Time to which the user is seeking as a percentage (for use in slider controls)
Player.SeekOffset Indicates the seek offset after a seek press (e.g. user presses BigStepForward, player.seekoffset returns +10:00)
Player.SeekOffset(format) Shows hours (hh), minutes (mm) or seconds (ss). Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
Player.SeekStepSize Displays the seek step size. (v15 addition)
Player.SeekTime Time to which the user is seeking
Player.StartTime Returns the starttime (from the epg) of a tv program, for all other videos it will return the time you started watching this video.
Player.StartTime(format) Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
Player.Time Elapsed time of current playing media
Player.Time(format) Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
Player.TimeRemaining Remaining time of current playing media
Player.TimeRemaining(format) Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss).
Player.Title Returns the musicplayer title for audio and the videoplayer title for videos. (supports .offset() and .position())
Player.Volume Returns the volume level in dB

Music player

InfoLabels Description Version
MusicPlayer.AlbumArtist Returns
The album artist of the currently playing song.
MusicPlayer.LastPlayed Returns
The last play date of currently playing song, if it's in the database.
MusicPlayer.MediaProviders Returns
string containing the names of the providers of the currently playing media, separated by commas if multiple are present.
MusicPlayer.offset(number).Album Returns
The album from which the song with offset number with respect to the current song is from.

Parameters

number - the offset number with respect to the current playing song
MusicPlayer.offset(number).Artist Returns
Artist(s) of the song which has an offset number with respect to the current playing song.

Parameters

number - the offset of the song with respect to the current playing song
MusicPlayer.offset(number).Comment Returns
The Comment of current song stored in ID tag info for the song with an offset number with respect to the playing song.

Parameters

number - The offset value for the song with respect to the playing song.
MusicPlayer.offset(number).DiscNumber Returns
The Disc Number of current song stored in ID tag info for the song with an offset number with respect to the playing song.

Parameters

number - The offset value for the song with respect to the playing song.
MusicPlayer.offset(number).Duration Returns
The duration of the song with an offset number with respect to the current playing song.

Parameters

number - the offset number of the song with respect to the current playing song
MusicPlayer.offset(number).Genre Returns
The genre(s) of the song with an offset number with respect to the current playing song.

Parameters

number - the offset song number with respect to the current playing song.
MusicPlayer.offset(number).Rating Returns
The numeric Rating of song with an offset number with respect to the current playing song.

Parameters

number - the offset with respect to the current playing song
MusicPlayer.offset(number).Title Returns
The title of the song which has an offset number with respect to the current playing song.

Parameters

number - the offset number with respect to the current playing song
MusicPlayer.offset(number).TrackNumber Returns
The track number of the song with an offset number with respect to the current playing song.

Parameters

number - The offset number of the song with respect to the playing song
MusicPlayer.offset(number).Year Returns
The year of release of the song with an offset number with respect to the current playing song.

Parameters

number - the offset number with respect to the current song.
MusicPlayer.ParentalRatingCode Shows the parental rating code v22
MusicPlayer.ParentalRatingIcon Shows the parental rating icon v22
MusicPlayer.ParentalRatingSource Shows the parental rating source v22
MusicPlayer.ChannelLogo Shows the logo of the currently selected radio or TV channel v22
MusicPlayer.PlayCount Returns
The play count of currently playing song, if it's in the database.
MusicPlayer.Position(number).Album Returns
The album from which the song with offset number with respect to the start of the playlist is from.

Parameters

number - the offset number with respect to the start of the playlist
MusicPlayer.Position(number).Artist Returns
Artist(s) of the song which has an offset number with respect to the start of the playlist.

Parameters

number - the offset of the song with respect to the start of the playlist
MusicPlayer.Position(number).Comment Returns
The Comment of current song stored in ID tag info for the song with an offset number with respect to the start of the playlist.

Parameters

number - The offset value for the song with respect to the start of the playlist.
MusicPlayer.Position(number).DiscNumber Returns
The Disc Number of current song stored in ID tag info for the song with an offset number with respect to the start of the playlist.

Parameters

number - The offset value for the song with respect to the start of the playlist.
MusicPlayer.Position(number).Duration Returns
The duration of the song with an offset number with respect to the start of the playlist.

Parameters

number - the offset number of the song with respect to the start of the playlist
MusicPlayer.Position(number).Genre Returns
The genre(s) of the song with an offset number with respect to the start of the playlist.

Parameters

number - the offset song number with respect to the start of the playlist song.
MusicPlayer.Position(number).Rating Returns
The numeric Rating of song with an offset number with respect to the start of the playlist.

Parameters

number - the offset with respect to the start of the playlist
MusicPlayer.Position(number).Title Returns
The title of the song which as an offset number with respect to the start of the playlist.

Parameters

number - the offset number with respect to the start of the playlist
MusicPlayer.Position(number).TrackNumber Returns
The track number of the song with an offset number with respect to start of the playlist.

Parameters

number - The offset number of the song with respect to start of the playlist
MusicPlayer.Position(number).Year Returns
The year of release of the song with an offset number with respect to the start of the playlist.

Parameters

number - the offset number with respect to the start of the playlist.
MusicPlayer.RatingAndVotes Returns
The scraped rating and votes of currently playing song, if it's in the database.
MusicPlayer.Station Returns
The name of the radio station currently playing (if available).
MusicPlayer.Title Title of the currently playing song, also available are "MusicPlayer.offset(number).Title" offset is relative to the current playing item and "MusicPlayer.Position(number).Title" position is relative to the start of the playlist
MusicPlayer.Album Album from which the current song is from, also available are "MusicPlayer.offset(number).Album" offset is relative to the current playing item and "MusicPlayer.Position(number).Album" position is relative to the start of the playlist
MusicPlayer.Property(Album_Mood) Shows the moods of the currently playing Album
MusicPlayer.Property(Album_Style) Shows the styles of the currently playing Album
MusicPlayer.Property(Album_Theme) Shows the themes of the currently playing Album
MusicPlayer.Property(Album_Type) Shows the Album Type (e.g. compilation, enhanced, explicit lyrics) of the currently playing Album
MusicPlayer.Property(Album_Label) Shows the record label of the currently playing Album
MusicPlayer.Property(Album_Description) Shows a review of the currently playing Album
MusicPlayer.Artist Artist(s) of current song, also available are "MusicPlayer.offset(number).Artist" offset is relative to the current playing item and "MusicPlayer.Position(number).Artist" position is relative to the start of the playlist
MusicPlayer.Property(Artist_Born) Date of Birth of the currently playing Artist
MusicPlayer.Property(Artist_Died) Date of Death of the currently playing Artist
MusicPlayer.Property(Artist_Formed) Formation date of the currently playing Artist/Band
MusicPlayer.Property(Artist_Disbanded) Disbanding date of the currently playing Artist/Band
MusicPlayer.Property(Artist_YearsActive) Years the currently Playing artist has been active
MusicPlayer.Property(Artist_Instrument) Instruments played by the currently playing artist
MusicPlayer.Property(Artist_Description) Shows a biography of the currently playing artist
MusicPlayer.Property(Artist_Mood) Shows the moods of the currently playing artist
MusicPlayer.Property(Artist_Style) Shows the styles of the currently playing artist
MusicPlayer.Property(Artist_Genre) Shows the genre of the currently playing artist
MusicPlayer.Property(Artist_Sortname) Sortname of the currently playing Artist v18
MusicPlayer.Property(Artist_Type) Type of the currently playing Artist - person, group, orchestra, choir, etc. v18
MusicPlayer.Property(Artist_Gender) Gender of the currently playing Artist - male, female, other v18
MusicPlayer.Property(Artist_Disambiguation) Brief description of the currently playing Artist that differentiates them from others with the same name v18
MusicPlayer.Genre Genre(s) of current song, also available are "MusicPlayer.offset(number).Genre" offset is relative to the current playing item and "MusicPlayer.Position(number).Genre" position is relative to the start of the playlist
MusicPlayer.Genre(separator) Returns
A list of genres of current song, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for music. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
MusicPlayer.Lyrics Lyrics of current song stored in ID tag info
MusicPlayer.Votes Returns
The scraped votes of currently playing song, if it's in the database.
MusicPlayer.Year Year of release of current song, also available are "MusicPlayer.offset(number).Year" offset is relative to the current playing item and "MusicPlayer.Position(number).Year" position is relative to the start of the playlist
MusicPlayer.Rating Numeric Rating of current song, also available are "MusicPlayer.offset(number).Rating" offset is relative to the current playing item and "MusicPlayer.Position(number).Rating" position is relative to the start of the playlist
MusicPlayer.DiscNumber Disc Number of current song stored in ID tag info, also available are "MusicPlayer.offset(number).DiscNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).DiscNumber" position is relative to the start of the playlist
MusicPlayer.Comment Comment of current song stored in ID tag info, also available are "MusicPlayer.offset(number).Comment" offset is relative to the current playing item and "MusicPlayer.Position(number).Comment" position is relative to the start of the playlist
MusicPlayer.Time Current time in song
MusicPlayer.TimeRemaining Current remaining time in song
MusicPlayer.TimeSpeed Both the time and the playspeed formatted up. e.g. 1:23 (2x)
MusicPlayer.TrackNumber Track number of current song, also available are "MusicPlayer.offset(number).TrackNumber" offset is relative to the current playing item and "MusicPlayer.Position(number).TrackNumber" position is relative to the start of the playlist
MusicPlayer.Duration Duration of current song, also available are "MusicPlayer.offset(number).Duration" offset is relative to the current playing item and "MusicPlayer.Position(number).Duration" position is relative to the start of the playlist
MusicPlayer.BitRate Bitrate of current song
MusicPlayer.Channels Number of channels of current song
MusicPlayer.BitsPerSample Number of bits per sample of current song
MusicPlayer.SampleRate Samplerate of current song
MusicPlayer.Codec Codec of current song
MusicPlayer.PlaylistPosition Position of the current song in the current music playlist
MusicPlayer.PlaylistLength Total size of the current music playlist
MusicPlayer.ChannelName Channel name of the radio programme that's currently playing (PVR).
MusicPlayer.ChannelNumberLabel Channel and subchannel number of the radio channel that's currently playing (PVR).
MusicPlayer.ChannelGroup Channel group of of the radio programme that's currently playing (PVR).
MusicPlayer.Contributors List of all people who've contributed to the currently playing song
MusicPlayer.ContributorAndRole List of all people and their role who've contributed to the currently playing song
MusicPlayer.Mood Mood of the currently playing song
MusicPlayer.Property(Role.Arranger) Returns the name of the person who arranged the selected song
MusicPlayer.Property(Role.Composer) Returns the name of the person who composed the selected song
MusicPlayer.Property(Role.Conductor) Returns the name of the person who conducted the selected song
MusicPlayer.Property(Role.DJMixer) Returns the name of the dj who remixed the selected song
MusicPlayer.Property(Role.Engineer) Returns the name of the person who was the engineer of the selected song
MusicPlayer.Property(Role.Lyricist) Returns the name of the person who wrote the lyrics of the selected song
MusicPlayer.Property(Role.Mixer) Returns the name of the person who mixed the selected song
MusicPlayer.Property(Role.Orchestra) Returns the name of the orchestra performing the selected song
MusicPlayer.Property(Role.Producer) Returns the name of the person who produced the selected song
MusicPlayer.Property(Role.Remixer) Returns the name of the person who remixed the selected song
MusicPlayer.UserRating The rating the user gave to the currently playing song
MusicPlayer.DBID The database id of the currently playing song v17
MusicPlayer.DiscTitle The title of the disc currently playing v19
MusicPlayer.ReleaseDate Returns the release date of the song currently playing v19
MusicPlayer.OriginalDate Returns the original release date of the song currently playing v19
MusicPlayer.BPM Returns the Beats Per Minute of the currently playing song v19
MusicPlayer.TotalDiscs Returns the number of discs associated with the album of the currently playing song v19

RetroPlayer

InfoLabels Description Version
RetroPlayer.Developer Returns
The developer of the currently-playing game (e.g. "Square").
RetroPlayer.DiscLabel Returns
The human-readable label of the currently inserted disc, or an empty string if no disc is in the tray/floppy drive or the game isn't disc-based.
RetroPlayer.GameClient Returns
The add-on ID of the game client (a.k.a. emulator) used to play the currently-playing game (e.g. game.libretro.beetle-psx ).
RetroPlayer.GameClientName Returns
The emulator/core name parsed from the game client's add-on name (e.g. bsnes-mercury Performance ).
RetroPlayer.GameClientPlatforms Returns
The platform or platform group supported by the game client (e.g. an emulator might report "Nintendo - SNES / SFC / Game Boy / Color").
RetroPlayer.Genres Returns
The genres of the currently-playing game, joined by ", ".
RetroPlayer.Overview Returns
The overview/summary of the currently-playing game.
RetroPlayer.Platform Returns
The platform of the currently-playing game, or an empty string if the platform is unknown.
RetroPlayer.Publisher Returns
The publisher of the currently-playing game (e.g. "Nintendo").
RetroPlayer.StretchMode Returns
The stretch mode of the currently-playing game. The following values are possible:
normal (Show the game normally)
4:3 (Stretch to a 4:3 aspect ratio)
fullscreen (Stretch to the full viewing area)
original (Shrink to the original resolution)
RetroPlayer.Title Returns
The title of the currently-playing game.
RetroPlayer.VideoFilter Returns
The video filter of the currently-playing game. The following values are possible:
nearest (Nearest neighbor, i.e. pixelate)
linear (Bilinear filtering, i.e. smooth blur)
RetroPlayer.VideoRotation Returns
The video rotation of the currently-playing game in degrees counter-clockwise. The following values are possible:
0
90 (Shown in the GUI as 270 degrees)
180
270 (Shown in the GUI as 90 degrees)

Video player

InfoLabels Description Version
VideoPlayer.Art(type) Returns
The art path for the requested arttype and for the currently playing video.

Parameters

type - can virtually be anything, refers to the art type keyword in the art map (poster, fanart, banner, thumb, etc)
VideoPlayer.AudioLanguageEx Returns
The English name of the language of the current audio stream of the currently playing item.
VideoPlayer.AudioName Returns
The name of the active audio stream of the currently playing video.
VideoPlayer.AudioStreamCount Returns the number of audio streams of the currently playing video v21
VideoPlayer.EpisodePart Returns
string containing the number of parts of a single episode - empty if no data provided
[Infolabel Updated] VideoPlayer.EpisodePart also supports EPG.
VideoPlayer.HdrDetail Returns
String containing details for the HDR type (currently only for DV - profile and EL type) or empty if not HDR. Prints eg 5, 7FEL, and compatibility ID for profile 8 eg 8.4.
VideoPlayer.MediaProviders Returns
string containing the names of the providers of the currently playing media, separated by commas if multiple are present.
VideoPlayer.offset(number).Album Returns
The album from which the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Art(type) Returns
The art path for the requested arttype and for the video which has an offset number with respect to the currently playing video.

Parameters

number - the offset with respect to the start of the playlist
type - can virtually be anything, refers to the art type keyword in the art map (poster, fanart, banner, thumb, etc)
VideoPlayer.offset(number).Artist Returns
The artist(s) of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Country Returns
The production country of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Cover Returns
The cover of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).DBID Returns
The database id of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Director Returns
The director of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Episode Returns
The episode number of the episode which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Genre Returns
The genre(s) of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).IMDBNumber Returns
The IMDb ID of the the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).LastPlayed Returns
The last play date of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).mpaa Returns
The MPAA rating of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).OriginalTitle Returns
The original title of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).PlayCount Returns
The playcount of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Plot Returns
The complete Text Summary of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).PlotOutline Returns
The small Summary of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Premiered Returns
The release or aired date of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Rating Returns
The scraped rating of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).RatingAndVotes Returns
The scraped rating and votes of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Season Returns
The season number of the episode which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Studio Returns
The studio of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Tagline Returns
The small Summary of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Title Returns
The title of video which has an offset number with respect to the currently playing video.

Note
If it's in the database it will return the database title, else the filename.

VideoPlayer.offset(number).Top250 Returns
The IMDb Top250 position of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Trailer Returns
The path to the trailer of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).TVShowTitle Returns
The title of the episode's tvshow name which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).UserRating Returns
The user rating of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Votes Returns
The scraped votes of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Writer Returns
The name of Writer of the video which has an offset number with respect to the currently playing video.
VideoPlayer.offset(number).Year Returns
The year of release of the video which has an offset number with respect to the currently playing video.
VideoPlayer.position(number).Album Returns
The album from which the music video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Art(type) Returns
The art path for the requested arttype and for the video which has an offset number with respect to the start of the playlist.

Parameters

number - the offset with respect to the start of the playlist
type - can virtually be anything, refers to the art type keyword in the art map (poster, fanart, banner, thumb, etc)
VideoPlayer.position(number).Artist Returns
The artist(s) of the music video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Country Returns
The production country of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Cover Returns
The cover of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).DBID Returns
The database id of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Director Returns
The director of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Episode Returns
The episode number of the episode which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Genre Returns
The genre(s) of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).IMDBNumber Returns
The IMDb ID of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).LastPlayed Returns
The last play date of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).mpaa Returns
The MPAA rating of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).OriginalTitle Returns
The original title of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).PlayCount Returns
The playcount of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Plot Returns
The complete Text Summary of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).PlotOutline Returns
The small Summary of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Premiered Returns
The release or aired date of the video which has an offset number with respect to the start of the playlist. if it's in the database.
VideoPlayer.position(number).Rating Returns
The scraped rating of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).RatingAndVotes Returns
The scraped rating and votes of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Season Returns
The season number of the episode which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Studio Returns
The studio of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Tagline Returns
The small Summary of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Title Returns
The title of the video which has an offset number with respect to the start of the playlist.

Note
If it's in the database it will return the database title, else the filename.

VideoPlayer.position(number).Top250 Returns
The IMDb Top250 position of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Trailer Returns
The path to the trailer of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).TVShowTitle Returns
The title of the episode's tvshow name which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).UserRating Returns
The user rating of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Votes Returns
The scraped votes of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Writer Returns
The name of Writer of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.position(number).Year Returns
The year of release of the video which has an offset number with respect to the start of the playlist.
VideoPlayer.StartTime Returns
The start date and time of the currently playing epg event or recording ( PVR ).
VideoPlayer.SubtitleCodec Returns
The codec of the current subtitles of the currently playing video. Possible values include:
ass
dvb_subtitle
dvb_teletext
dvd_subtitle
hdmv_pgs_subtitle
microdvd
mov_text
mpl2
realtext
sami
srt
ssa
subrip
text
ttml
vplayer
webvtt
xsub

Note
VideoPlayer.SubtitleCodec holds the codec of the next available subtitles stream if subtitles are disabled in the player.

VideoPlayer.SubtitleLanguageEx Returns
The English name of the language of the current subtitle stream of the currently playing item.
VideoPlayer.SubtitleName Returns
The name of the active subtitle stream of the currently playing video.
VideoPlayer.TitleExtraInfo Returns
string containing extra information, enriching the title of the currently playing media, if any.
VideoPlayer.VideoStreamCount Returns the number of video streams of the currently playing video v22
VideoPlayer.ParentalRatingCode Shows the parental rating code v22
VideoPlayer.ParentalRatingIcon Shows the parental rating icon v22
VideoPlayer.ParentalRatingSource Shows the parental rating source v22
VideoPlayer.ChannelLogo Shows the logo of the currently selected radio or TV channel v22
VideoPlayer.VideoVersionName Show the name of the video version v21
VideoPlayer.Time Current time in movie
VideoPlayer.TimeRemaining Current remaining time in movie
VideoPlayer.TimeSpeed Current time + playspeed. e.g. 1:23:14 (-4x)
VideoPlayer.Duration Length of current movie
VideoPlayer.Title Title of currently playing video. If it's in the database it will return the database title, else the filename. (supports .offset() and .position())
VideoPlayer.OriginalTitle The original title of currently playing video. (supports .offset() and .position())
VideoPlayer.TVShowTitle Title of currently playing episode's tvshow name. (supports .offset() and .position())
VideoPlayer.Season Season number of the currently playing episode, if it's in the database. (supports .offset() and .position())
VideoPlayer.Episode Episode number of the currently playing episode. (supports .offset() and .position())
VideoPlayer.Genre Genre(s) of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.Genre(separator) Returns
A list of genres of current movie, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for videos. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
VideoPlayer.Director Director of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.Director(separator) Returns
A list of directors of the currently playing video, separated by given separator, or if no separator was given separated by the advanced settings value \“itemseparator\” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
VideoPlayer.Country Production country of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.Year Year of release of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.Premiered The release/aired date of the currently selected episode, show, movie or EPG item. (supports .offset() and .position())
VideoPlayer.Rating IMDb user rating of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.UserRating Shows the user rating of the currently playing item. (supports .offset() and .position())
VideoPlayer.Votes IMDb votes of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.RatingAndVotes IMDb user rating and votes of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.mpaa MPAA rating of current movie, if it's in the database. (supports .offset() and .position())
VideoPlayer.IMDBNumber The IMDB iD of the current video, if it's in the database. (supports .offset() and .position())
VideoPlayer.EpisodeName (PVR only) The name of the episode if the playing video is a TV Show, if it's in the database
VideoPlayer.PlaylistPosition Position of the current song in the current video playlist
VideoPlayer.PlaylistLength Total size of the current video playlist
VideoPlayer.Cast A list of cast members, separated by carriage returns, if it's in the database
VideoPlayer.Cast(separator) Returns
A list of cast members of the currently playing video, separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
VideoPlayer.CastAndRole A list of cast members and roles, separated by carriage returns. Every cast/role combination is formatted 'cast' as 'role' where 'as' is localised, if it's in the database
VideoPlayer.CastAndRole(separator) Returns
A list of cast members and roles of the currently playing video, pairs separated by given separator, or if no separator was given separated by carriage returns. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
VideoPlayer.Trailer The trailer of the current movie. (supports .offset() and .position())
VideoPlayer.Album Album from which the current Music Video is from, if it's in the database. (supports .offset() and .position())
VideoPlayer.Artist Artist(s) of current Music Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.Studio Studio of current Music Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.Writer Name of Writer of current playing Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.Writer(separator) Returns
A list of writers of the currently playing video, separated by given separator, or if no separator was given separated by the advanced settings value “itemseparator” for video items. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
VideoPlayer.Tagline Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.PlotOutline Small Summary of current playing Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.Plot Complete Text Summary of current playing Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.Top250 Shows the IMDb top250 position of the current playing Video. (supports .offset() and .position())
VideoPlayer.LastPlayed Last play date of current playing Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.PlayCount Playcount of current playing Video, if it's in the database. (supports .offset() and .position())
VideoPlayer.HdrType Shows the HDR type of the currently playing video (possible values: hdr10, dolbyvision and hlg) v20
VideoPlayer.VideoCodec Shows the video codec of the currently playing video (common values: see ListItem.VideoCodec)
VideoPlayer.VideoResolution Shows the video resolution of the currently playing video (possible values: see ListItem.VideoResolution)
VideoPlayer.VideoAspect Shows the aspect ratio of the currently playing video (possible values: see ListItem.VideoAspect)
VideoPlayer.AudioCodec Shows the audio codec of the currently playing video, optionally 'n' defines the number of the audiostream (common values: see ListItem.AudioCodec)
VideoPlayer.AudioChannels Shows the number of audio channels of the currently playing video (possible values: see ListItem.AudioChannels)
VideoPlayer.AudioLanguage Shows the language of the audio of the currently playing video (possible values: see ListItem.AudioLanguage)
VideoPlayer.SubtitlesLanguage Shows the language of the subtitle of the currently playing video (possible values: see ListItem.SubtitlesLanguage)
VideoPlayer.StereoscopicMode Shows the stereoscopic mode of the currently playing video (possible values: see ListItem.StereoscopicMode)
VideoPlayer.EndTime End date of the currently playing programme (PVR).
VideoPlayer.NextTitle Title of the programme that will be played next (PVR).
VideoPlayer.NextGenre Genre of the programme that will be played next (PVR).
VideoPlayer.NextGenre(separator) Returns
A list of genres of the programme that will be played next (PVR), separated by given separator, or if no separator was given separated by the advanced settings value \“itemseparator\” for videos. Possible values for separator: comma, pipe, slash, cr, dash, colon, semicolon, fullstop.
v22
VideoPlayer.NextPlot Plot of the programme that will be played next (PVR).
VideoPlayer.NextPlotOutline Plot outline of the programme that will be played next (PVR).
VideoPlayer.NextStartTime Start time of the programme that will be played next (PVR).
VideoPlayer.NextEndTime End time of the programme that will be played next (PVR).
VideoPlayer.NextDuration Duration of the programme that will be played next (PVR).
VideoPlayer.ChannelName Name of the curently tuned channel (PVR).
VideoPlayer.ChannelNumberLabel Channel and subchannel number of the tv channel that's currently playing (PVR).
VideoPlayer.ChannelGroup Group of the curently tuned channel (PVR).
VideoPlayer.ParentalRating Parental rating of the currently playing programme (PVR).
VideoPlayer.DBID The database id of the currently playing video. (supports .offset() and .position()) v17
VideoPlayer.UniqueID() Returns the UniqueID of the currently playing video v19
VideoPlayer.TvShowDBID Returns the tv show DBID of the currently playing episode v19

Playlist

InfoLabels Description Version
Playlist.Length(media) Total size of the current playlist. optional parameter media is either video or music.
Playlist.Position(media) Position of the current item in the current playlist. optional parameter media is either video or music.
Playlist.Random Returns 'On' or 'Off'
Playlist.Repeat Returns string ID's 592 (Repeat One), 593 (Repeat All), or 594 (Repeat Off)

PVR

InfoLabels Description Version
PVR.ActStreamAudioBitRate Audio bitrate of the stream
PVR.ActStreamBer Bit error rate of the stream
PVR.ActStreamClient Stream client name
PVR.ActStreamDevice Stream device name
PVR.ActStreamDolbyBitRate Dolby bitrate of the stream
PVR.ActStreamEncryptionName Encryption used on the stream
PVR.ActStreamMux Returns
The multiplex type of played channel if available.
PVR.ActStreamProgrSignal Signal quality of the programme
PVR.ActStreamProgrSnr Signal to noise ratio of the programme
PVR.ActStreamProviderName Returns
The provider name of the played channel if available.
PVR.ActStreamServiceName Returns
The service name of played channel if available.
PVR.ActStreamSignal Signal quality of the stream
PVR.ActStreamSnr Signal to noise ratio of the stream
PVR.ActStreamStatus Status of the stream
PVR.ActStreamUnc UNC value of the stream
PVR.ActStreamVideoBitRate Video bitrate of the stream
PVR.BackendChannels Number of available channels the backend provides
PVR.BackendDeletedRecordings Returns
The number of deleted recordings present on the backend.
PVR.BackendDiskSpace Available diskspace on the backend
PVR.BackendDiskspace Free diskspace available for recordings on the backend
PVR.BackendDiskSpaceProgr Returns
The available diskspace on the backend as percent value.
PVR.BackendHost Backend hostname
PVR.BackendName Name of the backend being used
PVR.BackendNumber Backend number
PVR.BackendRecordings Number of recording available on the backend
PVR.BackendTimers Number of timers set for the backend
PVR.BackendVersion version of the backend that's being used
PVR.ChannelNumberInput Label displaying the number the user entered on remote or keyboard v18
PVR.ClientCount Number of PVR clients enabled v22
PVR.ClientName Returns
The name of the PVR client add-on, as specified by the add-on developer.
PVR.EpgEventDuration[(format)] Returns the duration of the currently played title on TV. See ListItem.Duration for optinional formatting options
PVR.EpgEventElapsedTime[(format)] Returns the time position of the currently played title on TV. See ListItem.Duration for optinional formatting options
PVR.EpgEventFinishTime[(format)] Returns the time the currently playing epg event will end. See ListItem.Duration for optinional formatting options v18
PVR.EpgEventProgress Returns the position of currently played title on TV as integer
PVR.EpgEventRemainingTime[(format)] Returns the remaining time for currently playing epg event. See ListItem.Duration for optinional formatting options v18
PVR.EpgEventSeekTime[(format)] Returns the seek time of the currently playing epg event. See ListItem.Duration for optinional formatting options v18
PVR.InstanceName Returns
The name of the instance of the PVR client add-on, as specified by the user in the add-on settings. Empty if the PVR client add-on does not support multiple instances.
PVR.NextRecordingChannel Channel name of the next recording
PVR.NextRecordingDateTime Start date and time of the next recording
PVR.NextRecordingTitle Title of the next programme that will be recorded
PVR.NextTimer Next timer date
PVR.NowRecordingChannel Channel number that's being recorded
PVR.NowRecordingDateTime Start date and time of the current recording
PVR.NowRecordingTitle Title of the programme being recorded
PVR.RadioNextRecordingChannel Channel name of the next radio recording v17
PVR.RadioNextRecordingChannelIcon Returns
The icon of the next recording radio channel.
PVR.RadioNextRecordingDateTime Start date and time of the next radio recording v17
PVR.RadioNextRecordingTitle Title of the next radio programme that will be recorded v17
PVR.RadioNowRecordingChannel Channel name of the current radio recording v17
PVR.RadioNowRecordingChannelIcon Icon of the current recording radio channel v17
PVR.RadioNowRecordingDateTime Start date and time of the current radio recording v17
PVR.RadioNowRecordingTitle Title of the radio programme being recorded v17
PVR.TimeShiftCur[(format)] Current position of the timeshift. See ListItem.Duration for optinional formatting options
PVR.TimeShiftEnd[(format)] End position of the timeshift. See ListItem.Duration for optinional formatting options
PVR.TimeShiftOffset[(format)] Current offset of the timeshift. See ListItem.Duration for optinional formatting options
PVR.TimeShiftProgress Returns the position of currently timeshifted title on TV as interger
PVR.TimeshiftProgressBufferEnd Returns the percentage of the end of the timeshift buffer within the PVR timeshift progress v18
PVR.TimeshiftProgressBufferStart Returns the percentage of the start of the timeshift buffer within the PVR timeshift progress v18
PVR.TimeshiftProgressDuration Returns the duration of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero v18
PVR.TimeshiftProgressDuration(format) Returns the duration of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss) v18
PVR.TimeshiftProgressEndTime Returns the end time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero v18
PVR.TimeshiftProgressEndTime(format) Returns the end time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss) v18
PVR.TimeshiftProgressEpgEnd Returns the percentage of the end of the currently playing epg event within the PVR timeshift progress v18
PVR.TimeshiftProgressEpgStart Returns the percentage of the start of the currently playing epg event within the PVR timeshift progress v18
PVR.TimeshiftProgressPlayPos Returns the percentage of the current play position within the PVR timeshift progress v18
PVR.TimeshiftProgressStartTime Returns the start time of the PVR timeshift progress in the format hh:mm:ss. hh: will be omitted if hours value is zero v18
PVR.TimeshiftProgressStartTime(format) Returns the start time of the PVR timeshift progress in different formats, hours (hh), minutes (mm) or seconds (ss) v18
PVR.TimeShiftSeekbar This is the equivalent of Player.Seekbar, but for LiveTV (can be used in a slider control and indicates the position being seeked to) v19
PVR.TimeShiftStart[(format)] Start position of the timeshift. See ListItem.Duration for optinional formatting options
PVR.TotalDiscSpace Total diskspace available for recordings
PVR.TVNextRecordingChannel Channel name of the next tv recording v17
PVR.TVNextRecordingChannelIcon Icon of the next recording tv channel v17
PVR.TVNextRecordingDateTime Start date and time of the next tv recording v17
PVR.TVNextRecordingTitle Title of the next tv programme that will be recorded v17
PVR.TVNowRecordingChannel Channel name of the current tv recording v17
PVR.TVNowRecordingChannelIcon Icon of the current recording TV channel v17
PVR.TVNowRecordingDateTime Start date and time of the current tv recording v17
PVR.TVNowRecordingTitle Title of the tv programme being recorded v17

RDS

InfoLabels Description Version
RDS.Album The collection name to which this track belongs (Only be available on RadiotextPlus)
RDS.Artist A person or band/collective generally considered responsible for the work (Only be available on RadiotextPlus)
RDS.AudioLanguage The from RDS reported audio language of channel
RDS.Band Band/orchestra/accompaniment/musician (Only be available on RadiotextPlus)
RDS.ChannelCountry Country where the radio channel is sended
RDS.Comment Radio station comment string if available (Only be available on RadiotextPlus)
RDS.Composer Name of the original composer/author (Only be available on RadiotextPlus)
RDS.Conductor The artist(s) who performed the work. In classical music this would bethe conductor (Only be available on RadiotextPlus)
RDS.EmailHotline The email adress of the radio stations hotline (if available) (Only be available on RadiotextPlus)
RDS.EmailStudio The email adress of the radio stations studio (if available) (Only be available on RadiotextPlus)
RDS.GetLine(number) Returns the last sended RDS text messages on givern number, 0 is thelast and 4 rows are supported (0-3)
RDS.InfoCinema Information about movies in cinema (if available) (Only be available on RadiotextPlus)
RDS.InfoCinemaSize Number of rows present in cinema information (Only be available on RadiotextPlus)
RDS.InfoHoroscope Horoscope; either as one part or as two distinct parts:"key word 99text", e.g. "sign of the zodiac 99blablabla" (if available) (Only be available on RadiotextPlus)
RDS.InfoHoroscopeSize Number of rows present in horoscope information (Only be available on RadiotextPlus)
RDS.InfoLottery Raffle / lottery: "key word 99values" (if available) (Only be available on RadiotextPlus)
RDS.InfoLotterySize Number of rows present in lottery information (Only be available on RadiotextPlus)
RDS.InfoNews Message / headline (if available) (Only be available on RadiotextPlus)
RDS.InfoNewsLocal Local information news sended from radio channel (if available) (Only be available on RadiotextPlus)
RDS.InfoOther Other information, not especially specified: "key word 99info" (if available) (Only be available on RadiotextPlus)
RDS.InfoOtherSize Number of rows present with other informations (Only be available on RadiotextPlus)
RDS.InfoSport Result of a game; either as one part or as several distinct parts:"match 99result", e.g. "Bayern München : Borussia 995:5" (if available) (Only be available on RadiotextPlus)
RDS.InfoSportSize Number of rows present in sport information (Only be available on RadiotextPlus)
RDS.InfoStock Quote information; either as one part or as several distinct parts:"name 99latest value 99change 99high 99low 99volume" (if available) (Only be available on RadiotextPlus)
RDS.InfoStockSize Number of rows present in stock information (Only be available on RadiotextPlus)
RDS.InfoWeather Weather informations sended from radio channel (if available) (Only be available on RadiotextPlus)
RDS.InfoWeatherSize Number of rows present in weather information (Only be available on RadiotextPlus)
RDS.PhoneHotline The telephone number of the radio station's hotline (Only be available on RadiotextPlus)
RDS.PhoneStudio The telephone number of the radio station's studio (Only be available on RadiotextPlus)
RDS.ProgEditStaff Name of the editorial staff; e.g. name of editorial journalist (Only be available on RadiotextPlus)
RDS.ProgHomepage Link to radio station homepage (Only be available on RadiotextPlus)
RDS.ProgHost Name of the host of the radio show
RDS.ProgNext Next played program name (if available)@note becomes also be set from epg if from RDS not available
RDS.ProgNow Now played program name@note becomes also be set from epg if from RDS not available
RDS.ProgStation Name of the radio channel@note becomes also be set from epg if from RDS not available
RDS.ProgStyle Human readable string about radiostyle defined from RDS or RBDS
RDS.RadioStyle The from radio channel used style of currently played part, e.g "popmusic", "news" or "weather"
RDS.SmsStudio The sms number of the radio stations studio (to send directly a sms to the studio) (if available) (Only be available on RadiotextPlus)
RDS.Title Title of item; e.g. track title of an album (Only be available on RadiotextPlus)
RDS.TrackNumber The track number of the item on the album on which it was originallyreleased. (Only be available on RadiotextPlus)

Skin

InfoLabels Description Version
Skin.AspectRatio Returns the closest aspect ratio match using the resolution info from the skin's addon.xml file.
Skin.CurrentColourTheme Returns the current selected colour theme of the skin.
Skin.CurrentTheme Returns the current selected skin theme.
Skin.Font Returns the current fontset from Font.xml. v18 addition
Skin.Numeric(settingid) Returns
return the setting value as an integer/numeric value.

See also

Skin.SetNumeric(settingid)
Skin.String(name) Returns the user-set skin string, set via the Skin.SetString(name) List of Built In Functions. Allows skinners to have user-customisable labels.
Skin.TimerElapsedSecs(timer) Returns
The elapsed time in seconds for the provided timer.

Parameters

timer - the timer name

Slideshow

InfoLabels Description Version
Slideshow.Altitude Shows the altitude in meters where the current picture was taken. This is the value of the EXIF GPSInfo.GPSAltitude tag.
Slideshow.Aperture Shows the F-stop used to take the current picture. This is the value of the EXIF FNumber tag (hex code 0x829D).
Slideshow.Author Shows the name of the person involved in writing about the current picture. This is the value of the IPTC Writer tag (hex code 0x7A).
Slideshow.Byline Shows the name of the person who created the current picture. This is the value of the IPTC Byline tag (hex code 0x50).
Slideshow.BylineTitle Shows the title of the person who created the current picture. This is the value of the IPTC BylineTitle tag (hex code 0x55).
Slideshow.CameraMake Shows the manufacturer of the camera used to take the current picture. This is the value of the EXIF Make tag (hex code 0x010F).
Slideshow.CameraModel Shows the manufacturer's model name or number of the camera used to take the current picture. This is the value of the EXIF Model tag (hex code 0x0110).
Slideshow.Caption Shows a description of the current picture. This is the value of the IPTC Caption tag (hex code 0x78).
Slideshow.Category Shows the subject of the current picture as a category code. This is the value of the IPTC Category tag (hex code 0x0F).
Slideshow.CCDWidth Shows the width of the CCD in the camera used to take the current picture. This is calculated from three EXIF tags (0xA002 * 0xA210 / 0xA20e).
Slideshow.City Shows the city where the current picture was taken. This is the value of the IPTC City tag (hex code 0x5A).
Slideshow.Colour Shows whether the current picture is "Colour" or "Black and White".
Slideshow.CopyrightNotice Shows the copyright notice of the current picture. This is the value of the IPTC Copyright tag (hex code 0x74).
Slideshow.Country Shows the full name of the country where the current picture was taken. This is the value of the IPTC CountryName tag (hex code 0x65).
Slideshow.CountryCode Shows the country code of the country where the current picture was taken. This is the value of the IPTC CountryCode tag (hex code 0x64).
Slideshow.Credit Shows who provided the current picture. This is the value of the IPTC Credit tag (hex code 0x6E).
Slideshow.DigitalZoom Shows the digital zoom ratio when the current picture was taken. This is the value of the EXIF .DigitalZoomRatio tag (hex code 0xA404).
Slideshow.EXIFComment Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.SlideComment.
Slideshow.EXIFDate Shows the localized date of the current picture. The short form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
Slideshow.EXIFDescription Shows a short description of the current picture. The SlideComment, EXIFComment, or Caption values might contain a longer description. This is the value of the EXIF ImageDescription tag (hex code 0x010E).
Slideshow.EXIFSoftware Shows the name and version of the firmware used by the camera that took the current picture. This is the value of the EXIF Software tag (hex code 0x0131).
Slideshow.EXIFTime Shows the date/timestamp of the current picture. The localized short form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
Slideshow.Exposure Shows the class of the program used by the camera to set exposure when the current picture was taken. Values include "Manual", "Program (Auto)", "Aperture priority (Semi-Auto)", "Shutter priority (semi-auto)", etc. This is the value of the EXIF ExposureProgram tag (hex code 0x8822).
Slideshow.ExposureBias Shows the exposure bias of the current picture. Typically this is a number between -99.99 and 99.99. This is the value of the EXIF ExposureBiasValue tag (hex code 0x9204).
Slideshow.ExposureMode Shows the exposure mode of the current picture. The possible values are "Automatic", "Manual", and "Auto bracketing". This is the value of the EXIF ExposureMode tag (hex code 0xA402).
Slideshow.ExposureTime Shows the exposure time of the current picture, in seconds. This is the value of the EXIF ExposureTime tag (hex code 0x829A). If the ExposureTime tag is not found, the ShutterSpeedValue tag (hex code 0x9201) might be used.
Slideshow.Filedate Shows the file date of the current picture
Slideshow.Filename Shows the file name of the current picture
Slideshow.Filesize Shows the file size of the current picture
Slideshow.FlashUsed Shows the status of flash when the current picture was taken. The value will be either "Yes" or "No", and might include additional information. This is the value of the EXIF Flash tag (hex code 0x9209).
Slideshow.FocalLength Shows the focal length of the lens, in mm. This is the value of the EXIF FocalLength tag (hex code 0x920A).
Slideshow.FocusDistance Shows the distance to the subject, in meters. This is the value of the EXIF SubjectDistance tag (hex code 0x9206).
Slideshow.Headline Shows a synopsis of the contents of the current picture. This is the value of the IPTC Headline tag (hex code 0x69).
Slideshow.ImageType Shows the color components of the current picture. This is the value of the IPTC ImageType tag (hex code 0x82).
Slideshow.IPTCDate Shows the date when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC DateCreated tag (hex code 0x37).
Slideshow.ISOEquivalence Shows the ISO speed of the camera when the current picture was taken. This is the value of the EXIF ISOSpeedRatings tag (hex code 0x8827).
Slideshow.Keywords Shows keywords assigned to the current picture. This is the value of the IPTC Keywords tag (hex code 0x19).
Slideshow.Latitude Shows the latitude where the current picture was taken (degrees, minutes, seconds North or South). This is the value of the EXIF GPSInfo.GPSLatitude and GPSInfo.GPSLatitudeRef tags.
Slideshow.LightSource Shows the kind of light source when the picture was taken. Possible values include "Daylight", "Fluorescent", "Incandescent", etc. This is the value of the EXIF LightSource tag (hex code 0x9208).
Slideshow.LongEXIFDate Shows only the localized date of the current picture. The long form of the date is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. If the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
Slideshow.LongEXIFTime Shows the date/timestamp of the current picture. The localized long form of the date and time is used. The value of the EXIF DateTimeOriginal tag (hex code 0x9003) is preferred. if the DateTimeOriginal tag is not found, the value of DateTimeDigitized (hex code 0x9004) or of DateTime (hex code 0x0132) might be used.
Slideshow.Longitude Shows the longitude where the current picture was taken (degrees, minutes, seconds East or West). This is the value of the EXIF GPSInfo.GPSLongitude and GPSInfo.GPSLongitudeRef tags.
Slideshow.MeteringMode Shows the metering mode used when the current picture was taken. The possible values are "Center weight", "Spot", or "Matrix". This is the value of the EXIF MeteringMode tag (hex code 0x9207).
Slideshow.ObjectName Shows a shorthand reference for the current picture. This is the value of the IPTC ObjectName tag (hex code 0x05).
Slideshow.Orientation Shows the orientation of the current picture. Possible values are "Top Left", "Top Right", "Left Top", "Right Bottom", etc. This is the value of the EXIF Orientation tag (hex code 0x0112).
Slideshow.Path Shows the file path of the current picture
Slideshow.Process Shows the process used to compress the current picture
Slideshow.ReferenceService Shows the Service Identifier of a prior envelope to which the current picture refers. This is the value of the IPTC ReferenceService tag (hex code 0x2D).
Slideshow.Resolution Shows the dimensions of the current picture (Width x Height)
Slideshow.SlideComment Shows a description of the current picture. This is the value of the EXIF User Comment tag (hex code 0x9286). This is the same value as Slideshow.EXIFComment.
Slideshow.SlideIndex Shows the slide index of the current picture
Slideshow.Source Shows the original owner of the current picture. This is the value of the IPTC Source tag (hex code 0x73).
Slideshow.SpecialInstructions Shows other editorial instructions concerning the use of the current picture. This is the value of the IPTC SpecialInstructions tag (hex code 0x28).
Slideshow.State Shows the State/Province where the current picture was taken. This is the value of the IPTC ProvinceState tag (hex code 0x5F).
Slideshow.Sublocation Shows the location within a city where the current picture was taken - might indicate the nearest landmark. This is the value of the IPTC SubLocation tag (hex code 0x5C).
Slideshow.SupplementalCategories Shows supplemental category codes to further refine the subject of the current picture. This is the value of the IPTC SuppCategory tag (hex code 0x14).
Slideshow.TimeCreated Shows the time when the intellectual content of the current picture was created, rather than when the picture was created. This is the value of the IPTC TimeCreated tag (hex code 0x3C).
Slideshow.TransmissionReference Shows a code representing the location of original transmission of the current picture. This is the value of the IPTC TransmissionReference tag (hex code 0x67).
Slideshow.Urgency Shows the urgency of the current picture. Values are 1-9. The 1 is most urgent. Some image management programs use urgency to indicate picture rating, where urgency 1 is 5 stars and urgency 5 is 1 star. Urgencies 6-9 are not used for rating. This is the value of the IPTC Urgency tag (hex code 0x0A).
Slideshow.WhiteBalance Shows the white balance mode set when the current picture was taken. The possible values are "Manual" and "Auto". This is the value of the EXIF WhiteBalance tag (hex code 0xA403).

System

InfoLabels Description Version
System.AddonTitle(id) Returns the title of the addon with the given id
System.AddonUpdateCount The number of available addon updates v19
System.AddonVersion(id) Returns the version of the addon with the given id
System.AlarmPos Shutdown Timer position
System.BatteryLevel Returns the remaining battery level in range 0-100
System.BuildDate Date of build
System.BuildVersion version of build
System.BuildVersionCode The internal version of the kodi build v19
System.BuildVersionGit The git version (sha) of the kodi build v19
System.BuildVersionShort Returns
The shorter string with version of build.
System.CoreUsage(id) Displays the usage of the cpu core with the given 'id'
System.CpuFrequency System cpu frequency
System.CPUTemperature Current CPU temperature
System.CpuUsage Displays the cpu usage for each individual cpu core.
System.CurrentControl Current focused control
System.CurrentControlID ID of the currently focused control.
System.CurrentWindow Current Window we are in
System.Date Current date
System.Date(format) Show current date using format, available markings: d (day of month 1-31), dd (day of month 01-31), ddd (short day of the week Mon-Sun), DDD (long day of the week Monday-Sunday), m (month 1-12), mm (month 01-12), mmm (short month name Jan-Dec), MMM (long month name January-December), yy (2-digit year), yyyy (4-digit year). Added after dharma.
System.DVDLabel Label of the disk in the DVD-ROM drive
System.FanSpeed Current fan speed
System.FPS Current rendering speed (frames per second)
System.FreeMemory Amount of free memory in Mb
System.FreeSpace Total Freespace on the drive
System.FreeSpacePercent Total Freespace Percent on the drive
System.FriendlyName Returns the Kodi instance name. It will auto append (%hostname%) in case the device name was not changed. e.g. "Kodi (htpc)"
System.GetBool(boolean) Returns
The value of any standard system boolean setting.

Note
Will not work with settings in advancedsettings.xml

System.GPUTemperature Current GPU temperature
System.HddTemperature Hdd temperature
System.InternetState Will return the internet state, 'connected' or 'not connected' (localized)
System.KernelVersion (deprecated) System name + kernel version
System.Language Shows the current language
System.Locale(type) Returns
Locale-specific information depending on the requested type.

Parameters

type - Can be one of the following:
region The currently selected region name within the selected language ( System.Language ).
iso The country code of the currently selected region as specified in langinfo.xml.
[Removed options] timezonecountry and timezone from System.Locale(type)
System.Memory(format) Available formats: used, used.percent, free, free.percent, total
System.OSVersionInfo System name + kernel version
System.PrivacyPolicy Returns
The official Kodi privacy policy.
System.ProfileAutoLogin The profile Kodi will auto login to
System.ProfileCount Shows the number of defined profiles
System.ProfileName Shows the User name of the currently logged in Kodi user
System.Progressbar The percentage of the currently active progress.
System.ScreenHeight Height of screen in pixels
System.ScreenMode Screenmode (e.g. windowed / fullscreen)
System.ScreenResolution Screen resolution
System.ScreenWidth Width of screen in pixels
System.StartupWindow The Window Kodi will load on startup
System.StereoscopicMode The prefered stereoscopic mode (settings > video > playback)
System.SupportedHDRTypes Returns
The display's supported HDR types.
System.TemperatureUnits Shows Celsius or Fahrenheit symbol
System.Time Current time
System.Time(format) Shows hours (hh), minutes (mm) or seconds (ss). When 12 hour clock is used (xx) will return AM/PM. Also supported: (hh:mm), (mm:ss), (hh:mm:ss), (hh:mm:ss). (xx) option added after dharma
System.TotalSpace Totalspace on the drive
System.TotalUptime System total uptime
System.Uptime System current uptime
System.UsedSpace Total Usedspace on the drive
System.UsedSpacePercent Total Usedspace Percent on the drive
System.VideoEncoderInfo video encoder info

Visualisation

InfoLabels Description Version
Visualisation.Name Shows the name of the visualisation.
Visualisation.Preset Shows the current preset of the visualisation.

Weather

InfoLabels Description Version
Weather.Data(property) Returns
Weather data, as specified by the parameter.
Weather.LastUpdated Returns
The localized date and time weather data were last updated, empty string if not available.

Weather labels

InfoLabels Description Version
Weather.Conditions Current weather conditions – this is looked up in a background process.
Weather.fanartcode Current weather fanartcode.
Weather.Location City/town which the above two items are for
Weather.plugin Current weather plugin.
Weather.Temperature Current weather temperature

Window

InfoLabels Description Version
Window(AddonBrowser).Property(Updated) Shows the date and time the addon repo was last checked for updates
Window(Home).Property(key) The home window has the following info labels.

Movies.Count, Movies.Watched, Movies.UnWatched, TVShows.Count, TVShows.Watched, TVShows.UnWatched, Episodes.Count, Episodes.Watched, Episodes.UnWatched, MusicVideos.Count, MusicVideos.Watched, MusicVideos.UnWatched, Music.SongsCount, Music.AlbumsCount, Music.ArtistsCount

LatestMovie.[1-10].Title, LatestMovie.[1-10].Year, LatestMovie.[1-10].RunningTime, LatestMovie.[1-10].Rating, LatestMovie.[1-10].Plot, LatestMovie.[1-10].Trailer, LatestMovie.[1-10].Thumb, LatestMovie.[1-10].Fanart, LatestMovie.[1-10].Path

LatestEpisode.[1-10].ShowTitle, LatestEpisode.[1-10].EpisodeTitle, LatestEpisode.[1-10].EpisodeNo, LatestEpisode.[1-10].EpisodeSeason, LatestEpisode.[1-10].EpisodeNumber, LatestEpisode.[1-10].Rating, LatestEpisode.[1-10].Plot, LatestEpisode.[1-10].Thumb, LatestEpisode.[1-10].ShowThumb, LatestEpisode.[1-10].SeasonThumb, LatestEpisode.[1-10].Fanart, LatestEpisode.[1-10].Path

LatestMusicVideo.[1-10].Title, LatestMusicVideo.[1-10].Thumb, LatestMusicVideo.[1-10].Year, LatestMusicVideo.[1-10].Plot, LatestMusicVideo.[1-10].RunningTime, LatestMusicVideo.[1-10].Path, LatestMusicVideo.[1-10].Artist, LatestMusicVideo.[1-10].Fanart

LatestSong.[1-10].Title, LatestSong.[1-10].Artist, LatestSong.[1-10].Album, LatestSong.[1-10].Year, LatestSong.[1-10].Rating, LatestSong.[1-10].Thumb, LatestSong.[1-10].Fanart, LatestSong.[1-10].Path

LatestAlbum.[1-10].Title, LatestAlbum.[1-10].Artist, LatestAlbum.[1-10].Year, LatestAlbum.[1-10].Rating, LatestAlbum.[1-10].Thumb, LatestAlbum.[1-10].Fanart, LatestAlbum.[1-10].Path

Window(Weather).Property(key) The weather window has the following info labels.

Location, Updated, Current.Condition, Current.Temperature, Current.FeelsLike, Current.UVIndex, Current.Wind (From <wind dir.> at <speed> <unit>), Current.WindSpeed, Current.WindDirection, Current.DewPoint, Current.Humidity, Day[0-6].Title, Day[0-6].HighTemp, Day[0-6].LowTemp, Day[0-6].Outlook, WeatherProvider


Data set in Current.Temperature, Current.FeelsLike, Day[0-6].HighTemp, Day[0-6].LowTemp should be provided in Celsius, and will be autoconverted according to System.TemperatureUnits

Window([window]).Property(key) Window property. (key can be any value, optional window can be id or name)
Window.Property(Addon.ID) Returns the id of the selected addon, in DialogAddonSettings.xml
Window.Property(IsRadio) Returns "true" if the window is a radio window, empty string otherwise (for use in the PVR windows)
Window.Property(xmlfile) Displays the name of the xml file currently shown

Images Available in Kodi

See Artwork/Accessing with skins and JSON-RPC for the general pattern of accessing artwork for media items. Below is a list of other possible images available as InfoLabels.

InfoLabels Description Version
Fanart.Image Fanart image for the parent TV Show. Note: Deprecated, use ListItem.Art(tvshow.fanart) instead.
ListItem.ActualIcon Shows the default icon of the currently selected item in a list or thumb control.
ListItem.Art(type) Artwork for the current listitem.
ListItem.EPGEventIcon Returns the icon of the EPG programme (if available). v18
ListItem.Icon Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. If no thumbnail image exists, it will show the default icon.
ListItem.Overlay Shows the Overlay Icon status (compressed file [OverlayRAR.png], watched [OverlayWatched.png], unwatched [OverlayUnwatched.png], locked [OverlayLocked.png]) of the currently selected item in a list or thumb control.
ListItem.Property(Fanart_Image) Fanart Image currently selected item or of the parent TV show. Note: Deprecated, use ListItem.Art(fanart) or ListItem.Art(tvshow.fanart) instead.
ListItem.Thumb Shows the thumbnail (if it exists) of the currently selected item in a list or thumb control. Note: Deprecated but still available, returns the same as ListItem.Art(thumb).
MusicPlayer.Cover Cover of currently playing album
MusicPlayer.Property(Fanart_Image) Fanart image of the currently playing artist
Player.Art(type) Artwork for the currently playing item.
Player.Icon Shows the thumbnail (if it exists) of the currently playing item. If no thumbnail image exists, it will show the icon. v18
Player.StarRating Returns a value of 0 to 5 as a graphical display from images named rating0.png to rating5.png of the skin
Pvr.EPGEventIcon Returns the icon of the currently playing EPG programme (if available). v18
Pvr.NextRecordingChannelIcon Channel icon of the programme that will be recorded next.
Pvr.NowRecordingChannelIcon Channel icon of the programme currently being recorded.
Skin.String(name) Returns the image or image folder set by the user via a Skin.SetPath(name) or Skin.SetImage(name) List of Built In Functions. Allows skinners to have user-customisable images and multiimages.
System.AddonIcon(id) Returns the Icon of the specified addon. Instead of specifying the id directly, one can also use an infolabel (e.g. $INFO[Skin.String(Foo)])
System.ProfileThumb Shows the Thumbnail image of the currently logged in Kodi user
VideoPlayer.Cover Cover of currently playing movie. Note: Deprecated, use Player.Art(type) instead.
Weather.ConditionsIcon Image of current weather conditions (NOTE: Can be used to load/refresh weather conditions)
Window(Weather).Property(key) The weather window has the following info images.

Current.ConditionIcon, Day[0-6].OutlookIcon, Current.FanartCode, Day[0-6].FanartCode, WeatherProviderLogo

Window([window]).Property(key) Window property. (key can be any value, optional window can be id or name)



Return to top