Skip to content
This repository

Skin Designers Guide 

damienhaynes edited this page · 30 revisions
Clone this wiki locally

The purpose of this document is to help you understand how Trakt interacts with the MediaPortal's skin engine. In this document you're going to find a general overview of how the plug-in is structured, the components that you, as a skinner should be interested in, and a list of available properties that you can use.

It's recommended that you use the DefaultWide (16:9) or Default (4:3) skin as a base which is installed with the release. It is written by the same people that write the plug-in, so if you are having trouble getting something to work right, refer to this skin.

If you want to see whats NEW in a particular version, search for the version throughout this page e.g. To see what has changed in v1.0.5, perform a search on term '1.0.5'.

Translations

You can make use any of the plugins string translations to create button menus, headings, labels etc. Syntax for translations are just simple skin properties in the form #Trakt.Translation.$(string).Label e.g.

Property English
#Trakt.Translation.Friends.Label Friends
#Trakt.Translation.Recommendations.Label Recommendations
#Trakt.Translation.Trending.Label Trending
#Trakt.Translation.Settings.Label Settings

There is a wide selection of translated strings to choose from, here is a complete list. Use the Field value in the skin property to get the translation you require.

Fanart

Fading Fanart support has been added to the Trakt plugin, it is similar to how it works for TVSeries and MovingPictures plugins ie. two image controls using fanart properties. The plugin handles visibility of these controls and skinner should not manually add visible properties. The following tables describe how to use it for each window:

Control ID Control Type Description
60 Image Fanart Background #1
61 Image Fanart Background #2

You can use animation properties to control the fading on visible and hidden conditions.

Each window uses different skin properties in the texture properties of the image controls:

Calendar

Property Description
#Trakt.Calendar.Fanart.1 Fanart Background #1
#Trakt.Calendar.Fanart.2 Fanart Background #2

Friends

Property Description
#Trakt.Friends.Fanart.1 Fanart Background #1
#Trakt.Friends.Fanart.2 Fanart Background #2

Movie Recommendations

Property Description
#Trakt.RecommendedMovies.Fanart.1 Fanart Background #1
#Trakt.RecommendedMovies.Fanart.2 Fanart Background #2

Show Recommendations

Property Description
#Trakt.RecommendedShows.Fanart.1 Fanart Background #1
#Trakt.RecommendedShows.Fanart.2 Fanart Background #2

Movies Trending

Property Description
#Trakt.TrendingMovies.Fanart.1 Fanart Background #1
#Trakt.TrendingMovies.Fanart.2 Fanart Background #2

Shows Trending

Property Description
#Trakt.TrendingShows.Fanart.1 Fanart Background #1
#Trakt.TrendingShows.Fanart.2 Fanart Background #2

Movie Watch List

Property Description
#Trakt.WatchListMovies.Fanart.1 Fanart Background #1
#Trakt.WatchListMovies.Fanart.2 Fanart Background #2

Show Watch List

Property Description
#Trakt.WatchListShows.Fanart.1 Fanart Background #1
#Trakt.WatchListShows.Fanart.2 Fanart Background #2

Episode Watch List

Property Description
#Trakt.WatchListEpisodes.Fanart.1 Fanart Background #1
#Trakt.WatchListEpisodes.Fanart.2 Fanart Background #2

List Items (v1.2.0)

Property Description
#Trakt.List.Fanart.1 Fanart Background #1
#Trakt.List.Fanart.2 Fanart Background #2

Here is an example of Fanart support for Trending Movies:

<control>
  <description>Fanart Background #1</description>
  <type>image</type>
  <id>60</id>
  <posX>0</posX>
  <posY>0</posY>
  <width>1280</width>
  <height>720</height>
  <texture>#Trakt.TrendingMovies.Fanart.1</texture>
  <animation effect="fade" time="300">visible</animation>
  <animation effect="fade" time="300" delay="300">hidden</animation>
</control>
<control>
  <description>Fanart Background #2</description>
  <type>image</type>
  <id>61</id>
  <posX>0</posX>
  <posY>0</posY>
  <width>1280</width>
  <height>720</height>
  <texture>#Trakt.TrendingMovies.Fanart.2</texture>
  <animation effect="fade" time="300">visible</animation>
  <animation effect="fade" time="300" delay="300">hidden</animation>
</control>

Note: Trakt Shouts only supports a single fanart so Fading Fanart is not necessary.

Common Properties

The following skin properties can be used throughout the trakt plugin windows:

Property Description
#itemcount Raw value representing number of number of items in facade object
#selecteditem Label of currently selected list item in facade
#selectedthumb Texture of currently selected list item in facade
#Trakt.Items This is an extension to the standard #itemcount property and is context sensitive based on what window is active e.g. 1 Episode, 2 Movies, 20 Friends etc
#Trakt.CurrentView This is only available in Friends and Calendar, and represents the current view level e.g. Trakt Calendar - My Shows

Artwork

This section describes the different media that the plugin will load in each trakt window.

Default Facade Icons

Filename Description
defaultTraktUser.png Default user image loaded in friends window
defaultTraktUserBig.png Default user image loaded in friends window
defaultTraktEpisode.png Default episode image loaded in various windows
defaultTraktEpisodeBig.png Default episode image loaded in various windows
defaultTraktCalendar.png Default day header image in tv show calendar window
defaultTraktCalendarBig.png Default day header image in tv show calendar window
defaultVideo.png Default video image loaded for movie windows
defaultVideoBig.png Default video image loaded for movie windows

