Skin Designers Guide
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.
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.
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:
| Property | Description |
|---|---|
| #Trakt.Calendar.Fanart.1 | Fanart Background #1 |
| #Trakt.Calendar.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecommendedMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.RecommendedMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecommendedShows.Fanart.1 | Fanart Background #1 |
| #Trakt.RecommendedShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.TrendingMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.TrendingMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.TrendingShows.Fanart.1 | Fanart Background #1 |
| #Trakt.TrendingShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.PopularMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.PopularMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.PopularShows.Fanart.1 | Fanart Background #1 |
| #Trakt.PopularShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.WatchListMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.WatchListMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.WatchListShows.Fanart.1 | Fanart Background #1 |
| #Trakt.WatchListShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.WatchListEpisodes.Fanart.1 | Fanart Background #1 |
| #Trakt.WatchListEpisodes.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecentWatchedMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.RecentWatchedMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecentWatchedEpisodes.Fanart.1 | Fanart Background #1 |
| #Trakt.RecentWatchedEpisodes.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecentAddedMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.RecentAddedMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecentAddedEpisodes.Fanart.1 | Fanart Background #1 |
| #Trakt.RecentAddedEpisodes.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RecentShouts.Fanart.1 | Fanart Background #1 |
| #Trakt.RecentShouts.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.List.Fanart.1 | Fanart Background #1 |
| #Trakt.List.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RelatedMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.RelatedMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.RelatedShows.Fanart.1 | Fanart Background #1 |
| #Trakt.RelatedShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.SearchMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.SearchMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.SearchShows.Fanart.1 | Fanart Background #1 |
| #Trakt.SearchShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.SearchEpisodes.Fanart.1 | Fanart Background #1 |
| #Trakt.SearchEpisodes.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.BoxOffice.Fanart.1 | Fanart Background #1 |
| #Trakt.BoxOffice.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.PersonCreditMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.PersonCreditMovies.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.PersonCreditShows.Fanart.1 | Fanart Background #1 |
| #Trakt.PersonCreditShows.Fanart.2 | Fanart Background #2 |
| Property | Description |
|---|---|
| #Trakt.AnticipatedMovies.Fanart.1 | Fanart Background #1 |
| #Trakt.AnticipatedMovies.Fanart.2 | Fanart Background #2 |
| 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.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
This section describes the different media that the plugin will load in each trakt window.
| 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) |
The following is used as the home screen hover image:
| Filename | Description |
|---|---|
| hover_trakt.png | Main plugin hover image |
The following image is used for all notification dialogs:
| Filename | Description |
|---|---|
| Logos\trakt.png | Image used in notification dialogs |
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.
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.
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 is a special skin xml used by skinners to customize certain settings controlled by plugin e.g. adding icons on posters.
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>
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>
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) |
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.
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.
| 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) |
See the Common Properties section on available Show and Episode properties.
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.
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.
See the Common Properties section on available User properties.
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 |
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. |
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.
| 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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Statistics.Friends | 10 | Number of friends you have |
| 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 |
| 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 |
| 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 |
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 |
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 |
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.
| 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 |
The movie recommendations window displays personal movie recommendations for the user.
See the Common Properties section on available Movie properties.
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 |
The show recommendations window displays personal tv show recommendations for the user.
See the Common Properties section on available Show properties.
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 |
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.
| 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) |
The trending movies window displays movies actively been watched by trakt users now.
| 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 |
See the Common Properties section on available Movie properties.
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 |
The trending shows window displays the shows currently watched by trakt users.
| 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) |
See the Common Properties section on available Show properties.
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 |
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.
| 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) |
The popular movies window displays the most popular movies currently on trakt.tv.
See the Common Properties section on available Movie properties.
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 |
The popular shows window displays the most popular shows currently on trakt.tv.
See the Common Properties section on available Show properties.
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 |
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) |
The movie watch list window displays movies in the users watch list.
| Property | Example | Description |
|---|---|---|
| #Trakt.Movie.WatchList.Inserted | December 10, 2009 | Date user added movie to watch list |
See the Common Properties section on available Movie properties.
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 |
The show watch list window displays shows in the users Watch List.
| Property | Example | Description |
|---|---|---|
| #Trakt.Show.WatchList.Inserted | December 10, 2009 | Date user added show to watch list |
See the Common Properties section on available Show properties.
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 |
The episode watch list window displays episodes in the users Watch List.
| Property | Example | Description |
|---|---|---|
| #Trakt.Episode.WatchList.Inserted | January 10, 2011 | Date user added episode to watch list |
See the Common Properties section on available Show and Episode properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.RecentWatched.CurrentUser | Damien | Current User that list belongs to. |
| Property | Example | Description |
|---|---|---|
| #Trakt.Movie.WatchedDate | January 10, 2011 | Date user watched movie |
See the Common Properties section on available Movie properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.RecentAdded.CurrentUser | Damien | Current User that list belongs to. |
| Property | Example | Description |
|---|---|---|
| #Trakt.Movie.AddedDate | January 10, 2011 | Date user added movie to their collection. |
See the Common Properties section on available Movie properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.RecentWatched.CurrentUser | Damien | Current User that list belongs to. |
| Property | Example | Description |
|---|---|---|
| #Trakt.Episode.WatchedDate | January 10, 2011 | Date user watched episode |
See the Common Properties section on available Show and Episode properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.RecentAdded.CurrentUser | Damien | Current User that list belongs to. |
| Property | Example | Description |
|---|---|---|
| #Trakt.Episode.AddedDate | January 10, 2011 | Date user added episode to their collection. |
See the Common Properties section on available Show and Episode properties.
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 |
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.
| 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. |
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. |
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.
| 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. |
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.
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. |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Related.Movie | Avatar | Title of movie in context |
See the Common Properties section on available Movie properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Related.Show | Dexter | Title of show in context |
See the Common Properties section on available Show properties.
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 |
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 allows the user to Create a new account, login to an existing account or disconnect (Sign-out) from the current one.
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 |
| 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 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 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) |
The Shouts window allows users to view shouts for selected movies, shows or episodes.
See the Common Properties section on available User 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) |
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) |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.RecentShouts.CurrentUser | Damien | The User whom shouted or reviewed items in this window. |
See the Common Properties section on available User 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. |
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Search.SearchTerm | star trek | The search term entered in by the user. |
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. |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Search.SearchTerm | star trek | Search Term used to perform search |
See the Common Properties section on available Movie properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Search.SearchTerm | star trek | Search Term used to perform search |
See the Common Properties section on available Show properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Search.SearchTerm | star trek | Search Term used to perform search |
See the Common Properties section on available Show properties.
See the Common Properties section on available Episode properties.
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Search.SearchTerm | patrick stewart | Search Term used to perform search |
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) |
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 |
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.
| Property | Example | Description |
|---|---|---|
| #Trakt.Search.SearchTerm | damien | Search Term used to perform search |
See the Common Properties section on available User properties.
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 |
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.
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.
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.
| 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. |
| 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) |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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.
All trending properties are available for selected facade items as well as indexed properties. See Trending properties for details.
Some windows can invoke custom plugin dialogs, the following is a list of dialogs that the trakt plugin invokes.
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.
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 |
The trakt plugin allows you to interact with it from 3rd Party plugins, currently we support the following functions:
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>
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>
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>
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>
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>
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>
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>
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>