Service Monitor - jurialmunkey/plugin.video.themoviedb.helper GitHub Wiki

TMDbHelper provides a ListItem service monitor that provides details about the current item from online APIs. By default, the service monitor will be in an idle state. To use the service monitor, enable the skin setting TMDbHelper.Service in your skin. You can also disable some parts of the service monitor such as additional artwork lookups if not needed.

As of v5, TMDbHelper has two methods for using the service monitor:

• The default "classic" method where info is set as a home window property
  • Window(Home).Property() is global and so can be accessed in any window.
• The experimental "container" method where a listitem is added to a hidden container.
  • Access details using standard listitem infolabel within local scope of current window.

NOTE: The container method is an experimental feature which is not recommended for stable use due to underlying bugs in exception handling for the Kodi xbmcgui module.

TMDbHelper will output details to window properties on the home screen $INFO[Window(Home).Property(TMDbHelper.ListItem.PROPERTY)]

Replace "PROPERTY" with the property name from Detailed Item Wiki Page. Note that infolabels and infoproperties need to be converted as in the following examples:

TMDbHelper adds the details to a hidden container as specified by Skin.SetString(TMDbHelper.MonitorContainer,99950). Using this option allows access to the details via infolabels as a standard listitem. $INFO[Container(99950).ListItem.INFOLABEL]

To use this method you must add a hidden list container with the specified ID on every window and dialog where you want to use the service monitor. If the active window does not have this container then TMDbHelper will idle until a window with the container becomes active.

<control type="list" id="99950">
   <itemlayout />
   <focusedlayout />
   <width>1</width>
   <height>1</height>
   <left>-1920</left>
</control>

See the Detailed Item Wiki Page for a list of available properties.

As of v4.6.44 it is also possible to get details of the now playing item by switching "ListItem" with "Player" in the window property $INFO[Window(Home).Property(TMDbHelper.Player.PROPERTY)]

Note: Syntax has changed as of v6.9+ For earlier versions replace dotted notation with underscores e.g. Premiered_Long vs. Premiered.Long

Information is provided by JustWatch via the TMDb API for services on which the item is available for streaming, download, rent or buy. You MUST display the JustWatch logo and attribute this data as being from JustWatch whenever you use it.

TMDbHelper also provides a simple blur monitor.

Skin.ToggleSetting(TMDbHelper.EnableBlur)

SetProperty(TMDbHelper.Blur.SourceImage,poster,Home)

The blurred artwork is taken from the active item in the service monitor. If you set a widget container ID property, it will take the source image for that item.

As of v2.4.37 it is possible to set a pipe | separated custom order of source artwork properties

SetProperty(TMDbHelper.Blur.SourceImage,Art(tvshow.fanart)|Art(fanart)|Art(tvshow.poster),Home)

SetProperty(TMDbHelper.Blur.Fallback,special://skin/extras/backgrounds/background.jpg,Home)

This image will be used for the blur if the specified source images are not available.

RunScript(plugin.video.themoviedb.helper,blur_image=special://skin/extras/backgrounds/background.jpg)

$INFO[Window(Home).Property(TMDbHelper.ListItem.BlurImage)]
$INFO[Window(Home).Property(TMDbHelper.ListItem.BlurImage.Original)]
$INFO[Container(99950).ListItem.Art(blurimage)
$INFO[Container(99950).ListItem.Art(blurimage.original)

Original contains the unblurred image to allow syncing of image change with blur

Desaturate image. Usage is same as blur monitor. When using container method the output is added to ListItem.Art() instead.

Match colors of image. Usage is same as blur monitor. Outputs main colour of image and a complimentary triadic colour using a 120 degree hue shift. Luminance and Saturation values can be fixed to a floating point value between 0.0 and 1.0