Skin Designers Guide

Damien Haynes edited this page Dec 29, 2016 · 106 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 Titan or 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 v3.1.0, perform a search on term 3.1.0.

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

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

Movies Popular

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

Shows Popular

Property Description
#Trakt.PopularShows.Fanart.1 Fanart Background #1
#Trakt.PopularShows.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

Movie Recently Watched List (v3.0.0)

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

Episode Recently Watched List (v3.0.0)

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

Movie Recently Added List (v3.0.0)

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

Episode Recently Added List (v3.0.0)

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

Recently Added Shouts (v3.0.0)

Property Description
#Trakt.RecentShouts.Fanart.1 Fanart Background #1
#Trakt.RecentShouts.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

Related Movies (v1.3.0)

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

Related Shows (v1.3.0)

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

Movie Search Results (v3.1.0)

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

Show Search Results (v3.1.0)

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

Episode Search Results (v3.1.0)

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

Box Office (v5.6.0)

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

Person Movie Credits (v5.6.0)

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

Person Show Credits (v5.6.0)

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

Anticipated Movies (v5.6.0)

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

Anticipated Shows (v5.6.0)

Property Description
#Trakt.AnticipatedShows.Fanart.1 Fanart Background #1
#Trakt.AnticipatedShows.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

Movie Properties

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

Property Example Description
#Trakt.Movie.Id 23423423 Trakt id of movie
#Trakt.Movie.ImdbId tt0499549 IMDb id of movie
#Trakt.Movie.TmdbId 19995 TMDb 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.Trailer http://www.youtube.com/watch?v=cRdxXPV9GNQ Url to movie trailer
#Trakt.Movie.Year 2009 Year movie was released
#Trakt.Movie.Genres Adventure, Action List of genres for movie (v1.3.3)
#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 8 User rating of the movie, 1-10
#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.Percentage 78 Percentage of people whom loved movie
#Trakt.Movie.Ratings.Votes 545 Number of people whom have voted

Show Properties

The following skin properties can be used throughout the trakt plugin windows which contain Shows or Episodes:

Property Example Description
#Trakt.Show.Id 23423 Trakt id of show
#Trakt.Show.ImdbId tt0944947 IMDb id of show
#Trakt.Show.TvdbId 121361 TVDb id of show
#Trakt.Show.TvRageId 77121 TVRage id of show
#Trakt.Show.TmdbId 4444 TMDb id of show
#Trakt.Show.Title Game of Thrones Title of Series
#Trakt.Show.Language English Language spoken in 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.AirTimeLocalized 2:30AM Time show airs on live tv in your local time-zone (this is only available in MyShows calendar view) (v2.8.0)
#Trakt.Show.AiredEpisodes 55 Total number of episodes aired in show
#Trakt.Show.Collected 50 Total number of episodes collected in show (v5.6.1)
#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.Status Returning Indicates the status of a show e.g. Ended, Returning etc
#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.Genres Adventure, Action List of genres for show (v1.3.3)
#Trakt.Show.InWatchList true Indicates if show is in your watch list (v1.0.4)
#Trakt.Show.InCollection true Indicates if all aired episodes in show are in your collection
#Trakt.Show.Watched true Indicates if all aired episodes in show have been watched
#Trakt.Show.Plays 14 Total number of times episodes in the show that have been played
#Trakt.Show.Rating 8 User rating of the show, 1-10 (v1.6.0)
#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.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

Season Properties (v5.0.0)

The following skin properties can be used throughout the trakt plugin windows which contain Seasons or Episodes:

Property Example Description
#Trakt.Season.TvdbId 121361 TVDb id of season
#Trakt.Season.TvRageId 77121 TVRage id of season
#Trakt.Season.TmdbId 77121 TMDb id of season
#Trakt.Season.Url http://trakt.tv/shows/12345/seasons/1 Url to season on trakt.tv
#Trakt.Season.Number 1 Season number of show
#Trakt.Season.EpisodeCount 10 Total number of episodes in season
#Trakt.Season.EpisodeAiredCount 10 Total number of episodes in season that have currently aired (v5.1.1)
#Trakt.Season.Collected 50 Total number of episodes collected in season (v5.6.1)
#Trakt.Season.Overview Summers span decades. Winters can last a lifetime. And the struggle for the Iron Throne has begun. Overview of the season, if empty it will populate with the show summary
#Trakt.Season.InWatchList true Indicates if season is in your watch list
#Trakt.Season.InCollection true Indicates if all aired episodes in season are in your collection
#Trakt.Season.Watched true Indicates if all aired episodes in season have been watched
#Trakt.Season.Plays 14 Total number of times episodes in the season that have been played
#Trakt.Season.Rating 8 User rating of the season, 1-10
#Trakt.Season.Ratings.Icon love Site rating of the season, if the rating is positive this is assigned as love otherwise hate. Skinners can use this to display a icon indicating the rating
#Trakt.Season.Ratings.Percentage 78 Percentage of people whom loved season
#Trakt.Season.Ratings.Votes 545 Number of people whom have voted
#Trakt.Season.PosterImageFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\Seasons\Posters\1395.jpg Filename for season poster

Episode Properties

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

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.FirstAiredLocalizedDayOfWeek Monday Air Day of episode in local time-zone (only available in MyShows calendar) (2.8.0)
#Trakt.Episode.Title Winter Is Coming Title of episode
#Trakt.Episode.ImdbId tt1534534 IMDb ID of the episode (v3.1.1)
#Trakt.Episode.TvdbId 99968 TVDb ID of the episode (v3.1.1)
#Trakt.Episode.TmdbId 2233 TMDb ID of the episode (v5.0.0)
#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 8 User rating of the episode, 1-10
#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.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

User Properties

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

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
#Trakt.User.Location Sydney Geographical Location of user
#Trakt.User.Protected False Indicates if the user is marked as private
#Trakt.User.Vip True Indicates if the user is VIP member.
#Trakt.User.Url http://trakt.tv/user/ltfearme Url to users page on trakt.tv

People Properties

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

