Merge pull request #599 from rmrector/metadata.themoviedb.org.python@nexus

[metadata.themoviedb.org.python@nexus] 3.2.0

Author: rmrector

metadata.themoviedb.org.python/addon.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <addon id="metadata.themoviedb.org.python"
        name="The Movie Database Python"
-       version="3.1.3"
+       version="3.2.0"
        provider-name="Team Kodi">
   <requires>
     <import addon="xbmc.metadata" version="2.1.0"/>
@@ -11,11 +11,10 @@
              library="python/scraper.py"/>
   <extension point="xbmc.addon.metadata">
     <reuselanguageinvoker>true</reuselanguageinvoker>
-    <news>v3.1.3 (2025-10-12)
-- fix missing fanart from TMDB either way
-
-v3.1.2 (2025-10-05)
-- fix missing fanart from TMDB
+    <news>v3.2.0 (2026-03-08)
+- add option for keyart from TMDB
+- add whitelist option for "keywords as tags"
+- fix - don't save empty uniqueID values
 
 v3.0.0 (2024-04-17)
 - version 3 for Kodi 20 Nexus and above</news>
@@ -79,7 +78,7 @@ v3.0.0 (2024-04-17)
     <summary lang="uk_UA">Екстрактор даних про фільми з TMDb</summary>
     <summary lang="vi_VN">Trình lấy dữ liệu Phim từ TMDB</summary>
     <summary lang="zh_CN">TMDB 电影刮削器</summary>
-    <summary lang="zh_TW">TMDB 電影搜括器</summary>
+    <summary lang="zh_TW">TMDB 電影資料爬蟲</summary>
     <description lang="af_ZA">themoviedb.org is &apos;n verniet en oop fliek databasis. Dit is totaal gebruiker gedryf deur mense soos jy. TMDB word huidiglik deur miljoene mense elke maand gebruik, en met hulle kragtige API word dit ook deur baie gewilde media sentrums soos Kodi gebruik om Fliek Metadata, Plakkate en Ondersteunerkuns te onttrek om die gebruiker se ondervinding te verryk.</description>
     <description lang="be_BY">themoviedb.org - бясплатная і адкрытая база даных фільмаў. Яна напаўняецца і падтрымліваецца карыстальнікамі. TMDb штомесяц карыстаюцца мільёны людзей, а дзякуючы магутнаму API базу могуць выкарыстоўваць папулярныя медыяцэнтры накшталт Kodi, якія бяруць адтуль метаданыя, постары і ілюстрацыі.</description>
     <description lang="bg_BG">themoviedb.org е безплатна и отворена филмова база данни. Задвижва се изцяло от потребителите си, от хора като вас. Милиони хора по света всеки месец ползват TMDb. Благодарение на многофункционално API може да се ползва от най-различни и популярни медийни центрове като Kodi, които извличат метаданни, постери и фанарт за филми с цел за красивото оформяне на интерфейса.</description>

metadata.themoviedb.org.python/changelog.txt

@@ -1,3 +1,8 @@
+v3.2.0 (2026-03-08)
+- add option for keyart from TMDB
+- add whitelist option for "keywords as tags"
+- fix - don't save empty uniqueID values
+
 v3.1.3 (2025-10-12)
 - fix missing fanart from TMDB either way
 

metadata.themoviedb.org.python/python/lib/tmdbscraper/tmdb.py

