ListItem Helper (Kodi 19+20)

A ListItem Helper service

Description

A ListItem Helper service which provides values from OMDb/TMDb/MDBList and your Kodi database. ! Entering OMDb/TMDb/MDBList API keys in the configuration dialog is required. Property names (home): ListItemHelper.rating.rottentomatoes.percent ListItemHelper.rating.rottentomatoes.image ListItemHelper.rating.rottentomatoes.url ListItemHelper.rating.rottentomatoes.audience ListItemHelper.rating.metacritic.percent ListItemHelper.rating.imdb.percent ListItemHelper.rating.imdb ListItemHelper.rating.imdb.votes ListItemHelper.rating.letterboxd ListItemHelper.rating.letterboxd.percent ListItemHelper.rating.letterboxd.votes ListItemHelper.rating.trakt ListItemHelper.rating.trakt.percent ListItemHelper.rating.trakt.votes ListItemHelper.rating.highestScaleTo5 ListItemHelper.rating.highestScaleTo10 ListItemHelper.rating.highestScaleTo100 ListItemHelper.awards ListItemHelper.budget ListItemHelper.budget.million ListItemHelper.budget.formatted ListItemHelper.revenue ListItemHelper.revenue.million ListItemHelper.revenue.formatted ListItemHelper.revenue.boxoffice ListItemHelper.DBID ListItemHelper.IMDBNumber ListItemHelper.IMDBNumber.isValid ListItemHelper.IMDBNumber.corrected ListItemHelper.IMDBNumber.corrected.isValid ListItemHelper.TMDBID ListItemHelper.TVDBID ListItemHelper.ageRating.commonsense ListItemHelper.studio.1 (up to .50) ListItemHelper.genre.1 (up to .50) ListItemHelper.writer.1 (up to .50) ListItemHelper.director.1 (up to .50) Local ratings from Kodi database: ListItemHelper.listitem.rating.tomatometerallcritics ListItemHelper.listitem.rating.tomatometerallcritics.scaleTo100 ListItemHelper.listitem.votes.tomatometerallcritics ListItemHelper.listitem.rating.rottentomatoes ListItemHelper.listitem.rating.rottentomatoes.scaleTo100 ListItemHelper.listitem.votes.rottentomatoes ListItemHelper.listitem.rating.tomatometerallaudience ListItemHelper.listitem.rating.tomatometerallaudience.scaleTo100 ListItemHelper.listitem.votes.tomatometerallaudience ListItemHelper.listitem.rating.metacritic ListItemHelper.listitem.rating.metacritic.scaleTo100 ListItemHelper.listitem.votes.metacritic ListItemHelper.listitem.rating.metascore ListItemHelper.listitem.rating.metascore.scaleTo100 ListItemHelper.listitem.votes.metascore ListItemHelper.listitem.rating.imdb ListItemHelper.listitem.rating.imdb.scaleTo100 ListItemHelper.listitem.votes.imdb For use with other containers like home screen widgets set the following properties when the container is focused: (home) ListItemHelper.WidgetContainerId to the container ID (Example: 8000) (home) ListItemHelper.WidgetContainerWindowName to the window name where the container resides (Example: home) Important remarks: - Unset the WidgetContainer-properties when leaving focus from the container/widget. This project may still contain elements of the following projects: - script.toolbox (by phil65) - script.module.metadatautils (by marcelveldt and others) - script.embuary.helper (by sualfred) which have been either replaced, rewritten, expanded, changed and/or massively stripped down for fast execution and minimal functionality. Many thanks to the contributors of the listed projects and all users providing valuable feedback.

News

1.4.3 (2023-11-07) - Added "suppressException" option for get_json (get_xml already had this added in a previous update) - Improved exception handling for time outs and similar status - Slightly updated settings window language strings (visual font changes) 0.4.2 (2023-10-12) - Added API support for MDBList - Added support for local ratings from the Kodi database and new properties - Minor performance improvements and optimizations Clean up: - Removed some Python 2 code (now using code which is compatible with both 2 and 3) 1.4.1 (2023-09-23) Version in sync with "A Confluence ZEITGEIST" 3.6.11 (4.6.11, 5.6.11) - Added support and expanded functionality for local ratings ListItem.Rating(xxx) - Added ListItemHelper.rating.highestScaleTo5 and highestScaleTo100 1.4.0 (2023-08-16) Version in sync for major rework of "A Confluence ZEITGEIST" 3.6.0 (Version numbers vary on other Kodi generations) - Code and performance optimizations (shorter cache values, optimized retry-handling, fixed file loading for python 3 addon variant) - Language strings changed - Minor code improvement for settings.xml - New addon icon 1.3.15 (2022-12-24) - Added functionality for new Skin setting "Use highest score for stars rating (*****)" - Added new setting "videolibrary.itemseparator" needed for value splitting if user has set a custom separator via advancedsettings.xml - Added ListItem.studio splitting support - Added ListItem.genre splitting support - Added ListItem.director splitting support - Added ListItem.writer splitting support New properties: (home) ListItemHelper.rating.highestScaleTo10 (home) ListItemHelper.studio.X (X=index no, starting at 1) (home) ListItemHelper.genre.X (X=index no, starting at 1) (home) ListItemHelper.director.X (X=index no, starting at 1) (home) ListItemHelper.writer.X (X=index no, starting at 1) 1.3.14 (2022-12-12) - Changed settings.xml format and added language strings 1.3.13 (2022-12-12) - Improved Addon settings: Added descriptive text and new debug tab+option "Clear image cache" - Added functionality to force generation of blurimg image even if it exists in the cache (important when image changes in certain situations) 1.3.12 (2022-12-05) - Added property (home) ListItemHelper.IMDBNumber.isValid - Added property (home) ListItemHelper.IMDBNumber.corrected - Added property (home) ListItemHelper.IMDBNumber.corrected.isValid - Added property (home) ListItemHelper.TMDBID - Added property (home) ListItemHelper.TVDBID - Changed addon settings dialog tab name to "API keys" - Improved data validation - Expanded Python 2/3 dual code base 1.3.11 (2022-12-05) - Change addon.xml so that the addon is visibly placed into the "Services" category of the KODI addon manager and the repo - - Note: In addon.xml, extension point="xbmc.service" tag has to be placed _above_ extension point="xbmc.python.script" tag for this to happen 1.3.10 (2022-12-04) - Added KODI 19+20 (Python 3) compatibility code basis (Dual-addon: Python 2 still supported) - - Python 2/3 versions still need separate addon version due to required addon.xml changes - - Using unified code basis still makes things much easier - - Exception: lib/img/*.py scripts are Python 3 only 0.3.10 (2022-12-04) ...

Direct installation

Via Repository

Via Directory

1. Download the addon.
2. Open up Kodi and navigate into Add-ons.
   
3. Click the open box icon (above the side-menu).
   
4. Select Install from zip file.
   • If this is the first addon you install, Kodi will warn you about installing addons from "unknown sources" for security reasons - it's your call.
   • In any case, Kodi will warn you, you may not get auto-updates for this addon.
5. Navigate into the location where you've downloaded the addon to and select it to Install.

1. First make sure you have the repository installed
2. Open up Kodi and navigate into Add-ons.
   
3. Click the open box icon (above the side-menu).
   
4. Select Install from repository.
   • If you have at least one repository (besides the default) installed:
     Select the repository you wish to install from.
5. Select the category the addon belongs to, in this case it should be service.
6. Select ListItem Helper (Kodi 19+20).
7. Click Install.