Property Example Description
#Trakt.Person.Name Patrick Stewart Name of the person selected
#Trakt.Person.HeadshotUrl http://vicmackey.trakt.tv/images/people/837.jpg Url of the person's Headshot.
#Trakt.Person.HeadshotFilename C:\ProgramData\Team MediaPortal\MediaPortal\thumbs\Trakt\People\234.jpg Local filename of stored headshot
#Trakt.Person.Url http://trakt.tv/person/patrick-stewart Url to trakt.tv person
#Trakt.Person.Biography Patrick Stewart is best known for his role as Captain Picard ... Biography of the person
#Trakt.Person.Birthday 1955-01-01 Birth date of person.
#Trakt.Person.Birthplace London, England Birth place of person
#Trakt.Person.TmdbId 234 The ID of the person on themoviedb.org

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 network and userprofile window
defaultTraktUserBig.png Default user image loaded in network and userprofile window
defaultTraktEpisode.png Default episode image loaded in episode windows
defaultTraktEpisodeBig.png Default episode image loaded in episode windows
defaultTraktPoster.png Default poster image loaded in movie and show windows (v3.0.0)
defaultTraktPosterBig.png Default poster image loaded in movie and show windows (v3.0.0)
defaultTraktCalendar.png Default day header image in tv show calendar window
defaultTraktCalendarBig.png Default day header image in tv show calendar window
traktNextWeek.png Default next week image used in the Calendar
traktPreviousPage.png Default previous page image used in windows that support paging (v5.3.0)
traktNextPage.png Default previous next image used in windows that support paging (v5.3.0)

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 collection
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 the user score out of 10. The table below describes what icons can be added to posters:

Filename Description
traktLove.png Love icon is added to poster if user rated item as 'love'
traktHate.png Hate icon is added to poster if user rated item as 'hate'
traktHeart1.png Heart-1 icon is added to poster if user rated item as '1/10' (v1.6.0)
traktHeart2.png Heart-2 icon is added to poster if user rated item as '2/10' (v1.6.0)
traktHeart3.png Heart-3 icon is added to poster if user rated item as '3/10' (v1.6.0)
traktHeart4.png Heart-4 icon is added to poster if user rated item as '4/10' (v1.6.0)
traktHeart5.png Heart-5 icon is added to poster if user rated item as '5/10' (v1.6.0)
traktHeart6.png Heart-6 icon is added to poster if user rated item as '6/10' (v1.6.0)
traktHeart7.png Heart-7 icon is added to poster if user rated item as '7/10' (v1.6.0)
traktHeart8.png Heart-8 icon is added to poster if user rated item as '8/10' (v1.6.0)
traktHeart9.png Heart-9 icon is added to poster if user rated item as '9/10' (v1.6.0)
traktHeart10.png Heart-10 icon is added to poster if user rated item as '10/10' (v1.6.0)

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.

Dashboard Activity PinIcons

The dashboard activity facade displays images that represent each activity, these are added to the PinIcon property.

Filename Description
traktActivityCollected.png User collected an item
traktActivityHate.png User hated an item
traktActivityLove.png User loved an item
traktActivityShout.png User shouted on an item
traktActivityWatched.png User watched/scrobbled an item
traktActivityWatching.png User is watching an item
traktActivityWatchlist.png User added an item to their watchlist
traktActivityLike.png User added an item to their watchlist (v5.5.0)

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>

Dashboard (v1.8.0)

The skinner can customize what is displayed on the dashboard such as user activity, trending shows and movies and user statistics. Using the skin settings you can control what the plugin should request online and how much of it should be pushed to the skin.

See the DefaultWide skin settings file for comments explaining each part of the dashboard.

<dashboard>
<!--
Note: As a skinner you can choose to show a facade or properties or both
for trending and activities. Choose what fits best for each window you implement
the dashboard, there is no limitation where the facade/properties are placed as
long as there is a window id defined.
-->
<activities>
	<!-- Control what GUI windows the dashboard should be displayed on -->
	<!-- Separate multiple window id's with pipe '|' separator -->
	<!-- e.g. <windows>35|87258</windows> for BasicHome.xml and Trakt.xml -->
	<windows>87258</windows>
	<!-- Facade Type e.g. Filmstrip, LargeIcons, SmallIcons, List -->
	<!-- set facade to None if not using a facade -->
	<facadetype>List</facadetype>
	<!-- Set the Max number of items to show in facade -->
	<!-- If you dont expect the user to scroll then set to the viewable amount -->
	<facademaxitems>50</facademaxitems>
	<!-- Number of properties to push to skin for Activity Stream -->
	<!-- Use this to set skin properties independent of the facade or selected item -->
	<!-- if not using properties, then set to 0 -->
	<propertiesmaxitems>0</propertiesmaxitems>
</activities>
    <!-- if you want unique properties for each window then create multiple trending sections (v3.1.0) -->
<trending>
	<facadetype>Filmstrip</facadetype>
	<facademaxitems>7</facademaxitems>
	<propertiesmaxitems>0</propertiesmaxitems>
	<shows>
		<windows>87258</windows>
	</shows>
	<movies>
		<windows>87258</windows>
	</movies>
</trending>
    <trending>
	<facadetype>List</facadetype>
	<facademaxitems>5</facademaxitems>
	<propertiesmaxitems>5</propertiesmaxitems>
	<shows>
		<windows>35</windows>
	</shows>
	<movies>
		<windows>35</windows>
	</movies>
