Kodi Documentation 22.0
Kodi is an open source media player and entertainment hub.
Loading...
Searching...
No Matches
InfoTagVideo

Kodi's video info tag class. More...

Classes

class  XBMCAddon::xbmc::InfoTagVideo
 

Functions

SActorInfo XBMCAddon::xbmc::Actor::ToActorInfo () const
 
CStreamDetailVideoXBMCAddon::xbmc::VideoStreamDetail::ToStreamDetailVideo () const
 
CStreamDetailAudioXBMCAddon::xbmc::AudioStreamDetail::ToStreamDetailAudio () const
 
CStreamDetailSubtitleXBMCAddon::xbmc::SubtitleStreamDetail::ToStreamDetailSubtitle () const
 
 XBMCAddon::xbmc::InfoTagVideo::InfoTagVideo (const CVideoInfoTag *tag)
 
 XBMCAddon::xbmc::InfoTagVideo::InfoTagVideo (CVideoInfoTag *tag, bool offscreen=false)
 
 XBMCAddon::xbmc::InfoTagVideo::InfoTagVideo (...)
 

Function: xbmc.InfoTagVideo([offscreen])


Create a video info tag.
 
 XBMCAddon::xbmc::InfoTagVideo::~InfoTagVideo () override
 
 XBMCAddon::xbmc::InfoTagVideo::getDbId ()
 

Function: getDbId()


Get identification number of tag in database
 
 XBMCAddon::xbmc::InfoTagVideo::getDirector ()
 

Function: getDirector()


Get film director who has made the film (if present).
 
 XBMCAddon::xbmc::InfoTagVideo::getDirectors ()
 

Function: getDirectors()


Get a list of film directors who have made the film (if present).
 
 XBMCAddon::xbmc::InfoTagVideo::getWritingCredits ()
 

Function: getWritingCredits()


Get the writing credits if present from video info tag.
 
 XBMCAddon::xbmc::InfoTagVideo::getWriters ()
 

Function: getWriters()


Get the list of writers (if present) from video info tag.
 
 XBMCAddon::xbmc::InfoTagVideo::getGenre ()
 

Function: getGenre()


To get the Video Genre if available.
 
 XBMCAddon::xbmc::InfoTagVideo::getGenres ()
 

Function: getGenres()


Get the list of Video Genres if available.
 
 XBMCAddon::xbmc::InfoTagVideo::getTagLine ()
 

Function: getTagLine()


Get video tag line if available.
 
 XBMCAddon::xbmc::InfoTagVideo::getPlotOutline ()
 

Function: getPlotOutline()


Get the outline plot of the video if present.
 
 XBMCAddon::xbmc::InfoTagVideo::getPlot ()
 

Function: getPlot()


Get the plot of the video if present.
 
 XBMCAddon::xbmc::InfoTagVideo::getPictureURL ()
 

Function: getPictureURL()


Get a picture URL of the video to show as screenshot.
 
 XBMCAddon::xbmc::InfoTagVideo::getTitle ()
 

Function: getTitle()


Get the video title.
 
 XBMCAddon::xbmc::InfoTagVideo::getTVShowTitle ()
 

Function: getTVShowTitle()


Get the video TV show title.
 
 XBMCAddon::xbmc::InfoTagVideo::getMediaType ()
 

Function: getMediaType()


Get the media type of the video.
 
 XBMCAddon::xbmc::InfoTagVideo::getVotes ()
 

Function: getVotes()


Get the video votes if available from video info tag.
 
 XBMCAddon::xbmc::InfoTagVideo::getVotesAsInt (type)
 

Function: getVotesAsInt([type])


Get the votes of the rating (if available) as an integer.
 
 XBMCAddon::xbmc::InfoTagVideo::getCast ()
 

Function: getCast()


To get the cast of the video when available.
 
 XBMCAddon::xbmc::InfoTagVideo::getActors ()
 

Function: getActors()


Get the cast of the video if available.
 
 XBMCAddon::xbmc::InfoTagVideo::getFile ()
 

Function: getFile()


To get the video file name.
 
 XBMCAddon::xbmc::InfoTagVideo::getPath ()
 

Function: getPath()


To get the path where the video is stored.
 
 XBMCAddon::xbmc::InfoTagVideo::getFilenameAndPath ()
 

Function: getFilenameAndPath()


To get the full path with filename where the video is stored.
 
 XBMCAddon::xbmc::InfoTagVideo::getIMDBNumber ()
 

Function: getIMDBNumber()


To get the IMDb number of the video (if present).
 
 XBMCAddon::xbmc::InfoTagVideo::getSeason ()
 

Function: getSeason()


To get season number of a series
 
 XBMCAddon::xbmc::InfoTagVideo::getEpisode ()
 

Function: getEpisode()


To get episode number of a series
 
 XBMCAddon::xbmc::InfoTagVideo::getYear ()
 

Function: getYear()


Get production year of video if present.
 
 XBMCAddon::xbmc::InfoTagVideo::getRating (type)
 

Function: getRating([type])


Get the video rating if present as float (double where supported).
 
 XBMCAddon::xbmc::InfoTagVideo::getUserRating ()
 

Function: getUserRating()


Get the user rating if present as integer.
 
 XBMCAddon::xbmc::InfoTagVideo::getPlayCount ()
 

Function: getPlayCount()


To get the number of plays of the video.
 
 XBMCAddon::xbmc::InfoTagVideo::getLastPlayed ()
 

Function: getLastPlayed()


