ListItem Helper (Kodi 19+20)

ListItem Helper (Kodi 19+20)

Help other people decide, vote up or down?

A ListItem Helper service


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.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 (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 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.


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 splitting support - Added ListItem.genre splitting support - Added ListItem.director splitting support - Added ListItem.writer splitting support New properties: (home) ListItemHelper.rating.highestScaleTo10 (home) (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) ...

View More

How To Install

Direct installation

Via Repository

Via Directory

  1. Download the addon.
  2. Open up Kodi and navigate into Add-ons.
    addon install - Add-ons
  3. Click the open box icon (above the side-menu).
    addon install - openbox
  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.
Installing via directory means you connect to a Web server directly using Kodi.
It also means that the addon is found under a repositry or a sub-repository you install from that directory (check out which repositories host ListItem Helper (Kodi 19+20) addon below).
  1. Open up Kodi and navigate into the System settings screen by selecting the cogwheel button (above the side-menu inside Kodi's home-screen).
  2. Select File manager.
    addon install - Kodi file manager
  3. Select Add source from the left pane (the right pane is in case you want to move files from one folder to another, if you're using a mouse you may need to double click it).
  4. Click the line where it says <None> and enter the following url:
    Note: some servers may be case-sensitive.
    addon install - Add new source
    click OK after you are done typing.
  5. Below that, if there isn't already, enter a name for the source which will be easy for you to recognize in the future. Click OK
  6. Now press the return button twice to return to home-screen.
    Navigate into Add-ons.
    addon install - Add-ons
  7. Click the open box icon (above the side-menu).
    addon install - openbox
  8. 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.
  9. Look for the name of the source as it was entered in step 5, select the repository zip file you see inside it.
    That's it. The rest of the instructions are as detailed in installing Via Repository, use the repository you've just installed.

For a full installation guide please click here.

Additional Information

Updated:November 08, 2023

In Repositories:


Alternative Sources:

Download 1Download 2Download 3Download 4Download 5Download 6Download 7Download 8Download 9Download 10Download 11Download 12Download 13Download 14Download 15Download 16Download 17

Depends On:

Recommended Addons