</trending>
<!-- User Statistics e.g. No of Episodes collected/watched -->
<statistics>false</statistics>
</dashboard>

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 This window has been removed in (v3.0.0), use new Network GUI.
Network 87283 Trakt.Network.xml Displays the users Network ie. Friends, Followers, Following etc. You can view a users activity after selecting a user. (v3.0.0)
User Profile 87400 Trakt.UserProfile.xml Displays the current users UserProfile, shows user Statistics and Activities (v3.0.0)
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
Popular 87100 Trakt.Popular.xml Used as a launch pad to movie and tvshow popular windows (v5.3.0)
Shows Popular 87102 Trakt.Popular.Shows.xml Displays the most popular TV Shows (v5.3.0)
Movies Popular 87101 Trakt.Popular.Movies.xml Displays the most popular Movies (v5.3.0)
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
Episode Watched List 87285 Trakt.RecentWatched.Episodes.xml Displays the recently watched episodes for a user. (v3.0.0)
Movie Watched List 87284 Trakt.RecentWatched.Movies.xml Displays the recently watched movies for a user. (v3.0.0)
Episode Added List 87287 Trakt.RecentAdded.Episodes.xml Displays the recently added episodes for a user. (v3.0.0)
Movie Added List 87286 Trakt.RecentAdded.Movies.xml Displays the recently added movies for a user. (v3.0.0)
Recent Shouts 87288 Trakt.RecentShouts.xml Displays the recently shouts and reviews for a user. (v3.0.0)
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)
Related Movies 87277 Trakt.Related.Movies.xml Displays related/similar movies of selected movie (v1.3.0)
Related Shows 87278 Trakt.Related.Shows.xml Displays related/similar shows of selected show (v1.3.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)
Show Seasons 87281 Trakt.Show.Seasons.xml Displays a list of seasons for a TV Show (v2.2.0)
Season Episodes 87282 Trakt.Season.Episodes.xml Displays a list of episodes for a TV Show Season (v2.2.0)
Search 874001 Trakt.Search.xml Displays the main Search GUI (v3.1.0)
Search Movie Results 874004 Trakt.Search.Movies.xml Display search results for movies (v3.1.0)
Search Show Results 874003 Trakt.Search.Shows.xml Display search results for shows (v3.1.0)
Search Episode Results 874002 Trakt.Search.Episodes.xml Display search results for episodes (v3.1.0)
Search People Results 874005 Trakt.Search.People.xml Display search results for people (v3.1.0)
Search User Results 874006 Trakt.Search.Users.xml Display search results for users (v3.1.0)
TV Menu 87500 Trakt.TV.Menu.xml Used as a launch pad to tv show windows (v5.3.1)
Movies Menu 87501 Trakt.Movies.Menu.xml Used as a launch pad to movie windows (v5.3.1)
Lists Menu 87502 Trakt.Lists.Menu.xml Used as a launch pad to list windows (v5.3.1)
Box Office 87607 Trakt.BoxOffice.xml Displays the Top 10 US BoxOffice movies, updated every Monday morning (v5.6.0)
Anticipated Shows 87606 Trakt.Anticipated.Shows.xml Displays the trakt communities most anticipated shows based on user watchlists (v5.6.0)
Anticipated Movies 87605 Trakt.Anticipated.Movies.xml Displays the trakt communities most anticipated shows based on user watchlists (v5.6.0)
Person Summary 87600 Trakt.Person.Summary.xml Displays the detailed summary for a Person (v5.6.0)
Person Movie Credits 87601 Trakt.Person.Credits.Movies.xml Displays the Movie credits for a Person (v5.6.0)
Credits Movie 87603 Trakt.Credits.Movie.xml Displays the Credits (cast and crew) for a Movie (v5.6.0)
Credits Show 87604 Trakt.Credits.Show.xml Displays the Credits (cast and crew) for a Show (v5.6.0)

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)

Episode and Show Properties

See the Common Properties section on available Show and Episode properties.

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)
CheckButton 4 Hide Watchlisted toggle button, allows you to hide shows in watchlist from calendar (v2.8.0)
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.

Network (v3.0.0)

The Network window allows users to browse their list of friends, followers, following and friend requests (for protected users) in a facade list control, when they select a user in their network they can drill down to select the users last activities like Recently Added and Watched.

User Properties

See the Common Properties section on available User properties.

Facade PinIcons

The network facade displays images that represent each activity when a user is selected, these are added to the PinIcon property.

Filename Description
traktUserProfile.png UserProfile (v3.1.2)
traktActivityCollected.png Collection Activities
traktActivityShout.png Shout Activities
traktActivityWatched.png Watched Activities
traktActivityWatchlist.png Watchlist Activities

Skin Controls

The following skin controls are available for the Network window:

Control Type Control ID Description
Facade 50 Displays user list and Activity list (2nd view level)
Button 2 Switch between Friends, Followers, Following, Friend Request views
Button 3 Search for User on Trakt.
Button 4 Refresh your Network.

User Profile (v3.0.0)

The UserProfile window allows a user to view their own Statistics such as 'No. of episodes in their library', they can also view their recent activities such as Recently Watched, Added etc.

User Properties

Property Example Description
#Trakt.UserProfile.CurrentUser ltfearme The username of the user's UserProfile, this is set immediately upon page load and is not delayed like the standard username property. (v3.1.2)

See the Common Properties section on available User properties.

Statistics Friends Properties

Property Example Description
#Trakt.Statistics.Friends 10 Number of friends you have

Statistics Shows Properties

Property Example Description
#Trakt.Statistics.Shows.Library 50 Number of tv shows in your library
#Trakt.Statistics.Shows.Watched 50 Number of tv shows that you have watched
#Trakt.Statistics.Shows.Collection 33 Number of tv shows in your collection
#Trakt.Statistics.Shows.Shouts 3 Number of tv shows you have shouted on
#Trakt.Statistics.Shows.Loved 40 Number of tv shows you love
#Trakt.Statistics.Shows.Hated 5 Number of tv shows you hate

Statistics Episodes Properties

Property Example Description
#Trakt.Statistics.Episodes.Checkins 2 Number of tv episode check-ins
#Trakt.Statistics.Episodes.CheckinsUnique 1 Number of unique tv episode check-ins
#Trakt.Statistics.Episodes.Collection 1982 Number of tv episodes in your collection
#Trakt.Statistics.Episodes.Hated 85 Number of tv episodes you hate
#Trakt.Statistics.Episodes.Loved 1000 Number of tv episodes you love
#Trakt.Statistics.Episodes.Scrobbles 851 Number of tv episodes you have scrobbled
#Trakt.Statistics.Episodes.ScrobblesUnique 851 Number of unique tv episodes you have scrobbled
#Trakt.Statistics.Episodes.Seen 500 Number of tv episodes you have seen
#Trakt.Statistics.Episodes.Shouts 50 Number of tv episodes you have shouted on
#Trakt.Statistics.Episodes.UnWatched 22 Number of tv episodes you have marked as unwatched
#Trakt.Statistics.Episodes.Watched 400 Number of tv episodes you have watched
#Trakt.Statistics.Episodes.WatchedElseWhere 566 Number of tv episodes you have watched outside of trakt
#Trakt.Statistics.Episodes.WatchedTrakt 754 Number of tv episodes you have watched on trakt
#Trakt.Statistics.Episodes.WatchedTraktUnique 566 Number of unique tv episodes you have watched on trakt
#Trakt.Statistics.Episodes.WatchedUnique 545 Number of unique tv episodes you have watched