Get the last played date / time as string.
 
 XBMCAddon::xbmc::InfoTagVideo::getLastPlayedAsW3C ()
 

Function: getLastPlayedAsW3C()


Get last played datetime as string in W3C format (YYYY-MM-DDThh:mm:ssTZD).
 
 XBMCAddon::xbmc::InfoTagVideo::getOriginalTitle ()
 

Function: getOriginalTitle()


To get the original title of the video.
 
 XBMCAddon::xbmc::InfoTagVideo::getPremiered ()
 

Function: getPremiered()


To get premiered date of the video, if available.
 
 XBMCAddon::xbmc::InfoTagVideo::getPremieredAsW3C ()
 

Function: getPremieredAsW3C()


Get premiered date as string in W3C format (YYYY-MM-DD).
 
 XBMCAddon::xbmc::InfoTagVideo::getFirstAired ()
 

Function: getFirstAired()


Returns first aired date as string from info tag.
 
 XBMCAddon::xbmc::InfoTagVideo::getFirstAiredAsW3C ()
 

Function: getFirstAiredAsW3C()


Get first aired date as string in W3C format (YYYY-MM-DD).
 
 XBMCAddon::xbmc::InfoTagVideo::getTrailer ()
 

Function: getTrailer()


To get the path where the trailer is stored.
 
 XBMCAddon::xbmc::InfoTagVideo::getArtist ()
 

Function: getArtist()


To get the artist name (for musicvideos)
 
 XBMCAddon::xbmc::InfoTagVideo::getAlbum ()
 

Function: getAlbum()


To get the album name (for musicvideos)
 
 XBMCAddon::xbmc::InfoTagVideo::getTrack ()
 

Function: getTrack()


To get the track number (for musicvideos)
 
 XBMCAddon::xbmc::InfoTagVideo::getDuration ()
 

Function: getDuration()


To get the duration
 
 XBMCAddon::xbmc::InfoTagVideo::getResumeTime (...)
 

Function: getResumeTime())


Gets the resume time of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::getResumeTimeTotal (...)
 

Function: getResumeTimeTotal())


Gets the total duration stored with the resume time of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::getUniqueID (key)
 

Function: getUniqueID(key)


Get the unique ID of the given key. A unique ID is an identifier used by a (online) video database used to identify a video in its database.
 
 XBMCAddon::xbmc::InfoTagVideo::setUniqueID (...)
 

Function: setUniqueID(uniqueid, [type], [isdefault])


Set the given unique ID. A unique ID is an identifier used by a (online) video database used to identify a video in its database.
 
 XBMCAddon::xbmc::InfoTagVideo::setUniqueIDs (...)
 

Function: setUniqueIDs(values, defaultuniqueid)


Set the given unique IDs. A unique ID is an identifier used by a (online) video database used to identify a video in its database.
 
 XBMCAddon::xbmc::InfoTagVideo::setDbId (...)
 

Function: setDbId(dbid)


Set the database identifier of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setYear (...)
 

Function: setYear(year)


Set the year of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setEpisode (...)
 

Function: setEpisode(episode)


Set the episode number of the episode.
 
 XBMCAddon::xbmc::InfoTagVideo::setSeason (...)
 

Function: setSeason(season)


Set the season number of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setSortEpisode (...)
 

Function: setSortEpisode(sortepisode)


Set the episode sort number of the episode.
 
 XBMCAddon::xbmc::InfoTagVideo::setSortSeason (...)
 

Function: setSortSeason(sortseason)


Set the season sort number of the season.
 
 XBMCAddon::xbmc::InfoTagVideo::setEpisodeGuide (...)
 

Function: setEpisodeGuide(episodeguide)


Set the episode guide of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTop250 (...)
 

Function: setTop250(top250)


Set the top 250 number of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setSetId (...)
 

Function: setSetId(setid)


Set the movie set identifier of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTrackNumber (...)
 

Function: setTrackNumber(tracknumber)


Set the track number of the music video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setRating (...)
 

Function: setRating(rating, [votes], [type], [isdefault])


Set the rating of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setRatings (...)
 

Function: setRatings(ratings, [defaultrating])


Set the ratings of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setUserRating (...)
 

Function: setUserRating(userrating)


Set the user rating of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setPlaycount (...)
 

Function: setPlaycount(playcount)


Set the playcount of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setMpaa (...)
 

Function: setMpaa(mpaa)


Set the MPAA rating of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setPlot (...)
 

Function: setPlot(plot)


Set the plot of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setPlotOutline (...)
 

Function: setPlotOutline(plotoutline)


Set the plot outline of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTitle (...)
 

Function: setTitle(title)


Set the title of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setOriginalTitle (...)
 

Function: setOriginalTitle(originaltitle)


Set the original title of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setSortTitle (...)
 

Function: setSortTitle(sorttitle)


Set the sort title of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTagLine (...)
 

Function: setTagLine(tagline)


Set the tagline of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTvShowTitle (...)
 

Function: setTvShowTitle(tvshowtitle)


Set the TV show title of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTvShowStatus (...)
 

Function: setTvShowStatus(tvshowstatus)


Set the TV show status of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setGenres (...)
 

Function: setGenres(genre)


Set the genres of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setCountries (...)
 

Function: setCountries(countries)


Set the countries of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setDirectors (...)
 

Function: setDirectors(directors)


Set the directors of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setStudios (...)
 

Function: setStudios(studios)


Set the studios of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setWriters (...)
 