@@ -136,7 +136,7 @@ def _assemble_details(self, movie, movie_fallback, collection, collection_fallba
             info['duration'] = movie['runtime'] * 60
 
         ratings = {'themoviedb': {'rating': float(movie['vote_average']), 'votes': int(movie['vote_count'])}}
-        uniqueids = {'tmdb': str(movie['id']), 'imdb': movie['imdb_id']}
+        uniqueids = _parse_uniqueids(movie)
         cast = [{
                 'name': actor['name'],
                 'role': actor['character'],
@@ -164,6 +164,12 @@ def _parse_media_id(title):
         return {'type': 'imdb', 'id':title[5:]}
     return None
 
+def _parse_uniqueids(movie):
+    uniqueids = {'tmdb': str(movie['id'])}
+    if movie.get('imdb_id'):
+        uniqueids['imdb'] = movie['imdb_id']
+    return uniqueids
+
 def _get_movie(mid, language=None, search=False):
     details = None if search else \
         'trailers,images,releases,casts,keywords' if language is not None else \
@@ -184,23 +190,28 @@ def _parse_artwork(movie, collection, urlbases, language):
     landscape = []
     logos = []
     fanart = []
+    keyart = []
 
     if 'images' in movie:
         posters = _build_image_list_with_fallback(movie['images']['posters'], urlbases, language)
         landscape = _build_image_list_with_fallback(movie['images']['backdrops'], urlbases, language)
         logos = _build_image_list_with_fallback(movie['images']['logos'], urlbases, language)
-        fanart = _build_fanart_list(movie['images']['backdrops'], urlbases)
+        fanart = _build_list_without_titles(movie['images']['backdrops'], urlbases)
+        keyart = _build_list_without_titles(movie['images']['posters'], urlbases)
 
     setposters = []
     setlandscape = []
     setfanart = []
+    setkeyart = []
     if collection and 'images' in collection:
         setposters = _build_image_list_with_fallback(collection['images']['posters'], urlbases, language)
         setlandscape = _build_image_list_with_fallback(collection['images']['backdrops'], urlbases, language)
-        setfanart = _build_fanart_list(collection['images']['backdrops'], urlbases)
+        setfanart = _build_list_without_titles(collection['images']['backdrops'], urlbases)
+        setkeyart = _build_list_without_titles(collection['images']['posters'], urlbases)
 
     return {'poster': posters, 'landscape': landscape, 'fanart': fanart,
-        'set.poster': setposters, 'set.landscape': setlandscape, 'set.fanart': setfanart, 'clearlogo': logos}
+        'set.poster': setposters, 'set.landscape': setlandscape, 'set.fanart': setfanart,
+        'clearlogo': logos, 'keyart': keyart, 'set.keyart': setkeyart}
 
 def _build_image_list_with_fallback(imagelist, urlbases, language, language_fallback='en'):
     images = _build_image_list(imagelist, urlbases, [language])
@@ -215,7 +226,7 @@ def _build_image_list_with_fallback(imagelist, urlbases, language, language_fall
 
     return images
 
-def _build_fanart_list(imagelist, urlbases):
+def _build_list_without_titles(imagelist, urlbases):
     return _build_image_list(imagelist, urlbases, ['xx', None])
 
 def _build_image_list(imagelist, urlbases, languages=[]):

metadata.themoviedb.org.python/python/scraper_config.py

@@ -12,7 +12,8 @@ def configure_tmdb_artwork(details, settings):
         return details
 
     art = details['available_art']
-    if not settings.getSettingBool('fetch_posters'):
+    posters_enabled = settings.getSettingBool('fetch_posters')
+    if not posters_enabled:
         if 'poster' in art:
             del art['poster']
         if 'set.poster' in art:
@@ -32,6 +33,15 @@ def configure_tmdb_artwork(details, settings):
             if fanart_enabled:
                 art['set.fanart'] = art.get('set.fanart', []) + art['set.landscape']
             del art['set.landscape']
+    if not settings.getSettingBool('keyart'):
+        if 'keyart' in art:
+            if posters_enabled:
+                art['poster'] = art.get('poster', []) + art['keyart']
+            del art['keyart']
+        if 'set.keyart' in art:
+            if posters_enabled:
+                art['set.poster'] = art.get('set.poster', []) + art['set.keyart']
+            del art['set.keyart']
 
     return details
 
@@ -75,6 +85,9 @@ def _configure_default_rating(details, settings):
 def _configure_tags(details, settings):
     if not settings.getSettingBool('add_tags'):
         del details['info']['tag']
+    elif settings.getSettingBool('enable_tag_whitelist'):
+        whitelist = set(tag.strip().lower() for tag in settings.getStringList('tag_whitelist'))
+        details['info']['tag'] = [tag for tag in details['info']['tag'] if tag.lower() in whitelist]
     return details
 
 # pylint: disable=invalid-name
@@ -102,6 +115,9 @@ def getSettingNumber(self, id):
     def getSettingString(self, id):
         return self._inner_get_setting(id, basestring, '')
 
+    def getStringList(self, id):
+        return self._inner_get_setting(id, list, [])
+
     def _inner_get_setting(self, setting_id, setting_type, default):
         value = self.data.get(setting_id)
         if isinstance(value, setting_type):

metadata.themoviedb.org.python/resources/language/resource.language.af_za/strings.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: XBMC Addons\n"
-"Report-Msgid-Bugs-To: translations@kodi.tv\n"
+"Report-Msgid-Bugs-To: alanwww1@xbmc.org\n"
 "POT-Creation-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "PO-Revision-Date: 2025-01-07 23:55+0000\n"
 "Last-Translator: Heiko Berner <berner.h@gmail.com>\n"
@@ -89,6 +89,14 @@ msgctxt "#30015"
 msgid "Maximum number of each artwork type - many artwork can cause an error scraping to MySQL database"
 msgstr "Maksimum hoeveelheid van elke kunswerk tipe - baie kunswerke kan 'n fout veroorsaak wanneer na MySQL databasis skraap"
 
+msgctxt "#30016"
+msgid "Only add whitelisted keywords as tags"
+msgstr ""
+
+msgctxt "#30017"
+msgid "Tag whitelist"
+msgstr ""
+
 msgctxt "#30100"
 msgid "Language for Fanart.tv artwork"
 msgstr "Taal vir Fanart.tv kunswerke"

metadata.themoviedb.org.python/resources/language/resource.language.am_et/strings.po

@@ -89,6 +89,14 @@ msgctxt "#30015"
 msgid "Maximum number of each artwork type - many artwork can cause an error scraping to MySQL database"
 msgstr ""
 
+msgctxt "#30016"
+msgid "Only add whitelisted keywords as tags"
+msgstr ""
+
+msgctxt "#30017"
+msgid "Tag whitelist"
+msgstr ""
+
 msgctxt "#30100"
 msgid "Language for Fanart.tv artwork"
 msgstr ""

metadata.themoviedb.org.python/resources/language/resource.language.ar_sa/strings.po

@@ -88,6 +88,14 @@ msgctxt "#30015"
 msgid "Maximum number of each artwork type - many artwork can cause an error scraping to MySQL database"
 msgstr ""
 
+msgctxt "#30016"
+msgid "Only add whitelisted keywords as tags"
+msgstr ""
+
+msgctxt "#30017"
+msgid "Tag whitelist"
+msgstr ""
+
 msgctxt "#30100"
 msgid "Language for Fanart.tv artwork"
 msgstr ""

metadata.themoviedb.org.python/resources/language/resource.language.ast_es/strings.po

@@ -89,6 +89,14 @@ msgctxt "#30015"
 msgid "Maximum number of each artwork type - many artwork can cause an error scraping to MySQL database"
 msgstr ""
 
+msgctxt "#30016"
+msgid "Only add whitelisted keywords as tags"
+msgstr ""
+
+msgctxt "#30017"
+msgid "Tag whitelist"
+msgstr ""
+
 msgctxt "#30100"
 msgid "Language for Fanart.tv artwork"
 msgstr ""

metadata.themoviedb.org.python/resources/language/resource.language.az_az/strings.po

@@ -88,6 +88,14 @@ msgctxt "#30015"
 msgid "Maximum number of each artwork type - many artwork can cause an error scraping to MySQL database"
 msgstr ""
 
+msgctxt "#30016"
+msgid "Only add whitelisted keywords as tags"
+msgstr ""
+
+msgctxt "#30017"
+msgid "Tag whitelist"
+msgstr ""
+
 msgctxt "#30100"
 msgid "Language for Fanart.tv artwork"
 msgstr ""

metadata.themoviedb.org.python/resources/language/resource.language.be_by/strings.po

@@ -89,6 +89,14 @@ msgctxt "#30015"
 msgid "Maximum number of each artwork type - many artwork can cause an error scraping to MySQL database"
 msgstr ""
 
+msgctxt "#30016"
+msgid "Only add whitelisted keywords as tags"
+msgstr ""
+
+msgctxt "#30017"
+msgid "Tag whitelist"
+msgstr ""
+
 msgctxt "#30100"
 msgid "Language for Fanart.tv artwork"
 msgstr "Мова для ілюстрацый з Fanart.tv"