Hover Image

The following is used as the home screen hover image:

Filename Description
hover_trakt.png Main plugin hover image

Notification Logo

The following image is used for all notification dialogs:

Filename Description
Logos\trakt.png Image used in notification dialogs

Library Icons

Some of the trakt windows such as trending shows/movies can display an icon on the poster indicating if the movie or show is in the users collection, whether it has been watched or if its in their watch list. It can also show if its in more than one state e.g. Watched and in collection. These images should exist in the skins Media folder, below is a list of library icons supported:

Filename Description
traktLibrary.png Is added to poster if its in users collection
traktSeenIt.png Is added to poster if user has watched item
traktWatchList.png Is added to poster if item is in users watch list
traktSeenItLibrary.png Is added to poster if item is watched and in users colletion
traktWatchListLibrary.png Is added to poster if item is in users watch list and is in users collection

Note: All images above should be the same size.

Rating Icons

The plugin can also add rating icons to posters which indicates if the user loved or hated a movie. The table below describes what icons can be added to posters:

Filename Description
traktLove.png Love icon is added to poster if user rated movie as 'love'
traktHate.png Hate icon is added to poster if user rated movie as 'hate'

Note: All images above should be the same size.

Library and Rating icon positions are controlled by their corresponding Skin Settings. Skinners should take into consideration the size of the icon and the poster which is 300px wide when deciding on x,y co-ordinates. A position of (0,0) indicates the top left and position of (0,-300) indicates top right. It should be noted that poster heights can vary.

Skin Settings

Skin Settings is a special skin xml used by skinners to customize certain settings controlled by plugin e.g. adding icons on posters.

Poster and Episode Icons

Poster/Episode Icon positions are controlled by the following xml, for more information see Artwork section:

<mainoverlayicons>
  <posters>
    <posx>178</posx>
    <posy>0</posy>
  </posters>
  <episodethumbs>
    <posx>278</posx>
    <posy>0</posy>
  </episodethumbs>
</mainoverlayicons>

In example above we display 122px wide icon in the top right hand corner of poster ie (Poster: 300px - 122px) = 178px origin and (Episode Thumb: 400px - 122px) = 278px origin.

<ratingoverlayicons>
  <posters>
    <posx>178</posx>
    <posy>0</posy>
   </posters>
   <episodethumbs>
     <posx>278</posx>
     <posy>0</posy>
   </episodethumbs>
</ratingoverlayicons>

GUI Windows

The Trakt plugin is made up of several GUI windows, one for each area of interest e.g. TV Calendar, Recommended Movies, Trending TV Shows etc. Here is a break down of the windows available:

Name Window ID Skin File Description
Main 87258 Trakt.xml Used as a launch pad to other trakt windows
Calendar 87259 Trakt.Calendar.xml Displays users TV Show Calendar (Premieres & My Shows)
Friends 87260 Trakt.Friends.xml Displays users Friends List and their TV Show\Movie Watch History
Recommendations 87261 Trakt.Recommendations.xml Used as a launch pad to movie and tvshow recommendation windows
Show Recommendations 87262 Trakt.Recommendations.Shows.xml Displays users TV Show Recommendations
Movie Recommendations 87263 Trakt.Recommendations.Movies.xml Displays users Movie Recommendations
Trending 87264 Trakt.Trending.xml Used as a launch pad to movie and tvshow trending windows
Shows Trending 87265 Trakt.Trending.Shows.xml Displays TV Shows currently Trending
Movies Trending 87266 Trakt.Trending.Movies.xml Displays Movies currently Trending
Watch List 87267 Trakt.WatchList.xml Used as a launch pad to movie, tvshow and episode Watch List windows
Show Watch List 87268 Trakt.WatchList.Shows.xml Displays users TV Shows in Watch List
Episode Watch List 87269 Trakt.WatchList.Episodes.xml Displays users Episodes in Watch List
Movie Watch List 87270 Trakt.WatchList.Movies.xml Displays users Movies in Watch List
Lists 87275 Trakt.Lists.xml Displays users custom lists (v1.2.0)
List Items 87276 Trakt.List.Items.xml Displays the contents of a users custom list (v1.2.0)
Settings 87271 Trakt.Settings.xml Used as a launch pad to Setting windows
Account Settings 87272 Trakt.Settings.Account.xml Configuration of Account e.g. Signup/Login
Plugin Settings 87273 Trakt.Settings.Plugins.xml Configure plugins to enable on Sync/Scrobble
General Settings 87274 Trakt.Settings.General.xml Configure general plugin settings
Shouts 87280 Trakt.Shouts.xml Displays Movie, Show and Episode shouts for a selected item (v1.0.4)

Main

The main window Trakt.xml should be used by skinners to create a menu structure (typically buttons) that allow users to get to each area of the plugin. There is no mandatory controls for this window. Each Button should use the MediaPortal button property hyperlink to launch each window. Plugin translations can be used for button labels.

Calendar

The Calendar window allows you to Page through week-by-week (currently only forward in time) your personal tvshow calendar or display the upcoming premieres ie new shows about to air or returning series.

Calendar Properties