Function: setWriters(writers)


Set the writers of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setDuration (...)
 

Function: setDuration(duration)


Set the duration of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setPremiered (...)
 

Function: setPremiered(premiered)


Set the premiere date of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setSet (...)
 

Function: setSet(set)


Set the movie set (name) of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setSetOverview (...)
 

Function: setSetOverview(setoverview)


Set the movie set overview of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTags (...)
 

Function: setTags(tags)


Set the tags of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setVideoAssetTitle (...)
 

Function: setVideoAssetTitle(videoAssetTitle)


Set the video asset title of the item.
 
 XBMCAddon::xbmc::InfoTagVideo::setProductionCode (...)
 

Function: setProductionCode(const String& productioncode)


Set the production code of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setFirstAired (...)
 

Function: setFirstAired(firstaired)


Set the first aired date of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setLastPlayed (...)
 

Function: setLastPlayed(lastplayed)


Set the last played date of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setAlbum (...)
 

Function: setAlbum(album)


Set the album of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setVotes (...)
 

Function: setVotes(votes)


Set the number of votes of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setTrailer (...)
 

Function: setTrailer(trailer)


Set the trailer of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setPath (...)
 

Function: setPath(path)


Set the path of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setFilenameAndPath (...)
 

Function: setFilenameAndPath(filenameandpath)


Set the filename and path of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setIMDBNumber (...)
 

Function: setIMDBNumber(imdbnumber)


Set the IMDb number of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setDateAdded (...)
 

Function: setDateAdded(dateadded)


Set the date added of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setMediaType (...)
 

Function: setMediaType(mediatype)


Set the media type of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setShowLinks (...)
 

Function: setShowLinks(showlinks)


Set the TV show links of the movie.
 
 XBMCAddon::xbmc::InfoTagVideo::setArtists (...)
 

Function: setArtists(artists)


Set the artists of the music video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setCast (...)
 

Function: setCast(actors)


Set the cast / actors of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::setResumePoint (...)
 

Function: setResumePoint(time, [totaltime])


Set the resume point of the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::addSeason (...)
 

Function: addSeason(number, [name])


Add a season with name. It needs at least the season number.
 
 XBMCAddon::xbmc::InfoTagVideo::addSeasons (...)
 

Function: addSeasons(namedseasons)


Add named seasons to the TV show.
 
 XBMCAddon::xbmc::InfoTagVideo::addVideoStream (...)
 

Function: addVideoStream(stream)


Add a video stream to the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::addAudioStream (...)
 

Function: addAudioStream(stream)


Add an audio stream to the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::addSubtitleStream (...)
 

Function: addSubtitleStream(stream)


Add a subtitle stream to the video item.
 
 XBMCAddon::xbmc::InfoTagVideo::addAvailableArtwork (...)
 

Function: addAvailableArtwork(images)


Add an image to available artworks (needed for video scrapers)
 

Detailed Description

Kodi's video info tag class.

Class: xbmc.InfoTagVideo([offscreen])

Access and / or modify the video metadata of a ListItem.


Example:

...
tag = xbmc.Player().getVideoInfoTag()
title = tag.getTitle()
file = tag.getFile()
...

Function Documentation

◆ addAudioStream()

void XBMCAddon::xbmc::InfoTagVideo::addAudioStream ( ...)

Function: addAudioStream(stream)


Add an audio stream to the video item.

Parameters
streamAudioStreamDetail - Audio stream.

v20 Python API changes
New function added.

◆ addAvailableArtwork()

void XBMCAddon::xbmc::InfoTagVideo::addAvailableArtwork ( ...)

Function: addAvailableArtwork(images)


Add an image to available artworks (needed for video scrapers)

Parameters
urlstring - image path url
arttypestring - image type
preview[opt] string - image preview path url
referrer[opt] string - referrer url
cache[opt] string - filename in cache
post[opt] bool - use post to retrieve the image (default false)
isgz[opt] bool - use gzip to retrieve the image (default false)
season[opt] integer - number of season in case of season thumb

v20 Python API changes
New function added.

Example:

...
infotagvideo.addAvailableArtwork(path_to_image_1, "thumb")
...

◆ addSeason()

void XBMCAddon::xbmc::InfoTagVideo::addSeason ( ...)

Function: addSeason(number, [name])


Add a season with name. It needs at least the season number.

Parameters
numberint - the number of the season.
namestring - the name of the season. Default "".

v20 Python API changes
New function added.

Example:

...
# addSeason(number, name))
infotagvideo.addSeason(1, "Murder House")
...

◆ addSeasons()

void XBMCAddon::xbmc::InfoTagVideo::addSeasons ( ...)

Function: addSeasons(namedseasons)


Add named seasons to the TV show.

Parameters
namedseasonslist - [ (season, name) ].

v20 Python API changes
New function added.

◆ addSubtitleStream()

void XBMCAddon::xbmc::InfoTagVideo::addSubtitleStream ( ...)

Function: addSubtitleStream(stream)


Add a subtitle stream to the video item.

Parameters
streamSubtitleStreamDetail - Subtitle stream.

v20 Python API changes
New function added.

◆ addVideoStream()

void XBMCAddon::xbmc::InfoTagVideo::addVideoStream ( ...)

Function: addVideoStream(stream)


Add a video stream to the video item.

Parameters
streamVideoStreamDetail - Video stream.

v20 Python API changes
New function added.

◆ getActors()

std::vector< Actor * > XBMCAddon::xbmc::InfoTagVideo::getActors ( )