Statistics Movies Properties

Property Example Description
#Trakt.Statistics.Movies.Checkins 2 Number of tv movie check-ins
#Trakt.Statistics.Movies.CheckinsUnique 1 Number of unique movie check-ins
#Trakt.Statistics.Movies.Collection 1982 Number of movie in your collection
#Trakt.Statistics.Movies.Hated 85 Number of movie you hate
#Trakt.Statistics.Movies.Loved 1000 Number of movie you love
#Trakt.Statistics.Movies.Scrobbles 851 Number of movie you have scrobbled
#Trakt.Statistics.Movies.ScrobblesUnique 851 Number of unique movie you have scrobbled
#Trakt.Statistics.Movies.Seen 500 Number of movie you have seen
#Trakt.Statistics.Movies.Shouts 50 Number of movie you have shouted on
#Trakt.Statistics.Movies.UnWatched 22 Number of movie you have marked as unwatched
#Trakt.Statistics.Movies.Watched 400 Number of movie you have watched
#Trakt.Statistics.Movies.WatchedElseWhere 566 Number of movie you have watched outside of trakt
#Trakt.Statistics.Movies.WatchedTrakt 754 Number of movie you have watched on trakt
#Trakt.Statistics.Movies.WatchedTraktUnique 566 Number of unique movie you have watched on trakt
#Trakt.Statistics.Movies.WatchedUnique 545 Number of unique movie you have watched

Facade PinIcons

The UserProfile facade displays images that represent each activity, these are added to the PinIcon property.

Filename Description
traktActivityCollected.png Collection Activities
traktActivityShout.png Shout Activities
traktActivityWatched.png Watched Activities
traktActivityWatchlist.png Watchlist Activities

Skin Controls

The following skin controls are available for the User Profile window:

Control Type Control ID Description
Facade 50 Displays Activity items
Button 4 Refresh your Statistics

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.

Skin Properties (v1.9.0)

Property Example Description
#Trakt.Recommendations.Genre Animation Genre filter used in Recommendation lookup
#Trakt.Recommendations.HideCollected false filter collected items from recommendations lookup
#Trakt.Recommendations.HideWatchlisted false filter watchlist items from recommendations lookup
#Trakt.Recommendations.StartYear 2000 Start Year of items used in recommendations lookup
#Trakt.Recommendations.EndYear 2012 End Year of items used in recommendations lookup

Movie Recommendations

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

Movie Properties

See the Common Properties section on available Movie properties.

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
Button 3 Genre button, filters movies by genre (v1.9.0)
CheckButton 4 Toggle Button, filters collected movies (v1.9.0)
CheckButton 5 Toggle Button, filters watchlist movies (v1.9.0)
Button 6 Start Year button, filters movies by year (v1.9.0)
Button 7 End Year button, filters movies by year (v1.9.0)
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
Facade 50 Displays the list of movie recommendations

Show Recommendations

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

Show Properties

See the Common Properties section on available Show properties.

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
Button 3 Genre button, filters movies by genre (v1.9.0)
CheckButton 4 Toggle Button, filters collected movies (v1.9.0)
CheckButton 5 Toggle Button, filters watchlist movies (v1.9.0)
Button 6 Start Year button, filters movies by year (v1.9.0)
Button 7 End Year button, filters movies by year (v1.9.0)
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
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
#Trakt.Trending.CurrentPage 1 The current page of results (5.3.0)
#Trakt.Trending.TotalPages 15 The total number of pages that can be requested (5.3.0)
#Trakt.Facade.IsPageItem true or false Whether the current selected item is a 'next page' or 'previous page' button (5.3.0)
#Trakt.Facade.PageToLoad 2 Reports the next page to load when selecting a next or previous page button (5.3.0)
#Trakt.Facade.TotalItemsPerPage 100 Reports the total number of items requested per page (5.3.0)

Movies Trending

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

Trending Properties

Property Example Description
#Trakt.Movie.Watchers 6 Number of users currently watching movie
#Trakt.Movie.Watchers.Extra 6 People A formatted number of users currently watching movie

Movie Properties

See the Common Properties section on available Movie properties.

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
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
CheckButton 9 Hide Watched button, filters watched movies from list (v2.9.0)
CheckButton 10 Hide Watchlisted button, filters watchlist movies from list (v2.9.0)
CheckButton 11 Hide Collected button, filters collected movies from list (v2.9.0)
CheckButton 12 Hide Rated button, filters rated movies from list (v2.9.0)
Facade 50 Displays the list of trending movies

Shows Trending

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

Trending Properties

Property Example Description
#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.Status Ended Show Status, either 'Continuing' or 'Ended'. (v3.1.3)
#Trakt.Show.TranslatedStatus Ended A localised version of the tv show status, this should be used for display. (v3.1.3)

Show Properties

See the Common Properties section on available Show properties.

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
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
CheckButton 9 Hide Watched button, filters watched shows from list (v2.9.0)
CheckButton 10 Hide Watchlisted button, filters watchlist shows from list (v2.9.0)
CheckButton 11 Hide Collected button, filters collected shows from list (v2.9.0)
CheckButton 12 Hide Rated button, filters rated shows from list (v2.9.0)
Facade 50 Displays the list of trending shows

Popular (5.3.0)

The Popular window is used as a launching pad to the most popular Movie and TV Shows currently 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.Popular.CurrentPage 1 The current page of results
#Trakt.Facade.IsPageItem true or false Whether the current selected item is a 'next page' or 'previous page' button
#Trakt.Facade.PageToLoad 2 Reports the next page to load when selecting a next or previous page button
#Trakt.Facade.TotalItemsPerPage 100 Reports the total number of items requested per page (5.3.0)

Movies Popular

The popular movies window displays the most popular movies currently on trakt.tv.

Movie Properties

See the Common Properties section on available Movie properties.

Skin Controls

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

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Sort Button 8 Sort button, controls sorting of contents in list
CheckButton 9 Hide Watched button, filters watched movies from list
CheckButton 10 Hide Watchlisted button, filters watchlist movies from list
CheckButton 11 Hide Collected button, filters collected movies from list
CheckButton 12 Hide Rated button, filters rated movies from list
Facade 50 Displays the list of popular movies