Property Example Description
#Trakt.Calendar.Selected.Date Sunday, 12 June 2011 The Long AirDate of the selected episode on calendar (v1.1.1)
#selecteditem 2 The selected episode index in calendar, overrides the default MediaPortal skin property. This can be used together with #itemcount e.g. (#selectedindex / #itemcount) (v1.1.1)
Property Example Description
#Trakt.Show.Imdb tt0944947 IMDb id of show
#Trakt.Show.Tvdb 121361 TVDb id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.InWatchList true Indicates if show is in your watch list (v1.0.4)
#Trakt.Show.Rating love User rating of the show, love or hate (v1.0.4)
#Trakt.Show.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating (v1.0.4)
#Trakt.Show.Ratings.HatedCount 50 Number of people whom rated as hate (v1.0.4)
#Trakt.Show.Ratings.LovedCount 500 Number of people whom rated as love (v1.0.4)
#Trakt.Show.Ratings.Percentage 78 Percentage of people whom loved show (v1.0.4)
#Trakt.Show.Ratings.Votes 545 Number of people whom have voted (v1.0.4)
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Episode.Number 1 Episode Index
#Trakt.Episode.Season 1 Season Index
#Trakt.Episode.FirstAired 2011-04-17 Air date of episode
#Trakt.Episode.Title Winter Is Coming Title of episode
#Trakt.Episode.Url http://trakt.tv/show/game-of-thrones/season/1/episode/1 Url of episode on trakt.tv
#Trakt.Episode.Overview A Night’s Watch deserter is tracked down outside of Winterfell... Overview of episode
#Trakt.Episode.Runtime 60mins Runtime of episode
#Trakt.Episode.InWatchList true Indicates if episode is in your watch list (v1.0.4)
#Trakt.Episode.InCollection true Indicates if episode is in your collection (v1.0.4)
#Trakt.Episode.Plays 2 Number of times the episode has been played/scrobbled (v1.0.4)
#Trakt.Episode.Watched true Indicates if the user has watched episode (v1.0.4)
#Trakt.Episode.Rating love User rating of the episode, love or hate (v1.0.4)
#Trakt.Episode.Ratings.Icon love Site rating of the episode, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating (v1.0.4)
#Trakt.Episode.Ratings.HatedCount 50 Number of people whom rated as hate (v1.0.4)
#Trakt.Episode.Ratings.LovedCount 500 Number of people whom rated as love (v1.0.4)
#Trakt.Episode.Ratings.Percentage 78 Percentage of people whom loved episode (v1.0.4)
#Trakt.Episode.Ratings.Votes 545 Number of people whom have voted (v1.0.4)
#Trakt.Episode.EpisodeImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Episodes\1395-940.jpg Filename to local episode image

Skin Controls

The following skin controls are available for the Calendar window:

Control Type Control ID Description
Button 2 View button, controls user switching between My Shows, Premieres and All Shows
Button 3 Start Date button, allows you to set a different anchor date for the calendar (v1.0.2)
Facade 50 Displays contents of calendar entries

Note: Label3 of facade is used to add Day Headers so you can distinguish between episodes and start of day. You may choose a different colour or make the font bold.

Friends

The Friends window allows users to browse their list of friends in a facade list control, when they select a friend they can drill down to see the users last 100 Watched Movies / Episodes or friends Personal Watch List.

There are 3 different view levels in the Friends window, you can use the following skin properties to control the visibility of controls:

Property Possible Values Description
#Trakt.View.Level Friends, WatchedTypes or WatchedHistory Indicates one of three levels the user is currently navigating
#Trakt.Selected.Type Episodes or Movies Indicates if user is in Movies or Episode Watched History, used in conjuction with #Trakt.View.Level property

See this example which demonstrates showing the Selected Episode Thumbnail when in Episode Watched History:

<control>
  <type>image</type>
  <id>1</id>
  <posX>28</posX>
  <posY>254</posY>
  <height>200</height>
  <width>354</width>
  <keepaspectratio>yes</keepaspectratio>
  <zoom>yes</zoom>
  <texture flipY="true" diffuse="diffusemirrorwide.png">#selectedthumb</texture>
  <animation effect="fade" time="250" delay="0">WindowClose</animation>
  <animation effect="fade" time="250" delay="0">WindowOpen</animation>
  <visible>string.equals(#Trakt.View.Level,WatchedHistory)+string.equals(#Trakt.Selected.Type,episode)</visible>
</control>

Friend Properties

Property Example Description
#Trakt.User.About I love watching TV! Description about yourself entered in trakt.tv user control panel
#Trakt.User.Age 21 Age of user
#Trakt.User.Avatar http://vicmackey.trakt.tv/images/avatars/837.jpg Url of users avatar
#Trakt.User.AvatarFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Avatars\ltfearme.jpg Local filename of stored avatar
#Trakt.User.Username ltfearme Username of user
#Trakt.User.FullName Damien Haynes Full name of user if entered online
#Trakt.User.Gender Male Gender of user
#Trakt.User.JoinDate May 21st, 2011 Date signed up to trakt.tv
#Trakt.User.ApprovedDate June 13th, 2011 Date friend was approved (v1.0.2)
#Trakt.User.Location Sydney Geographical Location of user
#Trakt.User.Protected False Indicates if the user is marked as private
#Trakt.User.Url http://trakt.tv/user/ltfearme Url to users page on trakt.tv

Episode Watched History Properties

Property Example Description
#Trakt.Show.Imdb tt0944947 IMDB id of show
#Trakt.Show.Tvdb 121361 TVDB id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Episode.Number 1 Episode Index
#Trakt.Episode.Season 1 Season Index
#Trakt.Episode.FirstAired 2011-04-17 Air date of episode
#Trakt.Episode.Title Winter Is Coming Title of episode
#Trakt.Episode.Url http://trakt.tv/show/game-of-thrones/season/1/episode/1 Url of episode on trakt.tv
#Trakt.Episode.Overview A Night’s Watch deserter is tracked down outside of Winterfell... Overview of episode
#Trakt.Episode.Runtime 60mins Runtime of episode
#Trakt.Episode.EpisodeImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Episodes\1395-940.jpg Filename to local episode image

Movies Watched History Properties

Property Example Description
#Trakt.Movie.Imdb tt0499549 IMDB id of movie
#Trakt.Movie.Certification PG-13 MPAA certification of movie
#Trakt.Movie.Overview A paraplegic marine dispatched to the moon Pandora on a unique mission becomes torn between following his orders and protecting the world he feels is his home. Overview of movie
#Trakt.Movie.Released December 18, 2009 Release date of movie
#Trakt.Movie.Runtime 162mins Runtime of movie
#Trakt.Movie.Tagline Return to Pandora Tagline of movie
#Trakt.Movie.Title Avatar Title of movie
#Trakt.Movie.Tmdb 19995 TMDb id of movie
#Trakt.Movie.Trailer http://www.youtube.com/watch?v=cRdxXPV9GNQ Url to movie trailer
#Trakt.Movie.Year 2009 Year movie was released
#Trakt.Movie.PosterImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Posters\1-300.jpg Filename of local movie poster
#Trakt.Movie.FanartImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Fanart\1.jpg Filename of local movie fanart

Skin Controls

The following skin controls are available for the Friends window:

Control Type Control ID Description
Facade 50 Displays contents of friends, movie and episode watched history

Recommendations

The Recommendations window is used as a launching pad to Movie and TV Show recommendations. Skins should host button controls making use of hyperlink properties to launch each window. Plugin translations can be used for button labels.

Skinners could also integrate these into other plugin skins e.g. MovingPictures, TVSeries, My Films, My Videos Hidden Menu.

Movie Recommendations

The movie recommendations window displays personal movie recommendations for the user.

Skin Properties

Property Example Description
#Trakt.Movie.Imdb tt0499549 IMDB id of movie
#Trakt.Movie.Certification PG-13 MPAA certification of movie
#Trakt.Movie.Overview A paraplegic marine dispatched to the moon Pandora on a unique mission becomes torn between following his orders and protecting the world he feels is his home. Overview of movie
#Trakt.Movie.Released December 18, 2009 Release date of movie
#Trakt.Movie.Runtime 162mins Runtime of movie
#Trakt.Movie.Tagline Return to Pandora Tagline of movie
#Trakt.Movie.Title Avatar Title of movie
#Trakt.Movie.Tmdb 19995 TMDb id of movie
#Trakt.Movie.Trailer http://www.youtube.com/watch?v=cRdxXPV9GNQ Url to movie trailer
#Trakt.Movie.Year 2009 Year movie was released
#Trakt.Movie.PosterImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Posters\1-300.jpg Filename of local movie poster
#Trakt.Movie.FanartImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Fanart\1.jpg Filename of local movie fanart
#Trakt.Movie.InCollection true Indicates if the user has this movie in his/her collection
#Trakt.Movie.InWatchList true Indicates if the movie is in the users Watch List
#Trakt.Movie.Rating love User rating of the movie, love or hate
#Trakt.Movie.Ratings.Icon love Site rating of the movie, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Movie.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Movie.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Movie.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Movie.Ratings.Votes 545 Number of people whom have voted

Skin Controls

The following skin controls are available for the Movie Recommendations window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of movie recommendations

Show Recommendations

The show recommendations window displays personal tv show recommendations for the user.

Skin Properties

Property Example Description
#Trakt.Show.Imdb tt0944947 IMDB id of show
#Trakt.Show.Tvdb 121361 TVDB id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Show.InWatchList true Indicates if the show is in the users Watch List
#Trakt.Show.Rating love User rating of the movie, love or hate
#Trakt.Show.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Show.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Show.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Show.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Show.Ratings.Votes 545 Number of people whom have voted

Skin Controls

The following skin controls are available for the Show Recommendations window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of show recommendations

Trending

The Trending window is used as a launching pad to Movie and TV Shows currently Trending on trakt.tv. Skins should host button controls making use of hyperlink properties to launch each window. Plugin translations can be used for button labels.

Common Skin Properties

Property Example Description
#Trakt.Trending.PeopleCount 107 Number of Total People watching tvshows/movies
#Trakt.Trending.Description 107 people watching 80 tv shows right now! or 107 people watching 80 movies right now! Formatted message for Total People/Item count

Movies Trending

The trending movies window displays movies actively been watched by trakt users now.

Skin Properties

Property Example Description
#Trakt.Movie.Imdb tt0499549 IMDB id of movie
#Trakt.Movie.Certification PG-13 MPAA certification of movie
#Trakt.Movie.Overview A paraplegic marine dispatched to the moon Pandora on a unique mission becomes torn between following his orders and protecting the world he feels is his home. Overview of movie
#Trakt.Movie.Released December 18, 2009 Release date of movie
#Trakt.Movie.Runtime 162mins Runtime of movie
#Trakt.Movie.Tagline Return to Pandora Tagline of movie
#Trakt.Movie.Title Avatar Title of movie
#Trakt.Movie.Tmdb 19995 TMDb id of movie
#Trakt.Movie.Trailer http://www.youtube.com/watch?v=cRdxXPV9GNQ Url to movie trailer
#Trakt.Movie.Year 2009 Year movie was released
#Trakt.Movie.PosterImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Posters\1-300.jpg Filename of local movie poster
#Trakt.Movie.FanartImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Fanart\1.jpg Filename of local movie fanart
#Trakt.Movie.InCollection true Indicates if the user has this movie in his/her collection
#Trakt.Movie.InWatchList true Indicates if the movie is in the users Watch List
#Trakt.Movie.Plays 3 Number of times you have watched the movie
#Trakt.Movie.Watchers 6 Number of users currently watching movie
#Trakt.Movie.Watchers.Extra 6 People A formatted number of users currently watching movie
#Trakt.Movie.Watched True True or False indicating if user has watched movie, ie Plays > 0
#Trakt.Movie.Rating love User rating of the movie, love or hate
#Trakt.Movie.Ratings.Icon love Site rating of the movie, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Movie.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Movie.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Movie.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Movie.Ratings.Votes 545 Number of people whom have voted

Skin Controls

The following skin controls are available for the Trending Movies window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of trending movies

Shows Trending

The trending shows window displays the shows currently watched by trakt users.

Skin Properties

Property Example Description
#Trakt.Show.Imdb tt0944947 IMDB id of show
#Trakt.Show.Tvdb 121361 TVDB id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Show.InWatchList true Indicates if the show is in the users Watch List
#Trakt.Show.Watchers 6 Number of users currently watching show
#Trakt.Show.Watchers.Extra 6 People A formatted number of users currently watching show
#Trakt.Show.Rating love User rating of the movie, love or hate
#Trakt.Show.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Show.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Show.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Show.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Show.Ratings.Votes 545 Number of people whom have voted

Skin Controls

The following skin controls are available for the Trending Shows window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of trending shows

Watch List

The Watch List window is used as a launching pad to the users Movie, TV Show and Episode Watch Lists. Skins should host button controls making use of hyperlink properties to launch each window. Plugin translations can be used for button labels.

Skinners could also integrate these into other plugin skins e.g. MovingPictures, TVSeries, My Films, My Videos Hidden Menu.

The Watch List windows share a common property to indicate the current user:

Property Example Description
#Trakt.WatchList.CurrentUser Damien The Current User of the loaded Watch List e.g. you maybe viewing a friends watch list (v1.0.3)

Movie Watch List

The movie watch list window displays movies in the users watch list.

Skin Properties

Property Example Description
#Trakt.Movie.Imdb tt0499549 IMDB id of movie
#Trakt.Movie.Certification PG-13 MPAA certification of movie
#Trakt.Movie.Overview A paraplegic marine dispatched to the moon Pandora on a unique mission becomes torn between following his orders and protecting the world he feels is his home. Overview of movie
#Trakt.Movie.Released December 18, 2009 Release date of movie
#Trakt.Movie.Runtime 162mins Runtime of movie
#Trakt.Movie.Tagline Return to Pandora Tagline of movie
#Trakt.Movie.Title Avatar Title of movie
#Trakt.Movie.Tmdb 19995 TMDb id of movie
#Trakt.Movie.Trailer http://www.youtube.com/watch?v=cRdxXPV9GNQ Url to movie trailer
#Trakt.Movie.Year 2009 Year movie was released
#Trakt.Movie.PosterImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Posters\1-300.jpg Filename of local movie poster
#Trakt.Movie.FanartImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Fanart\1.jpg Filename of local movie fanart
#Trakt.Movie.InWatchList true Indicates if movie is in your watch list, typically this is always true unless viewing a friends watch list (v1.0.3)
#Trakt.Movie.WatchList.Inserted December 10, 2009 Date user added movie to watch list
#Trakt.Movie.InCollection true Indicates if the user has this movie in his/her collection
#Trakt.Movie.Plays 0 Indicates the number of times the movie has been watched, typically this is Zero unless viewing friends watch list (v1.0.3)
#Trakt.Movie.Watched false Indicates if you have already seen this movie (v1.0.3)
#Trakt.Movie.Rating love User rating of the movie, love, hate or false
#Trakt.Movie.Ratings.Icon love Site rating of the movie, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Movie.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Movie.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Movie.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Movie.Ratings.Votes 545 Number of people whom have voted

Skin Controls

The following skin controls are available for the Movie Watch List window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of movies in users watch list

Show Watch List

The show watch list window displays shows in the users Watch List.

Skin Properties

Property Example Description
#Trakt.Show.Imdb tt0944947 IMDB id of show
#Trakt.Show.Tvdb 121361 TVDB id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Show.InWatchList true Indicates if show is in your watch list, typically this is always true unless viewing a friends watch list (v1.0.3)
#Trakt.Show.WatchList.Inserted December 10, 2009 Date user added show to watch list
#Trakt.Show.Rating love User rating of the movie, love or hate
#Trakt.Show.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Show.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Show.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Show.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Show.Ratings.Votes 545 Number of people whom have voted

Skin Controls

The following skin controls are available for the Show Watch List window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of shows in users watch list

Episode Watch List

The episode watch list window displays episodes in the users Watch List.

Skin Properties

Property Example Description
#Trakt.Show.Imdb tt0944947 IMDB id of show
#Trakt.Show.Tvdb 121361 TVDB id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Show.Rating love User rating of the movie, love or hate
#Trakt.Show.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Show.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Show.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Show.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Show.Ratings.Votes 545 Number of people whom have voted
#Trakt.Episode.Number 1 Episode Index
#Trakt.Episode.Season 1 Season Index
#Trakt.Episode.FirstAired 2011-04-17 Air date of episode
#Trakt.Episode.Title Winter Is Coming Title of episode
#Trakt.Episode.Url http://trakt.tv/show/game-of-thrones/season/1/episode/1 Url of episode on trakt.tv
#Trakt.Episode.Overview A Night’s Watch deserter is tracked down outside of Winterfell... Overview of episode
#Trakt.Episode.Runtime 60mins Runtime of episode
#Trakt.Episode.EpisodeImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Episodes\1395-940.jpg Filename to local episode image
#Trakt.Episode.WatchList.Inserted January 10, 2011 Date user added episode to watch list

Skin Controls

The following skin controls are available for the Episode Watch List window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the list of episodes in users watch list

Lists (v1.2.0)

The Lists window is used as a launching pad to a users Custom Lists collection. The plugin will populate a list facade with each item representing a users list. Skins can even use the unique id (slug property) to display a picture by allowing their users to drop an image in a specific folder (similar to movingpictures categories).

Skinners could also integrate this into other plugin skins e.g. MovingPictures, TVSeries, My Films, My Videos Hidden Menu.

Skin Properties

Property Example Description
#Trakt.Lists.CurrentUser ltfearme Username of whom the lists belong to.
#Trakt.List.Name Top 10 Name of the selected list
#Trakt.List.Description My Top 10 movies of all time. Description of the selected list.
#Trakt.List.Privacy friends Privacy level of the selected list, e.g. friends, private, public
#Trakt.List.Slug top-10 A unique id for the selected list
#Trakt.List.Url http://trakt.tv/user/ltfearme/lists/top-10 trakt.tv url of selected list contents.

Skin Controls

The following skin controls are available for the Lists window:

Control Type Control ID Description
Facade 50 Displays the custom lists in a users collection of lists.

List Items (v1.2.0)

The List Items window is used to display the contents of a selected list. A custom list can contain movies, shows, seasons and episodes. Skinners can react to the type property to display relevant information. The artwork loaded in the facade is only of type 'Poster', meaning episodes will be using series posters, seasons will use season poster if it exists and will fallback to series poster if not.

Standard Properties

Property Example Description
#Trakt.Lists.CurrentUser ltfearme Username of whom the lists belong to.
#Trakt.List.Name Top 10 Name of the selected list
#Trakt.List.Description My Top 10 movies of all time. Description of the selected list.
#Trakt.List.Privacy friends Privacy level of the selected list, e.g. friends, private, public
#Trakt.List.Slug top-10 A unique id for the selected list
#Trakt.List.ItemType movie Indicates if a movie, show, season or episode item is selected, skinners can use this property to display the relevant information on skin.

Movie Properties

Property Example Description
#Trakt.Movie.Imdb tt0499549 IMDB id of movie
#Trakt.Movie.Certification PG-13 MPAA certification of movie
#Trakt.Movie.Overview A paraplegic marine dispatched to the moon Pandora on a unique mission becomes torn between following his orders and protecting the world he feels is his home. Overview of movie
#Trakt.Movie.Released December 18, 2009 Release date of movie
#Trakt.Movie.Runtime 162mins Runtime of movie
#Trakt.Movie.Tagline Return to Pandora Tagline of movie
#Trakt.Movie.Title Avatar Title of movie
#Trakt.Movie.Tmdb 19995 TMDb id of movie
#Trakt.Movie.Trailer http://www.youtube.com/watch?v=cRdxXPV9GNQ Url to movie trailer
#Trakt.Movie.Year 2009 Year movie was released
#Trakt.Movie.PosterImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Posters\1-300.jpg Filename of local movie poster
#Trakt.Movie.FanartImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Movies\Fanart\1.jpg Filename of local movie fanart
#Trakt.Movie.InWatchList true Indicates if movie is in your watch list, typically this is always true unless viewing a friends watch list
#Trakt.Movie.WatchList.Inserted December 10, 2009 Date user added movie to watch list
#Trakt.Movie.InCollection true Indicates if the user has this movie in his/her collection
#Trakt.Movie.Plays 0 Indicates the number of times the movie has been watched, typically this is Zero unless viewing friends watch list
#Trakt.Movie.Watched false Indicates if you have already seen this movie
#Trakt.Movie.Rating love User rating of the movie, love, hate or false
#Trakt.Movie.Ratings.Icon love Site rating of the movie, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Movie.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Movie.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Movie.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Movie.Ratings.Votes 545 Number of people whom have voted

Show Properties

Property Example Description
#Trakt.Show.Imdb tt0944947 IMDB id of show
#Trakt.Show.Tvdb 121361 TVDB id of show
#Trakt.Show.TvRage 77121 TVRage id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Url http://trakt.tv/show/game-of-thrones Url to show on trakt.tv
#Trakt.Show.AirDay Sunday Day show airs on live tv
#Trakt.Show.AirTime 9:00PM Time show airs on live tv
#Trakt.Show.Certification TV-MA MPAA Certification of show
#Trakt.Show.Country USA Country of Shows Network
#Trakt.Show.FirstAired 2011-04-17 Date the first episode of show aired on tv
#Trakt.Show.Network HBO Shows Broadcast Network
#Trakt.Show.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of show
#Trakt.Show.Runtime 60mins Runtime of show on live tv
#Trakt.Show.Year 2011 Year that the first episode aired on tv
#Trakt.Show.FanartFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Shows\Fanart\1395.jpg Local Fanart Filename
#Trakt.Show.InWatchList true Indicates if the show is in the users Watch List
#Trakt.Show.Rating love User rating of the show, love or hate
#Trakt.Show.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Show.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Show.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Show.Ratings.Percentage 78 Percentage of people whom loved movie
#Trakt.Show.Ratings.Votes 545 Number of people whom have voted

Season Properties

Property Example Description
#Trakt.Season.Number 1 Season number of season

Episode Properties

Property Example Description
#Trakt.Episode.Number 1 Episode Index
#Trakt.Episode.Season 1 Season Index
#Trakt.Episode.FirstAired 2011-04-17 Air date of episode
#Trakt.Episode.Title Winter Is Coming Title of episode
#Trakt.Episode.Url http://trakt.tv/show/game-of-thrones/season/1/episode/1 Url of episode on trakt.tv
#Trakt.Episode.Overview A Night’s Watch deserter is tracked down outside of Winterfell... Overview of episode
#Trakt.Episode.Runtime 60mins Runtime of episode
#Trakt.Episode.Watched true Indicates if the episode is watched
#Trakt.Episode.Plays true Indicates show many times the episode has been watched
#Trakt.Episode.InWatchList true Indicates if the episode is in the users Watch List
#Trakt.Episode.InCollection true Indicates if the episode is in the users Collection
#Trakt.Episode.Rating love User rating of the episode, love or hate
#Trakt.Episode.Ratings.Icon love Site rating of the show, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Episode.Ratings.HatedCount 50 Number of people whom rated as hate
#Trakt.Episode.Ratings.LovedCount 500 Number of people whom rated as love
#Trakt.Episode.Ratings.Percentage 78 Percentage of people whom loved episode
#Trakt.Episode.Ratings.Votes 545 Number of people whom have voted

Note: You can also use Show properties for season items and Show/Season properties for episode items.

Skin Controls

The following skin controls are available for the List Items window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Displays the items in a users list.

Settings

The Settings window is used as a launching pad to the Account, Plugin and General settings windows. Skins should host button controls making use of hyperlink properties to launch each window. Plugin translations can be used for button labels.

Account Settings

Account settings allows the user to Create a new account, login to an existing account or disconnect (Sign-out) from the current one.

Skin Controls

The following skin controls are available for the Account Settings window:

Control Type Control ID Description
Button 2 Create button used to create an account
Button 3 Login button used to login to an existing account
Button 4 Disconnect button to log-out of current account

When the user clicks on Create or Login buttons the plugin will set the following properties:

Property Values Description
#Trakt.Settings.Account.Dialog.Visible true or false Allows users to show or hide account create and login controls
#Trakt.Settings.Account.Dialog.NewUser true or false Used with dialog property to determine if email field should be hidden or shown

Conditional Account Controls

Control Type Control ID Description
Label 10 Title label to indicate if user clicked on create or login button
Button 11 Button to invoke the username Virtual Keyboard and display current username
Button 12 Button to invoke the password Virtual Keyboard and display current password
Button 13 Button to invoke the email Virtual Keyboard and display current email address, only should be visible for new accounts
Button 15 OK button indicate that user has finished entering in account details
Button 16 Cancel button to indicate that user has cancelled account signup or login
Label 17 Label which gets displayed to user when clicking OK and data is being sent to trakt

Plugin Settings

Plugin settings allows the user to enable or disable different plugins with-in MediaPortal that support Sync and Scrobble to and from trakt.tv.

Control Type Control ID Description
ToggleButton 2 TVSeries toggle button
ToggleButton 3 Moving Pictures toggle button
ToggleButton 4 My Videos toggle button
ToggleButton 5 My Films toggle button
ToggleButton 6 OnlineVideos toggle button (v1.1.0)
ToggleButton 7 My Anime toggle button (v1.1.0)

General Settings

General settings allows user to control general operating functions with-in trakt plugin. The following is a list of settings currently available to be set from GUI.

Control Type Control ID Description
ToggleButton 2 Download Fanart toggle button, will disable downloading and displaying of fanart if not selected
ToggleButton 3 Download Full Size Fanart toggle button, will download original sized fanart when selected. When not selected fanart will be downloaded at 940px wide
ToggleButton 4 Get Friend Requests on Startup toggle button, will fetch a list of friend requests on startup and notify user (v1.0.2)
ToggleButton 5 MovingPictures Categories toggle button, enable to create Recommendations/Watch List categories (v1.0.5)
ToggleButton 6 MovingPictures Filters toggle button, enable to create Recommendations/Watch List filter menu items (v1.0.5)

Shouts

The Shouts window allows users to view shouts for selected movies, shows or episodes.

User Properties

Property Example Description
#Trakt.User.About I love watching TV! Description about yourself entered in trakt.tv user control panel
#Trakt.User.Age 21 Age of user
#Trakt.User.Avatar http://vicmackey.trakt.tv/images/avatars/837.jpg Url of users avatar
#Trakt.User.AvatarFileName C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Avatars\ltfearme.jpg Local filename of stored avatar
#Trakt.User.Username ltfearme Username of user
#Trakt.User.FullName Damien Haynes Full name of user if entered online
#Trakt.User.Gender Male Gender of user
#Trakt.User.JoinDate May 21st, 2011 Date signed up to trakt.tv
#Trakt.User.Location Sydney Geographical Location of user
#Trakt.User.Protected False Indicates if the user is marked as private
#Trakt.User.Url http://trakt.tv/user/ltfearme Url to users page on trakt.tv

Shout Properties

Property Example Description
#Trakt.Shout.Text Best series finale ever! The users shout for selected movie, show or episode
#Trakt.Shout.Inserted 21/6/2011 Date/Time of when user created shout
#Trakt.Shout.CurrentItem Bones - 1x10 Title of movie, show or episode
#Trakt.Shout.Fanart C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\MovingPictures\Backdrops\FullSize{(500).Days.of.Summer} [-1433862524].jpg Full path to movie, show fanart, this can be used in skin to display fanart

The following skin controls are available for the Shouts window:

Control Type Control ID Description
Facade 50 Displays list of users that have created shouts for the selected movie, show or episode

GUI Dialogs

Some windows can invoke custom plugin dialogs, the following is a list of dialogs that the trakt plugin invokes.

Rate Dialog

The Rate dialog allows users to rate movies and shows as love or hate.

Skin File Window ID
Trakt.RateDialog.xml 87300
Control Type Control ID Description
Label 1 Dialog Heading
Fade Label 2 Dialog Line 1 text
Label 3 Dialog Line 2 text
Label 4 Dialog Line 3 text
Label 5 Dialog Line 4 text
Label 10 Vote description e.g. Totally Ninja!
Button 100 Love button
Button 101 Hate button

Note: Controls with ID 3 - 5 are currently unused.

Multi-Select Dialog

The Multi-Select dialog allows you to select multiple items in a list menu. The Multi-Select dialog is a shared dialog currently used in the SubCentral and GlobalSearch plugins. It is currently used in the Trakt Lists window.

Skin File Window ID
DialogMultiSelect.xml 2100
Control Type Control ID Description
listcontrol 3 Menu of list items
Label 4 Heading for Multi-Select dialog
Label 5 Main Menu Heading
Button 10 OK Button
Button 11 Cancel Button

External Access

The trakt plugin allows you to interact with it from 3rd Party plugins, currently we support the following functions:

Add to Watch List

You can create a button in Online Videos iTunes/IMDB details view or MovingPictures details view (v1.1.0) so users can add any interesting movies or shows they see to their personal watch list. OnlineVideos IMDB site has support for movies and shows and the iTunes site supports only movies. Add this button to skin to give users this functionality:

Control Type Control ID Description
Button 97258 Add To Watch List button (plugin detects if its a movie or show)

Example

<control>
  <description>Add to Trakt Movie/Show Watch List</description>
  <type>button</type>
  <id>97258</id>
  <label>#Trakt.Translation.AddToWatchList.Label</label>
  <onup>51</onup>
  <ondown>51</ondown>
  <onright>51</onright>
  <onleft>51</onleft>
  <posX>20</posX>
  <posY>642</posY>
  <visible>string.equals(#OnlineVideos.state,details)+[string.equals(#OnlineVideos.selectedSiteUtil,IMDB)|string.equals(#OnlineVideos.selectedSiteUtil,ITMovieTrailers)]+plugin.isenabled(Trakt)</visible>
</control>

Rate

You can create a button in MediaPortal's Video Info Dialog/Window, MovingPictures (details view) or TVSeries Hidden Menu so users can rate movies, shows and episodes as Love (Totally Ninja!) or Hate (Weak Sauce). The Video Info Dialog is typically invoked when viewing information for a movie from My Videos or My TV IMDB lookup (F3 shortcut). Add this button to skin to give users this functionality:

Control Type Control ID Description
Button 97259 Rate Movie, Show or Episode (Automatically Detected depending on window)

Example

<control>
  <description>Trakt Rate</description>
  <type>button</type>
  <id>97259</id>
  <label>#Trakt.Translation.Rate.Label</label>
  <posX>20</posX>
  <posY>642</posY>
  <visible>plugin.isenabled(Trakt)</visible>
</control>

Shouts

You can create a button in MovingPictures, MP-TVSeries or My Videos Video Info windows to view shouts for the selected movie, show or episode. Add this button to skin to give users this functionality:

Control Type Control ID Description
Button 97260 Shouts for selected item (plugin detects if its a movie, show or episode). Do NOT enter a Hyperlink property to window.

Example (TVSeries Hidden Menu in Series and Episode view)

<control>
  <description>Shouts</description>
  <type>button</type>
  <id>97260</id>
  <label>#Trakt.Translation.Shouts.Label</label>
  <onup>99994</onup>
  <ondown>2</ondown>
  <onright>50</onright>
  <onleft>50</onleft>
  <visible>plugin.isenabled(Trakt)+[control.isvisible(1239)|control.isvisible(1237)]+![facadeview.smallicons|facadeview.largeicons]</visible>
</control>
Something went wrong with that request. Please try again.