Function: getActors()


Get the cast of the video if available.

Returns
[list] List of actors

v20 Python API changes
New function added.

◆ getAlbum()

String XBMCAddon::xbmc::InfoTagVideo::getAlbum ( )

Function: getAlbum()


To get the album name (for musicvideos)

Returns
[string] Album name

v18 Python API changes
New function added.

◆ getArtist()

std::vector< std::string > XBMCAddon::xbmc::InfoTagVideo::getArtist ( )

Function: getArtist()


To get the artist name (for musicvideos)

Returns
[std::vector<std::string>] Artist name

v18 Python API changes
New function added.

◆ getCast()

String XBMCAddon::xbmc::InfoTagVideo::getCast ( )

Function: getCast()


To get the cast of the video when available.

Returns
[string] Video casts

v20 Python API changes
Deprecated. Use getActors() instead.

◆ getDbId()

int XBMCAddon::xbmc::InfoTagVideo::getDbId ( )

Function: getDbId()


Get identification number of tag in database

Returns
[integer] database id

v17 Python API changes
New function added.

◆ getDirector()

String XBMCAddon::xbmc::InfoTagVideo::getDirector ( )

Function: getDirector()


Get film director who has made the film (if present).

Returns
[string] Film director name.

v20 Python API changes
Deprecated. Use getDirectors() instead.

◆ getDirectors()

std::vector< String > XBMCAddon::xbmc::InfoTagVideo::getDirectors ( )

Function: getDirectors()


Get a list of film directors who have made the film (if present).

Returns
[list] List of film director names.

v20 Python API changes
New function added.

◆ getDuration()

unsigned int XBMCAddon::xbmc::InfoTagVideo::getDuration ( )

Function: getDuration()


To get the duration

Returns
[unsigned int] Duration

v18 Python API changes
New function added.

◆ getEpisode()

int XBMCAddon::xbmc::InfoTagVideo::getEpisode ( )

Function: getEpisode()


To get episode number of a series

Returns
[integer] episode number

v17 Python API changes
New function added.

◆ getFile()

String XBMCAddon::xbmc::InfoTagVideo::getFile ( )

Function: getFile()


To get the video file name.

Returns
[string] File name

◆ getFilenameAndPath()

String XBMCAddon::xbmc::InfoTagVideo::getFilenameAndPath ( )

Function: getFilenameAndPath()


To get the full path with filename where the video is stored.

Returns
[string] File name and Path

v19 Python API changes
New function added.

◆ getFirstAired()

String XBMCAddon::xbmc::InfoTagVideo::getFirstAired ( )

Function: getFirstAired()


Returns first aired date as string from info tag.

Returns
[string] First aired date

v20 Python API changes
Deprecated. Use getFirstAiredAsW3C() instead.

◆ getFirstAiredAsW3C()

String XBMCAddon::xbmc::InfoTagVideo::getFirstAiredAsW3C ( )

Function: getFirstAiredAsW3C()


Get first aired date as string in W3C format (YYYY-MM-DD).

Returns
[string] First aired date (W3C)

v20 Python API changes
New function added.

◆ getGenre()

String XBMCAddon::xbmc::InfoTagVideo::getGenre ( )

Function: getGenre()


To get the Video Genre if available.

Returns
[string] Genre name

v20 Python API changes
Deprecated. Use getGenres() instead.

◆ getGenres()

std::vector< String > XBMCAddon::xbmc::InfoTagVideo::getGenres ( )

Function: getGenres()


Get the list of Video Genres if available.

Returns
[list] List of genres

v20 Python API changes
New function added.

◆ getIMDBNumber()

String XBMCAddon::xbmc::InfoTagVideo::getIMDBNumber ( )

Function: getIMDBNumber()


To get the IMDb number of the video (if present).

Returns
[string] IMDb number

◆ getLastPlayed()

String XBMCAddon::xbmc::InfoTagVideo::getLastPlayed ( )

Function: getLastPlayed()


Get the last played date / time as string.

Returns
[string] Last played date / time

v20 Python API changes
Deprecated. Use getLastPlayedAsW3C() instead.

◆ getLastPlayedAsW3C()

String XBMCAddon::xbmc::InfoTagVideo::getLastPlayedAsW3C ( )

Function: getLastPlayedAsW3C()


Get last played datetime as string in W3C format (YYYY-MM-DDThh:mm:ssTZD).

Returns
[string] Last played datetime (W3C)

v20 Python API changes
New function added.

◆ getMediaType()

String XBMCAddon::xbmc::InfoTagVideo::getMediaType ( )

Function: getMediaType()


Get the media type of the video.

Returns
[string] media type

Available strings about media type for video:

String Description
video For normal video
set For a selection of video
musicvideo To define it as music video
movie To define it as normal movie
tvshow If this is it defined as tvshow
season The type is used as a series season
episode The type is used as a series episode

v17 Python API changes
New function added.

◆ getOriginalTitle()

String XBMCAddon::xbmc::InfoTagVideo::getOriginalTitle ( )

Function: getOriginalTitle()


To get the original title of the video.

Returns
[string] Original title

◆ getPath()

String XBMCAddon::xbmc::InfoTagVideo::getPath ( )

Function: getPath()


To get the path where the video is stored.

Returns
[string] Path

◆ getPictureURL()

String XBMCAddon::xbmc::InfoTagVideo::getPictureURL ( )

Function: getPictureURL()


Get a picture URL of the video to show as screenshot.