Shows Popular

The popular shows window displays the most popular shows currently on trakt.tv.

Show Properties

See the Common Properties section on available Show properties.

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
Sort Button 8 Sort button, controls sorting of contents in list
CheckButton 9 Hide Watched button, filters watched shows from list
CheckButton 10 Hide Watchlisted button, filters watchlist shows from list
CheckButton 11 Hide Collected button, filters collected shows from list
CheckButton 12 Hide Rated button, filters rated shows from list
Facade 50 Displays the list of popular 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.

WatchList Properties

Property Example Description
#Trakt.Movie.WatchList.Inserted December 10, 2009 Date user added movie to watch list

Movie Properties

See the Common Properties section on available Movie properties.

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
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
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.

WatchList Properties

Property Example Description
#Trakt.Show.WatchList.Inserted December 10, 2009 Date user added show to watch list

Show Properties

See the Common Properties section on available Show properties.

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
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
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.

WatchList Properties

Property Example Description
#Trakt.Episode.WatchList.Inserted January 10, 2011 Date user added episode to watch list

Show and Episode Properties

See the Common Properties section on available Show and Episode properties.

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
Sort Button 8 Sort button, controls sorting of contents in list (v2.0.0)
Facade 50 Displays the list of episodes in users watch list

Recently Watched Movies (v3.0.0)

The Recently Watched Movies window is used to display a users recently watched movies, it can display up to 100 movies. This is accessible from the Network and UserProfile GUI.

Static Properties

Property Example Description
#Trakt.RecentWatched.CurrentUser Damien Current User that list belongs to.

Recently Watched Properties

Property Example Description
#Trakt.Movie.WatchedDate January 10, 2011 Date user watched movie

Movie Properties

See the Common Properties section on available Movie properties.

Skin Controls

The following skin controls are available for the this window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Recently Watched Movies list

Recently Added Movies (v3.0.0)

The Recently Added Movies window is used to display a users recently added movies, it can display up to 100 movies. This is accessible from the Network and UserProfile GUI.

Static Properties

Property Example Description
#Trakt.RecentAdded.CurrentUser Damien Current User that list belongs to.

Recently Added Properties

Property Example Description
#Trakt.Movie.AddedDate January 10, 2011 Date user added movie to their collection.

Movie Properties

See the Common Properties section on available Movie properties.

Skin Controls

The following skin controls are available for the this window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Recently Added Movies list

Recently Watched Episodes (v3.0.0)

The Recently Watched Episodes window is used to display a users recently watched episodes, it can display up to 100 episodes. This is accessible from the Network and UserProfile GUI.

Static Properties

Property Example Description
#Trakt.RecentWatched.CurrentUser Damien Current User that list belongs to.

Recently Watched Properties

Property Example Description
#Trakt.Episode.WatchedDate January 10, 2011 Date user watched episode

Show and Episode Properties

See the Common Properties section on available Show and Episode properties.

Skin Controls

The following skin controls are available for the this window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Recently Watched Episodes list

Recently Added Episodes (v3.0.0)

The Recently Added Episodes window is used to display a users recently added episodes, it can display up to 100 episodes. This is accessible from the Network and UserProfile GUI.

Static Properties

Property Example Description
#Trakt.RecentAdded.CurrentUser Damien Current User that list belongs to.

Recently Added Properties

Property Example Description
#Trakt.Episode.AddedDate January 10, 2011 Date user added episode to their collection.

Show and Episode Properties

See the Common Properties section on available Show and Episode properties.

Skin Controls

The following skin controls are available for the this window:

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Facade 50 Recently Added Episodes 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.Id 3333 Trakt Id of list
#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.Likes 5 Number of people whom have liked a list (v5.0.0)
#Trakt.List.Comments 5 Number of comments associated with the list (v5.1.1)
#Trakt.List.ItemCount 15 Number of items in the list (v5.0.0)
#Trakt.List.AllowShouts true Determines if shouts (comments) are allowed to be posted on list
#Trakt.List.ShowNumbers true Determines if list items are numbered
#Trakt.List.Slug top-10 A unique id for the selected list
#Trakt.List.Url http://trakt.tv/users/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.

Selected Item Properties

See the Common Properties section on available Movie, Show, Season and Episode properties.

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.

Related Movies (v1.3.0)

The related movies window displays 10 related/similar movies of the selected movie e.g. user may select 'Related Movies' from the trending movies screen or from MovingPictures details view.

Static Properties

Property Example Description
#Trakt.Related.Movie Avatar Title of movie in context

Movie Properties

See the Common Properties section on available Movie properties.

Skin Controls

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

Control Type Control ID Description
Button 2 Layout button, controls layout of facade e.g. List, Small Icons, Filmstrip
Checkmark 3 Hide Watched Checkmark, Hides watched from view
Facade 50 Displays the list of related/similar movies

Related Shows (v1.3.0)

The related shows window displays 10 related/similar shows of the selected show e.g. user may select 'Related Shows' from the trending shows screen or from MP-TVSeries context menu.

Static Properties

Property Example Description
#Trakt.Related.Show Dexter Title of show in context

Show Properties

See the Common Properties section on available Show properties.

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
Checkmark 3 Hide Watched Checkmark, Hides watched from view
Facade 50 Displays the list of shows in users watch 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.

All ToggleButtons have been replaced with CheckButtons in (v2.9.0).