Returns
[string] Picture URL

◆ getPlayCount()

int XBMCAddon::xbmc::InfoTagVideo::getPlayCount ( )

Function: getPlayCount()


To get the number of plays of the video.

Returns
[integer] Play Count

◆ getPlot()

String XBMCAddon::xbmc::InfoTagVideo::getPlot ( )

Function: getPlot()


Get the plot of the video if present.

Returns
[string] Plot

◆ getPlotOutline()

String XBMCAddon::xbmc::InfoTagVideo::getPlotOutline ( )

Function: getPlotOutline()


Get the outline plot of the video if present.

Returns
[string] Outline plot

◆ getPremiered()

String XBMCAddon::xbmc::InfoTagVideo::getPremiered ( )

Function: getPremiered()


To get premiered date of the video, if available.

Returns
[string]

v20 Python API changes
Deprecated. Use getPremieredAsW3C() instead.

◆ getPremieredAsW3C()

String XBMCAddon::xbmc::InfoTagVideo::getPremieredAsW3C ( )

Function: getPremieredAsW3C()


Get premiered date as string in W3C format (YYYY-MM-DD).

Returns
[string] Premiered date (W3C)

v20 Python API changes
New function added.

◆ getRating()

double XBMCAddon::xbmc::InfoTagVideo::getRating ( type )

Function: getRating([type])


Get the video rating if present as float (double where supported).

Parameters
type[opt] string - the type of the rating.
  • Some rating type values (any string possible):
    Label Type
    imdb string - type name
    tvdb string - type name
    tmdb string - type name
    anidb string - type name
Returns
[float] The rating of the video

v20 Python API changes
Optional type parameter added.

◆ getResumeTime()

double XBMCAddon::xbmc::InfoTagVideo::getResumeTime ( ...)

Function: getResumeTime())


Gets the resume time of the video item.

Returns
[double] Resume time

v20 Python API changes
New function added.

◆ getResumeTimeTotal()

double XBMCAddon::xbmc::InfoTagVideo::getResumeTimeTotal ( ...)

Function: getResumeTimeTotal())


Gets the total duration stored with the resume time of the video item.

Returns
[double] Total duration stored with the resume time

v20 Python API changes
New function added.

◆ getSeason()

int XBMCAddon::xbmc::InfoTagVideo::getSeason ( )

Function: getSeason()


To get season number of a series

Returns
[integer] season number

v17 Python API changes
New function added.

◆ getTagLine()

String XBMCAddon::xbmc::InfoTagVideo::getTagLine ( )

Function: getTagLine()


Get video tag line if available.

Returns
[string] Video tag line

◆ getTitle()

String XBMCAddon::xbmc::InfoTagVideo::getTitle ( )

Function: getTitle()


Get the video title.

Returns
[string] Video title

◆ getTrack()

int XBMCAddon::xbmc::InfoTagVideo::getTrack ( )

Function: getTrack()


To get the track number (for musicvideos)

Returns
[int] Track number

v18 Python API changes
New function added.

◆ getTrailer()

String XBMCAddon::xbmc::InfoTagVideo::getTrailer ( )

Function: getTrailer()


To get the path where the trailer is stored.

Returns
[string] Trailer path

v17 Python API changes
New function added.

◆ getTVShowTitle()

String XBMCAddon::xbmc::InfoTagVideo::getTVShowTitle ( )

Function: getTVShowTitle()


Get the video TV show title.

Returns
[string] TV show title

v17 Python API changes
New function added.

◆ getUniqueID()

String XBMCAddon::xbmc::InfoTagVideo::getUniqueID ( key )

Function: getUniqueID(key)


Get the unique ID of the given key. A unique ID is an identifier used by a (online) video database used to identify a video in its database.

Parameters
keystring - uniqueID name.
  • Some default uniqueID values (any string possible):
    Label Type
    imdb string - uniqueid name
    tvdb string - uniqueid name
    tmdb string - uniqueid name
    anidb string - uniqueid name

v20 Python API changes
New function added.

◆ getUserRating()

int XBMCAddon::xbmc::InfoTagVideo::getUserRating ( )

Function: getUserRating()


Get the user rating if present as integer.

Returns
[integer] The user rating of the video

◆ getVotes()

String XBMCAddon::xbmc::InfoTagVideo::getVotes ( )

Function: getVotes()


Get the video votes if available from video info tag.

Returns
[string] Votes

v20 Python API changes
Deprecated. Use getVotesAsInt() instead.

◆ getVotesAsInt()

int XBMCAddon::xbmc::InfoTagVideo::getVotesAsInt ( type )

Function: getVotesAsInt([type])


Get the votes of the rating (if available) as an integer.

Parameters
type[opt] string - the type of the rating.
  • Some rating type values (any string possible):
    Label Type
    imdb string - type name
    tvdb string - type name
    tmdb string - type name
    anidb string - type name
Returns
[integer] Votes

v20 Python API changes
New function added.

◆ getWriters()

std::vector< String > XBMCAddon::xbmc::InfoTagVideo::getWriters ( )

Function: getWriters()


Get the list of writers (if present) from video info tag.

Returns
[list] List of writers

v20 Python API changes
New function added.

◆ getWritingCredits()

String XBMCAddon::xbmc::InfoTagVideo::getWritingCredits ( )

Function: getWritingCredits()


Get the writing credits if present from video info tag.

Returns
[string] Writing credits

v20 Python API changes
Deprecated. Use getWriters() instead.

◆ getYear()

int XBMCAddon::xbmc::InfoTagVideo::getYear ( )

Function: getYear()


Get production year of video if present.

Returns
[integer] Production Year

◆ InfoTagVideo() [1/3]

XBMCAddon::xbmc::InfoTagVideo::InfoTagVideo ( ...)

Function: xbmc.InfoTagVideo([offscreen])


Create a video info tag.

Parameters
offscreen[opt] bool (default False) - if GUI based locks should be avoided. Most of the times listitems are created offscreen and added later to a container for display (e.g. plugins) or they are not even displayed (e.g. python scrapers). In such cases, there is no need to lock the GUI when creating the items (increasing your addon performance). Note however, that if you are creating listitems and managing the container itself (e.g using WindowXML or WindowXMLDialog classes) subsquent modifications to the item will require locking. Thus, in such cases, use the default value (False).

v20 Python API changes
Added offscreen argument.

Example:

...
videoinfo = xbmc.InfoTagVideo(offscreen=False)
...

◆ InfoTagVideo() [2/3]

XBMCAddon::xbmc::InfoTagVideo::InfoTagVideo ( const CVideoInfoTag * tag)
explicit

◆ InfoTagVideo() [3/3]

XBMCAddon::xbmc::InfoTagVideo::InfoTagVideo ( CVideoInfoTag * tag,
bool offscreen = false )
explicit

◆ setAlbum()

void XBMCAddon::xbmc::InfoTagVideo::setAlbum ( ...)

Function: setAlbum(album)


Set the album of the video item.

Parameters
albumstring - Album.

v20 Python API changes
New function added.

◆ setArtists()

void XBMCAddon::xbmc::InfoTagVideo::setArtists ( ...)

Function: setArtists(artists)


Set the artists of the music video item.

Parameters
artistslist - Artists.

v20 Python API changes
New function added.

◆ setCast()

void XBMCAddon::xbmc::InfoTagVideo::setCast ( ...)

Function: setCast(actors)


Set the cast / actors of the video item.

Parameters
actorslist - Cast / Actors.

v20 Python API changes
New function added.

◆ setCountries()

void XBMCAddon::xbmc::InfoTagVideo::setCountries ( ...)

Function: setCountries(countries)


Set the countries of the video item.

Parameters
countrieslist - Countries.

v20 Python API changes
New function added.

◆ setDateAdded()

void XBMCAddon::xbmc::InfoTagVideo::setDateAdded ( ...)

Function: setDateAdded(dateadded)


Set the date added of the video item.

Parameters
dateaddedstring - Date added (YYYY-MM-DD HH:MM:SS).

v20 Python API changes
New function added.

◆ setDbId()

void XBMCAddon::xbmc::InfoTagVideo::setDbId ( ...)

Function: setDbId(dbid)


Set the database identifier of the video item.

Parameters
dbidinteger - Database identifier.

v20 Python API changes
New function added.

◆ setDirectors()

void XBMCAddon::xbmc::InfoTagVideo::setDirectors ( ...)

Function: setDirectors(directors)


Set the directors of the video item.

Parameters
directorslist - Directors.

v20 Python API changes
New function added.

◆ setDuration()

void XBMCAddon::xbmc::InfoTagVideo::setDuration ( ...)

Function: setDuration(duration)


Set the duration of the video item.

Parameters
durationinteger - Duration in seconds.

v20 Python API changes
New function added.

◆ setEpisode()

void XBMCAddon::xbmc::InfoTagVideo::setEpisode ( ...)

Function: setEpisode(episode)


Set the episode number of the episode.

Parameters
episodeinteger - Episode number.

v20 Python API changes
New function added.

◆ setEpisodeGuide()

void XBMCAddon::xbmc::InfoTagVideo::setEpisodeGuide ( ...)

Function: setEpisodeGuide(episodeguide)


Set the episode guide of the video item.

Parameters
episodeguidestring - Episode guide.

v20 Python API changes
New function added.

◆ setFilenameAndPath()

void XBMCAddon::xbmc::InfoTagVideo::setFilenameAndPath ( ...)

Function: setFilenameAndPath(filenameandpath)


Set the filename and path of the video item.

Parameters
filenameandpathstring - Filename and path.

v20 Python API changes
New function added.

◆ setFirstAired()

void XBMCAddon::xbmc::InfoTagVideo::setFirstAired ( ...)

Function: setFirstAired(firstaired)


Set the first aired date of the video item.

Parameters
firstairedstring - First aired date.

v20 Python API changes
New function added.

◆ setGenres()

void XBMCAddon::xbmc::InfoTagVideo::setGenres ( ...)

Function: setGenres(genre)


Set the genres of the video item.

Parameters
genrelist - Genres.

v20 Python API changes
New function added.

◆ setIMDBNumber()

void XBMCAddon::xbmc::InfoTagVideo::setIMDBNumber ( ...)

Function: setIMDBNumber(imdbnumber)


Set the IMDb number of the video item.

Parameters
imdbnumberstring - IMDb number.

v20 Python API changes
New function added.

◆ setLastPlayed()

void XBMCAddon::xbmc::InfoTagVideo::setLastPlayed ( ...)

Function: setLastPlayed(lastplayed)


Set the last played date of the video item.

Parameters
lastplayedstring - Last played date (YYYY-MM-DD HH:MM:SS).

v20 Python API changes
New function added.

◆ setMediaType()

void XBMCAddon::xbmc::InfoTagVideo::setMediaType ( ...)