Control Type Control ID Description
CheckButton 2 TVSeries toggle button
CheckButton 3 Moving Pictures toggle button
CheckButton 4 My Videos toggle button
CheckButton 5 My Films toggle button
CheckButton 6 OnlineVideos toggle button (v1.1.0)
CheckButton 7 My Anime toggle button (v1.1.0), Removed in (v5.0.0)
CheckButton 8 My TV Recordings toggle button (v1.4.0)
CheckButton 9 4TR TV Recordings toggle button (v1.4.0), Removed in (v5.0.0)
CheckButton 10 My TV Live toggle button (v1.5.0)
CheckButton 11 4TR TV Live toggle button (v1.5.0), Removed in (v5.0.0)
CheckButton 12 Argus TV Recordings toggle button (v2.5.0)
CheckButton 13 Argus TV Live toggle button (v2.5.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.

All ToggleButtons have been replaced with CheckButtons in (v2.9.0).

Control Type Control ID Description
CheckButton 2 Download Fanart toggle button, will disable downloading and displaying of fanart if not selected
CheckButton 3 Download Full Size Fanart toggle button, will download original sized fanart when selected. When not selected fanart will be downloaded at 940px wide
CheckButton 4 Get Friend Requests on Startup toggle button, will fetch a list of friend requests on startup and notify user (v1.0.2)
CheckButton 5 MovingPictures Categories toggle button, enable to create Recommendations/Watch List categories (v1.0.5)
CheckButton 6 MovingPictures Filters toggle button, enable to create Recommendations/Watch List filter menu items (v1.0.5)
CheckButton 7 Show Rate Dialog on Watched toggle button, enable to show the trakt rate dialog after an episode or movie is watched. It will only be shown if item is not already rated (v2.1.0)
CheckButton 8 Synchronize Ratings toggle button, enable this setting for 2-way synchronization of ratings during library sync. If an item has been rated locally or remotely then it wont be overwritten to avoid any rounding issues.
CheckButton 9 My Films Categories toggle button, enable to create Custom List/Recommendations/Watch List categories (v2.2.0)
CheckButton 10 Playback / Resume Data Sync toggle button, enable to sync up your partially watched videos such that you can resume where you left off from multiple devices (v5.1.0)
Button 20 Start a manual Library Sync (v5.1.0)

Shouts

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

User Properties

See the Common Properties section on available User properties.

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
#Trakt.Shout.Spoiler true Indicates if the shout contains a spoiler (v1.3.1)
#Trakt.Shout.Id true Id of the shout, will be used for replies or navigate to URL (v2.7.0)
#Trakt.Shout.Likes true The number of users that have liked a shout (v2.7.0)
#Trakt.Shout.Replies true The number of replied shouts (v2.7.0)
#Trakt.Shout.UserRating true The rating a user has given the item being shouted (v2.7.0)

Skin Controls

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
CheckButton 2 Toggle to Hide Spoilers in shouts (v1.3.1)
Button 3 Press to show shouts for the Next Episode, only available in Episode Shouts (v2.6.0)
Button 4 Press to show shouts for the Previous Episode, only available in Episode Shouts (v2.6.0)

Most Recent Shouts (v3.0.0)

The Most Recent Shouts window lists the most recently added shouts and reviews for a user. It is accessible from the Network and UserProfile GUI's.

Static Properties

Property Example Description
#Trakt.RecentShouts.CurrentUser Damien The User whom shouted or reviewed items in this window.

User Properties

See the Common Properties section on available User properties.

Shout Properties

Property Example Description
#Trakt.Shout.Text Best series finale ever! The users shout for selected movie, show or episode
#Trakt.Shout.Date 21/6/2011 Date/Time of when user created shout
#Trakt.Shout.Spoiler true Indicates if the shout contains a spoiler
#Trakt.Shout.Review false Indicates if the shout is a review.

Selected Item Properties

See the Common Properties section on available Movie, Show and Episode properties.

The following skin controls are available for the this window:

Control Type Control ID Description
Facade 50 Displays list of the most recently added shouts for a user.
CheckButton 2 Toggle to Hide Spoilers in shouts

Search (v3.1.0)

The Search window allows the user to enter a Search Term and perform a search on Movies, Shows, Episodes, People and Users. When the search results come back the user gets a breakdown by search type with how many results found, the user can then click on each one to load their corresponding results.

Skin Properties

Property Example Description
#Trakt.Search.SearchTerm star trek The search term entered in by the user.

Skin Controls

The following skin controls are available for the Lists window:

Control Type Control ID Description
Facade 50 Displays the break down of search results by search type.
Button 2 Click on this button to display the Virtual Keyboard, used to enter a Search Term.
CheckButton 3 Select to search movies.
CheckButton 4 Select to search tv shows.
CheckButton 5 Select to search episodes.
CheckButton 6 Select to search people.
CheckButton 7 Select to search users.

Search Movie Results (v3.1.0)

The movie search results window displays up to 30 search results from Search Term entered from the main Search GUI. This window also has support for loading parameters, skins can use the hyperlinkParameter to pass a string to this window and it will perform a search.

Static Properties

Property Example Description
#Trakt.Search.SearchTerm star trek Search Term used to perform search

Movie Properties

See the Common Properties section on available Movie properties.

Skin Controls

The following skin controls are available for the Search Movie Results 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 search results

Search TV Show Results (v3.1.0)

The tv show search results window displays up to 30 search results from Search Term entered from the main Search GUI. This window also has support for loading parameters, skins can use the hyperlinkParameter to pass a string to this window and it will perform a search.

Static Properties

Property Example Description
#Trakt.Search.SearchTerm star trek Search Term used to perform search

Show Properties

See the Common Properties section on available Show properties.

Skin Controls

The following skin controls are available for the Search Show Results 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 search results

Search Episode Results (v3.1.0)

The episode search results window displays up to 30 search results from Search Term entered from the main Search GUI. This window also has support for loading parameters, skins can use the hyperlinkParameter to pass a string to this window and it will perform a search.

Static Properties

Property Example Description
#Trakt.Search.SearchTerm star trek Search Term used to perform search

Show Properties

See the Common Properties section on available Show properties.

Episode Properties

See the Common Properties section on available Episode properties.

Skin Controls

The following skin controls are available for the Search Episode Results 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 search results

Search People Results (v3.1.0)

The people search results window displays up to 30 search results from Search Term entered from the main Search GUI. This window also has support for loading parameters, skins can use the hyperlinkParameter to pass a string to this window and it will perform a search.

Static Properties

Property Example Description
#Trakt.Search.SearchTerm patrick stewart Search Term used to perform search

People Properties

See the Common Properties section on available People properties plus any additional ones below.

Property Example Description
#Trakt.People.Fanart C:\ProgramData\Team MediaPortal\MediaPortal\Thumbs\Trakt\Movies\21324.jpg Fanart to display, this only applicable when performing a search for multiple people from an external plugin e.g. Searching for all actors on a selected movie. (v3.1.1)

Skin Controls

The following skin controls are available for the Search People Results 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 search results

Search User Results (v3.1.0)

The user search results window displays up to 30 search results from Search Term entered from the main Search GUI. This window also has support for loading parameters, skins can use the hyperlinkParameter to pass a string to this window and it will perform a search.

The Network GUI also uses this window to find new users to follow.

Static Properties

Property Example Description
#Trakt.Search.SearchTerm damien Search Term used to perform search

User Properties

See the Common Properties section on available User properties.

Skin Controls

The following skin controls are available for the Search User Results 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 search results

Dashboard (v1.8.0)

The dashboard can show user activity (friends and community), trending shows and movies and user statistics. The dashboard can display information in facade objects, skin properties or both. The Dashboard can be displayed anywhere in MediaPortal such as the BasicHome screen or Trakt screen. A Typical use case would be to show just the trending movies when you hover over a movie plugin on the BasicHome screen.

Skin Controls

The following skin controls can be used on the dashboard:

Control Type Control ID Required Description
CheckButton 98298 no Toggle button to hide or show trending movies/shows
Animation 98299 no Animation used when activity stream is updating
Facade 98300 no Activity Stream of trakt community/friends
Facade 98301 no Trending Shows
Facade 98302 no Trending Movies

Note: The Activity facade displays User Avatars in the Thumbnail icon and Activity Image in the PinIcon.

Skin Properties

There are two types of skin properties on the dashboard (dependent on skin settings). The first type is the typical selection properties i.e the properties that are pushed to skin when selecting a facade item. The second type are index properties that represent each trending/activity item (these are independent of the facades), skin settings decide how many of the items should be pushed to skin e.g. the 1st 3 trending movie and show properties.

Misc Properties

Property Example Description
#Trakt.Dashboard.TrendingType.Active shows or movies This property is used in conjunction with the CheckButton to toggle trending shows and movies. This allows a bit more flexibility with your designs.

Statistics Friends Properties

Property Example Description
#Trakt.Statistics.Friends 10 Number of friends you have
#Trakt.Statistics.Followers 10 Number of followers you have (v5.0.0)
#Trakt.Statistics.Following 10 Number of people following you (v5.0.0)

Statistics Shows Properties

Property Example Description
#Trakt.Statistics.Shows.Library 50 Number of tv shows in your library
#Trakt.Statistics.Shows.Watched 50 Number of tv shows that you have watched
#Trakt.Statistics.Shows.Collection 33 Number of tv shows in your collection
#Trakt.Statistics.Shows.Shouts 3 Number of tv shows you have shouted on
#Trakt.Statistics.Shows.Loved 40 Number of tv shows you love
#Trakt.Statistics.Shows.Hated 5 Number of tv shows you hate

Statistics Episodes Properties

Property Example Description
#Trakt.Statistics.Episodes.Checkins 2 Number of tv episode check-ins
#Trakt.Statistics.Episodes.CheckinsUnique 1 Number of unique tv episode check-ins
#Trakt.Statistics.Episodes.Collection 1982 Number of tv episodes in your collection
#Trakt.Statistics.Episodes.Hated 85 Number of tv episodes you hate
#Trakt.Statistics.Episodes.Loved 1000 Number of tv episodes you love
#Trakt.Statistics.Episodes.Scrobbles 851 Number of tv episodes you have scrobbled
#Trakt.Statistics.Episodes.ScrobblesUnique 851 Number of unique tv episodes you have scrobbled
#Trakt.Statistics.Episodes.Seen 500 Number of tv episodes you have seen
#Trakt.Statistics.Episodes.Shouts 50 Number of tv episodes you have shouted on
#Trakt.Statistics.Episodes.UnWatched 22 Number of tv episodes you have marked as unwatched
#Trakt.Statistics.Episodes.Watched 400 Number of tv episodes you have watched
#Trakt.Statistics.Episodes.WatchedElseWhere 566 Number of tv episodes you have watched outside of trakt
#Trakt.Statistics.Episodes.WatchedTrakt 754 Number of tv episodes you have watched on trakt
#Trakt.Statistics.Episodes.WatchedTraktUnique 566 Number of unique tv episodes you have watched on trakt
#Trakt.Statistics.Episodes.WatchedUnique 545 Number of unique tv episodes you have watched

Statistics Movies Properties

Property Example Description
#Trakt.Statistics.Movies.Checkins 2 Number of tv movie check-ins
#Trakt.Statistics.Movies.CheckinsUnique 1 Number of unique movie check-ins
#Trakt.Statistics.Movies.Collection 1982 Number of movie in your collection
#Trakt.Statistics.Movies.Hated 85 Number of movie you hate
#Trakt.Statistics.Movies.Loved 1000 Number of movie you love
#Trakt.Statistics.Movies.Scrobbles 851 Number of movie you have scrobbled
#Trakt.Statistics.Movies.ScrobblesUnique 851 Number of unique movie you have scrobbled
#Trakt.Statistics.Movies.Seen 500 Number of movie you have seen
#Trakt.Statistics.Movies.Shouts 50 Number of movie you have shouted on
#Trakt.Statistics.Movies.UnWatched 22 Number of movie you have marked as unwatched
#Trakt.Statistics.Movies.Watched 400 Number of movie you have watched
#Trakt.Statistics.Movies.WatchedElseWhere 566 Number of movie you have watched outside of trakt
#Trakt.Statistics.Movies.WatchedTrakt 754 Number of movie you have watched on trakt
#Trakt.Statistics.Movies.WatchedTraktUnique 566 Number of unique movie you have watched on trakt
#Trakt.Statistics.Movies.WatchedUnique 545 Number of unique movie you have watched

Statistics Ratings Properties (5.2.1)

Property Example Description
#Trakt.Statistics.Ratings.Total 2005 Total number of ratings
#Trakt.Statistics.Ratings.Distribution.1 3 Total number of ratings of 1/10
#Trakt.Statistics.Ratings.Distribution.2 1 Total number of ratings of 2/10
#Trakt.Statistics.Ratings.Distribution.3 5 Total number of ratings of 3/10
#Trakt.Statistics.Ratings.Distribution.4 55 Total number of ratings of 4/10
#Trakt.Statistics.Ratings.Distribution.5 49 Total number of ratings of 5/10
#Trakt.Statistics.Ratings.Distribution.6 190 Total number of ratings of 6/10
#Trakt.Statistics.Ratings.Distribution.7 890 Total number of ratings of 7/10
#Trakt.Statistics.Ratings.Distribution.8 290 Total number of ratings of 8/10
#Trakt.Statistics.Ratings.Distribution.9 90 Total number of ratings of 9/10
#Trakt.Statistics.Ratings.Distribution.10 41 Total number of ratings of 10/10

Activity Index Properties

Property Example Description
#Trakt.Activity.{0}.Action scrobble The action of the activity e.g. scrobble, checkin, rating
#Trakt.Activity.{0}.Type movie The type of item in activity e.g. as episode or movie
#Trakt.Activity.{0}.ActivityPinIcon traktActivityWatching.png The icon used in activity facade for activity
#Trakt.Activity.{0}.ActivityPinIconNoExt traktActivityWatching The icon used in activity facade for activity
#Trakt.Activity.{0}.Title Dexter - 3x01 The title of the item in activity
#Trakt.Activity.{0}.Day Wed The day of the activity
#Trakt.Activity.{0}.Shout This episode was epic! If action is shout then the text of the shout

Activity Facade Properties

Property Example Description
#Trakt.Activity.Count 50 The number of activities in facade
#Trakt.Activity.Items 50 Activities The number of activities in facade
#Trakt.Activity.Description See what your friends are up to... The description of the content in the activity facade e.g. Community or Friends

Plus all User Profile properties are available for selected activity facade items.

Trending Movies and Shows Properties

All trending properties are available for selected facade items as well as indexed properties. See Trending properties for details.

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, shows and episodes 1-10.

Skin File Window ID
Trakt.RateDialog.xml 87300

All ToggleButtons have been replaced with CheckMarks in (v2.9.0).

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 11 Vote description e.g. Good 7/10 (v1.6.0)
Button 99 Unrate button (v1.6.0)
CheckMark 1001 1-Heart button (v1.6.0)
CheckMark 1002 2-Heart button (v1.6.0)
CheckMark 1003 3-Heart button (v1.6.0)
CheckMark 1004 4-Heart button (v1.6.0)
CheckMark 1005 5-Heart button (v1.6.0)
CheckMark 1006 6-Heart button (v1.6.0)
CheckMark 1007 7-Heart button (v1.6.0)
CheckMark 1008 8-Heart button (v1.6.0)
CheckMark 1009 9-Heart button (v1.6.0)
CheckMark 1010 10-Heart button (v1.6.0)

Note: Controls with ID 3 - 5 are currently unused. Skinners should be careful with control navigation e.g onup, the plugin will conditionally hide/show the needed controls. The Unrate button is common between both dialog types and would typically be hidden by skinner.

Multi-Select Dialog (v1.2.0)

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 List (v1.2.0)

You can create a button in Online Videos iTunes/IMDb details view, MovingPictures details view, Showtimes details view (v2.5.0) or My Videos Info Dialog so users can add any interesting movies or shows they see to their custom lists. Add this button to skin to give users this functionality:

Control Type Control ID Description
Button 97261 Add To List button

Example

<control>
  <description>Add Movie to Trakt Custom List</description>
  <type>button</type>
  <id>97261</id>
  <label>#Trakt.Translation.AddToList.Label</label>
  <onup>51</onup>
  <ondown>51</ondown>
  <onright>51</onright>
  <onleft>51</onleft>
  <posX>20</posX>
  <posY>642</posY>
  <visible>plugin.isenabled(Trakt)</visible>
</control>

Add to Watch List

You can create a button in Online Videos iTunes/IMDb details view, MovingPictures details view (v1.1.0) or Showtimes details view (v2.5.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>

Related Items (v1.3.0)

You can create a button in MovingPictures details view, My Videos Info Dialog or TVSeries so users can view related movies/shows. Add this button to skin to give users this functionality:

Control Type Control ID Description
Button 97262 Related Movies/Shows

Example

<control>
  <description>Related Movies</description>
  <type>button</type>
  <id>97262</id>
  <label>#Trakt.Translation.RelatedMovies.Label</label>
  <onup>51</onup>
  <ondown>51</ondown>
  <onright>51</onright>
  <onleft>51</onleft>
  <posX>20</posX>
  <posY>642</posY>
  <visible>plugin.isenabled(Trakt)</visible>
</control>

Search By (v3.1.0)

You can create a button in MovingPictures details view or TVSeries so users can view biography / headshots of people related to the selected movie, show or episode.

Control Type Control ID Description
Button 97263 Search By Actors, Directors, Writers and GuestStars

Example

<control>
  <description>SearchBy</description>
  <type>button</type>
  <id>97263</id>
  <label>#Trakt.Translation.SearchBy.Label...</label>
  <onup>51</onup>
  <ondown>51</ondown>
  <onright>51</onright>
  <onleft>51</onleft>
  <posX>20</posX>
  <posY>672</posY>
  <visible>plugin.isenabled(Trakt)</visible>
</control>

MPEI Settings (v1.3.1)

You can create a button in the Trakt Settings window which launches the trakt MPEI (extensions) settings, this is used for advanced plugin settings and requires the Extensions plugin to be installed.

Example

<control>
  <description>MPEICONFIGURE:a9c3845a_8718_4712_85cc_26f56520bb9a</description>
  <type>button</type>
  <id>9999</id>
  <label>#Trakt.Translation.AdvancedSettings.Label</label>
  <ondown>2</ondown>
  <visible>string.equals(#mpei.a9c3845a_8718_4712_85cc_26f56520bb9a.isinstalled, true)</visible>
</control>

Trakt Context Menu (v1.8.0)

You can create a button in any external plugin window e.g. MyVideos VideoInfo, MovingPictures details view or TVSeries Series/Episode view which will display a context menu for the selected item. The menu shows all relevant actions you can do e.g. Rate Item, View Shouts, View Related Items, Add To Watchlist, Add To Custom List and Search By for related people. This is very useful to skinners with limited space and can't afford to add a button for each action.

Control Type Control ID Description
Button 97270 Trakt Context Menu

Example

<control>
  <description>Trakt Context Menu</description>
  <type>button</type>
  <id>97270</id>
  <label>Trakt...</label>
  <onup>51</onup>
  <ondown>51</ondown>
  <onright>51</onright>
  <onleft>51</onleft>
  <posX>20</posX>
  <posY>642</posY>
  <visible>plugin.isenabled(Trakt)</visible>
</control>