Function: setMediaType(mediatype)


Set the media type of the video item.

Parameters
mediatypestring - Media type.

v20 Python API changes
New function added.

◆ setMpaa()

void XBMCAddon::xbmc::InfoTagVideo::setMpaa ( ...)

Function: setMpaa(mpaa)


Set the MPAA rating of the video item.

Parameters
mpaastring - MPAA rating.

v20 Python API changes
New function added.

◆ setOriginalTitle()

void XBMCAddon::xbmc::InfoTagVideo::setOriginalTitle ( ...)

Function: setOriginalTitle(originaltitle)


Set the original title of the video item.

Parameters
originaltitlestring - Original title.

v20 Python API changes
New function added.

◆ setPath()

void XBMCAddon::xbmc::InfoTagVideo::setPath ( ...)

Function: setPath(path)


Set the path of the video item.

Parameters
pathstring - Path.

v20 Python API changes
New function added.

◆ setPlaycount()

void XBMCAddon::xbmc::InfoTagVideo::setPlaycount ( ...)

Function: setPlaycount(playcount)


Set the playcount of the video item.

Parameters
playcountinteger - Playcount.

v20 Python API changes
New function added.

◆ setPlot()

void XBMCAddon::xbmc::InfoTagVideo::setPlot ( ...)

Function: setPlot(plot)


Set the plot of the video item.

Parameters
plotstring - Plot.

v20 Python API changes
New function added.

◆ setPlotOutline()

void XBMCAddon::xbmc::InfoTagVideo::setPlotOutline ( ...)

Function: setPlotOutline(plotoutline)


Set the plot outline of the video item.

Parameters
plotoutlinestring - Plot outline.

v20 Python API changes
New function added.

◆ setPremiered()

void XBMCAddon::xbmc::InfoTagVideo::setPremiered ( ...)

Function: setPremiered(premiered)


Set the premiere date of the video item.

Parameters
premieredstring - Premiere date.

v20 Python API changes
New function added.

◆ setProductionCode()

void XBMCAddon::xbmc::InfoTagVideo::setProductionCode ( ...)

Function: setProductionCode(const String& productioncode)


Set the production code of the video item.

Parameters
productioncodestring - Production code.

v20 Python API changes
New function added.

◆ setRating()

void XBMCAddon::xbmc::InfoTagVideo::setRating ( ...)

Function: setRating(rating, [votes], [type], [isdefault])


Set the rating of the video item.

Parameters
ratingfloat - Rating number.
votesinteger - Number of votes.
typestring - Type of the rating.
isdefaultbool - Whether the rating is the default or not.

v20 Python API changes
New function added.

◆ setRatings()

void XBMCAddon::xbmc::InfoTagVideo::setRatings ( ...)

Function: setRatings(ratings, [defaultrating])


Set the ratings of the video item.

Parameters
ratingsdictionary - ‘{ 'type’: (rating, votes) }`.
defaultratingstring - Type / Label of the default rating.

v20 Python API changes
New function added.

◆ setResumePoint()

void XBMCAddon::xbmc::InfoTagVideo::setResumePoint ( ...)

Function: setResumePoint(time, [totaltime])


Set the resume point of the video item.

Parameters
timefloat - Resume point in seconds.
totaltimefloat - Total duration in seconds.

v20 Python API changes
New function added.

◆ setSeason()

void XBMCAddon::xbmc::InfoTagVideo::setSeason ( ...)

Function: setSeason(season)


Set the season number of the video item.

Parameters
seasoninteger - Season number.

v20 Python API changes
New function added.

◆ setSet()

void XBMCAddon::xbmc::InfoTagVideo::setSet ( ...)

Function: setSet(set)


Set the movie set (name) of the video item.

Parameters
setstring - Movie set (name).

v20 Python API changes
New function added.

◆ setSetId()

void XBMCAddon::xbmc::InfoTagVideo::setSetId ( ...)

Function: setSetId(setid)


Set the movie set identifier of the video item.

Parameters
setidinteger - Set identifier.

v20 Python API changes
New function added.

◆ setSetOverview()

void XBMCAddon::xbmc::InfoTagVideo::setSetOverview ( ...)

Function: setSetOverview(setoverview)


Set the movie set overview of the video item.

Parameters
setoverviewstring - Movie set overview.

v20 Python API changes
New function added.

◆ setShowLinks()

void XBMCAddon::xbmc::InfoTagVideo::setShowLinks ( ...)

Function: setShowLinks(showlinks)


Set the TV show links of the movie.

Parameters
showlinkslist - TV show links.

v20 Python API changes
New function added.

◆ setSortEpisode()

void XBMCAddon::xbmc::InfoTagVideo::setSortEpisode ( ...)

Function: setSortEpisode(sortepisode)


Set the episode sort number of the episode.

Parameters
sortepisodeinteger - Episode sort number.

v20 Python API changes
New function added.

◆ setSortSeason()

void XBMCAddon::xbmc::InfoTagVideo::setSortSeason ( ...)

Function: setSortSeason(sortseason)


Set the season sort number of the season.

Parameters
sortseasoninteger - Season sort number.

v20 Python API changes
New function added.

◆ setSortTitle()

void XBMCAddon::xbmc::InfoTagVideo::setSortTitle ( ...)

Function: setSortTitle(sorttitle)


Set the sort title of the video item.

Parameters
sorttitlestring - Sort title.

v20 Python API changes
New function added.

◆ setStudios()

void XBMCAddon::xbmc::InfoTagVideo::setStudios ( ...)

Function: setStudios(studios)


Set the studios of the video item.

Parameters
studioslist - Studios.

v20 Python API changes
New function added.

◆ setTagLine()

void XBMCAddon::xbmc::InfoTagVideo::setTagLine ( ...)

Function: setTagLine(tagline)


Set the tagline of the video item.

Parameters
taglinestring - Tagline.

v20 Python API changes
New function added.

◆ setTags()

void XBMCAddon::xbmc::InfoTagVideo::setTags ( ...)

Function: setTags(tags)


Set the tags of the video item.

Parameters
tagslist - Tags.

v20 Python API changes
New function added.

◆ setTitle()

void XBMCAddon::xbmc::InfoTagVideo::setTitle ( ...)

Function: setTitle(title)


Set the title of the video item.

Parameters
titlestring - Title.

v20 Python API changes
New function added.

◆ setTop250()

void XBMCAddon::xbmc::InfoTagVideo::setTop250 ( ...)

Function: setTop250(top250)


Set the top 250 number of the video item.

Parameters
top250integer - Top 250 number.

v20 Python API changes
New function added.

◆ setTrackNumber()

void XBMCAddon::xbmc::InfoTagVideo::setTrackNumber ( ...)

Function: setTrackNumber(tracknumber)


Set the track number of the music video item.

Parameters
tracknumberinteger - Track number.

v20 Python API changes
New function added.

◆ setTrailer()

void XBMCAddon::xbmc::InfoTagVideo::setTrailer ( ...)

Function: setTrailer(trailer)


Set the trailer of the video item.

Parameters
trailerstring - Trailer.

v20 Python API changes
New function added.

◆ setTvShowStatus()

void XBMCAddon::xbmc::InfoTagVideo::setTvShowStatus ( ...)

Function: setTvShowStatus(tvshowstatus)


Set the TV show status of the video item.

Parameters
statusstring - TV show status.

v20 Python API changes
New function added.

◆ setTvShowTitle()

void XBMCAddon::xbmc::InfoTagVideo::setTvShowTitle ( ...)

Function: setTvShowTitle(tvshowtitle)


Set the TV show title of the video item.

Parameters
tvshowtitlestring - TV show title.

v20 Python API changes
New function added.

◆ setUniqueID()

void XBMCAddon::xbmc::InfoTagVideo::setUniqueID ( ...)

Function: setUniqueID(uniqueid, [type], [isdefault])


Set the given unique ID. A unique ID is an identifier used by a (online) video database used to identify a video in its database.

Parameters
uniqueidstring - value of the unique ID.
type[opt] string - type / label of the unique ID.
isdefault[opt] bool - whether the given unique ID is the default unique ID.

v20 Python API changes
New function added.

◆ setUniqueIDs()

void XBMCAddon::xbmc::InfoTagVideo::setUniqueIDs ( ...)

Function: setUniqueIDs(values, defaultuniqueid)


Set the given unique IDs. A unique ID is an identifier used by a (online) video database used to identify a video in its database.

Parameters
valuesdictionary - pairs of ‘{ 'label’: 'value' }`.
defaultuniqueid[opt] string - the name of default uniqueID.
  • Some example values (any string possible):
    Label Type
    imdb string - uniqueid name
    tvdb string - uniqueid name
    tmdb string - uniqueid name
    anidb string - uniqueid name

v20 Python API changes
New function added.

◆ setUserRating()

void XBMCAddon::xbmc::InfoTagVideo::setUserRating ( ...)

Function: setUserRating(userrating)


Set the user rating of the video item.

Parameters
userratinginteger - User rating.

v20 Python API changes
New function added.

◆ setVideoAssetTitle()

void XBMCAddon::xbmc::InfoTagVideo::setVideoAssetTitle ( ...)

Function: setVideoAssetTitle(videoAssetTitle)


Set the video asset title of the item.

Parameters
videoAssetTitlestring - Video asset title.

v21 Python API changes
New function added.

◆ setVotes()

void XBMCAddon::xbmc::InfoTagVideo::setVotes ( ...)

Function: setVotes(votes)


Set the number of votes of the video item.

Parameters
votesinteger - Number of votes.

v20 Python API changes
New function added.

◆ setWriters()

void XBMCAddon::xbmc::InfoTagVideo::setWriters ( ...)

Function: setWriters(writers)


Set the writers of the video item.

Parameters
writerslist - Writers.

v20 Python API changes
New function added.

◆ setYear()

void XBMCAddon::xbmc::InfoTagVideo::setYear ( ...)

Function: setYear(year)


Set the year of the video item.

Parameters
yearinteger - Year.

v20 Python API changes
New function added.

◆ ToActorInfo()

SActorInfo XBMCAddon::xbmc::Actor::ToActorInfo ( ) const

◆ ToStreamDetailAudio()

CStreamDetailAudio * XBMCAddon::xbmc::AudioStreamDetail::ToStreamDetailAudio ( ) const

◆ ToStreamDetailSubtitle()

CStreamDetailSubtitle * XBMCAddon::xbmc::SubtitleStreamDetail::ToStreamDetailSubtitle ( ) const

◆ ToStreamDetailVideo()

CStreamDetailVideo * XBMCAddon::xbmc::VideoStreamDetail::ToStreamDetailVideo ( ) const

◆ ~InfoTagVideo()

XBMCAddon::xbmc::InfoTagVideo::~InfoTagVideo ( )
override