TVDB4 Mapping raises an error & Metadata won't download

[vveerar1]

Platform

Operating system and version: LinuxServer Docker - UnRaid
Plex version: 1.43.0.10492

Current Behavior

One Piece

One Piece (1999) {tvdb4-81797}

2026-03-09 09:54:35,682 - 1508c3552b38 - Handling request GET /:/plugins/com.plexapp.agents.hama/messaging/function/X0FnZW50S2l0OlVwZGF0ZU1ldGFkYXRh/Y2VyZWFsMQoxCmxpc3QKMApyMAo_/Y2VyZWFsMQoxCmRpY3QKMTAKczIKZW5zNApsYW5nYjFzNQpmb3JjZWIwczgKcGVyaW9kaWNzNgo2NjM5NjdzNApkYmlkaTAKczcKdmVyc2lvbm5zMTAKcGFyZW50R1VJRG5zOApwYXJlbnRJRHM3ClRWX1Nob3dzMTAKbWVkaWFfdHlwZXM0NQpjb20ucGxleGFwcC5hZ2VudHMuaGFtYTovL3R2ZGI0LTgxNzk3P2xhbmc9ZW5zNApndWlkczExCnR2ZGI0LTgxNzk3czIKaWRyMAo_
2026-03-09 09:54:35,683 - 1508c3552b38 - Received packed state data (576 bytes)
2026-03-09 09:54:35,684 - 1508c3552b38 - Found route matching /:/plugins/com.plexapp.agents.hama/messaging/function/X0FnZW50S2l0OlVwZGF0ZU1ldGFkYXRh/Y2VyZWFsMQoxCmxpc3QKMApyMAo_/Y2VyZWFsMQoxCmRpY3QKMTAKczIKZW5zNApsYW5nYjFzNQpmb3JjZWIwczgKcGVyaW9kaWNzNgo2NjM5NjdzNApkYmlkaTAKczcKdmVyc2lvbm5zMTAKcGFyZW50R1VJRG5zOApwYXJlbnRJRHM3ClRWX1Nob3dzMTAKbWVkaWFfdHlwZXM0NQpjb20ucGxleGFwcC5hZ2VudHMuaGFtYTovL3R2ZGI0LTgxNzk3P2xhbmc9ZW5zNApndWlkczExCnR2ZGI0LTgxNzk3czIKaWRyMAo_
2026-03-09 09:54:35,685 - 1508c3552b38 - Loading model with GUID com.plexapp.agents.hama://tvdb4-81797?lang=en
2026-03-09 09:54:35,688 - 1508c3552b38 - Deserializing from /config/Library/Application Support/Plex Media Server/Metadata/TV Shows/7/de80d634d086714ab76d52c860b99df55eda062.bundle/Contents/com.plexapp.agents.hama/Info.xml
2026-03-09 09:54:35,696 - 1508c3552b38 - Requesting 'http://127.0.0.1:32400/library/metadata/663967/tree'
2026-03-09 09:54:45,351 - 1508c3552b38 - ==== common.PlexLog(file="/config/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime/One Piece (1999) {tvdb4-81797}.agent-update.log")
2026-03-09 09:54:45,364 - 1508c3552b38 - Exception in the update function of agent named 'HamaTV', called with guid 'com.plexapp.agents.hama://tvdb4-81797?lang=en' (most recent call last):
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-121068a07/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/api/agentkit.py", line 1093, in _update
    agent.update(obj, media, lang, **kwargs)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/__init__.py", line 166, in update
    def update (self, metadata, media, lang, force ):  Update (metadata, media, lang, force,  False)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/__init__.py", line 138, in Update
    dict_AnimeLists, AniDBid, TVDBid, TMDbid, IMDbid, mappingList =  AnimeLists.GetMetadata(media, movie, error_log, metadata.id)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/AnimeLists.py", line 182, in GetMetadata
    Log.Info('"anime-list TVDBid missing.htm" log added as tvdb serie id missing in mapping file: "{}"'.format("None" if TVDBid is None else TVDBid))
TypeError: cannot concatenate 'str' and 'NoneType' objects

2026-03-09 09:54:45,373 - 1508c3552b38 - Serializing to /config/Library/Application Support/Plex Media Server/Metadata/TV Shows/7/de80d634d086714ab76d52c860b99df55eda062.bundle/Contents/com.plexapp.agents.hama/Info.xml
2026-03-09 09:54:45,397 - 1508c3552b38 - Sending packed state data (600 bytes)
2026-03-09 09:54:45,398 - 1508c3552b38 - Response: [200] str, 16 bytes

One Piece (1999) {tvdb4-81797}.agent-update

=============================================================================================================================================================
common.PlexLog(file="/config/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime/One Piece (1999) {tvdb4-81797}.agent-update.log", movie=False)
[!] file:       "/data/Anime/One Piece (1999) {tvdb4-81797}/One Piece (1999) - E883 - One Step Ahead of the Dream - Shirahoshi's Path to the Sun! - [Bluray-1080p][10bit][x265][AAC 2.0][EN+JA]-Anime Time.mkv"
[ ] library:    "Anime"
[ ] root:       "/data/Anime"
[ ] path:       "One Piece (1999) {tvdb4-81797}"
[ ] Plex root:  "/config/Library/Application Support/Plex Media Server"
[ ] Log folder: "Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime"
[ ] Log file:   "One Piece (1999) {tvdb4-81797}.agent-update.log"
[ ] Logger:     "0x1508c3552b38"
[ ] mode:       "w"
=== Update() ================================================================================================================================================
id: tvdb4-81797, title: None, lang: en, force: True, movie: False
start: 2026-03-09 09:54:45,354248
=== AnimeLists.GetMetadata() ================================================================================================================================
tvdb_numbering: True
Local custom mapping file not present: anime-list-custom.xml
--- AniDBTVDBMap --------------------------------------------------------------------------------------------------------------------------------------------
[+] AniDBid:    69, TVDBid:  81797, defaulttvdbseason: (a)1, offset:   0, TMDBid:        , IMDBid:           , name: One Piece
    - season: [ 0],           [ 0], range:       [000-000], offset:   0, text: 1-27;2-3;3-9;4-10;5-14;6-0;7-0;8-0;9-0;10-0;11-0;12-0;13-0;14-0;15-0;16-31;17-23;18-24;19-28;20-29;21-30;22-0;23-32;24-34;25-0;26-36;27-37;28-40;29-41;30-42;31-43;32-44;33-45;34-47;35-48;36-49;37-50;38-51;39-52;40-53;41-54;42-55;43-56;44-57
    - season: [ 1],           [None], range:       [  1- 61], offset:   0, text: 

Naruto- Shippûden

Naruto- Shippûden (2007) {tvdb4-79824}

2026-03-09 10:42:24,499 - 154248d90b38 - ==== common.PlexLog(file="/config/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime/Naruto- Shippûden (2007) {tvdb4-79824}.agent-update.log")
2026-03-09 10:42:24,535 - 154248d90b38 - Exception in the update function of agent named 'HamaTV', called with guid 'com.plexapp.agents.hama://tvdb4-79824?lang=en' (most recent call last):
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-121068a07/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/api/agentkit.py", line 1093, in _update
    agent.update(obj, media, lang, **kwargs)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/__init__.py", line 166, in update
    def update (self, metadata, media, lang, force ):  Update (metadata, media, lang, force,  False)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/__init__.py", line 138, in Update
    dict_AnimeLists, AniDBid, TVDBid, TMDbid, IMDbid, mappingList =  AnimeLists.GetMetadata(media, movie, error_log, metadata.id)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/AnimeLists.py", line 182, in GetMetadata
    Log.Info('"anime-list TVDBid missing.htm" log added as tvdb serie id missing in mapping file: "{}"'.format("None" if TVDBid is None else TVDBid))
TypeError: cannot concatenate 'str' and 'NoneType' objects

2026-03-09 10:42:24,543 - 154248d90b38 - Serializing to /config/Library/Application Support/Plex Media Server/Metadata/TV Shows/5/d2cde59110f0c1e83d663af89bb6ce1f69d70a5.bundle/Contents/com.plexapp.agents.hama/Info.xml
2026-03-09 10:42:24,558 - 154248d90b38 - Sending packed state data (104 bytes)
2026-03-09 10:42:24,558 - 154248d90b38 - Response: [200] str, 16 bytes

Naruto- Shippûden (2007) {tvdb4-79824}.agent-update.log

=============================================================================================================================================================
common.PlexLog(file="/config/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime/Naruto- Shippûden (2007) {tvdb4-79824}.agent-update.log", movie=False)
[!] file:       "/data/Anime/Naruto- Shippûden (2007) {tvdb4-79824}/Naruto Shippuden (2007) - E235 - The Kunoichi Of Nadeshiko Village - [Bluray-1080p][8bit][x264][FLAC 2.0][JA+EN].mkv"
[ ] library:    "Anime"
[ ] root:       "/data/Anime"
[ ] path:       "Naruto- Shippûden (2007) {tvdb4-79824}"
[ ] Plex root:  "/config/Library/Application Support/Plex Media Server"
[ ] Log folder: "Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime"
[ ] Log file:   "Naruto- Shippûden (2007) {tvdb4-79824}.agent-update.log"
[ ] Logger:     "0x154248d90b38"
[ ] mode:       "w"
=== Update() ================================================================================================================================================
id: tvdb4-79824, title: None, lang: en, force: True, movie: False
start: 2026-03-09 10:42:24,502107
=== AnimeLists.GetMetadata() ================================================================================================================================
tvdb_numbering: True
Local custom mapping file not present: anime-list-custom.xml
--- AniDBTVDBMap --------------------------------------------------------------------------------------------------------------------------------------------
[+] AniDBid:  4880, TVDBid:  79824, defaulttvdbseason: (a)1, offset:   0, TMDBid:        , IMDBid:           , name: Naruto Shippuuden
    - season: [ 0],           [ 0], range:       [000-000], offset:   0, text: 1-0
    - season: [ 1],           [None], range:       [197-221], offset: -196, text: 

[ZeroQI]

in theory to resolve, one must replace
"TVDBid: " + TVDBid
with

"TVDBid: %s" % TVDBid
# OR
"TVDBid: {}".format(TVDBid)

trying to locate involved code, is not at designated line so tricky

[vveerar1]

Thank you for your response..

Here are the changes made based on your recommendation that fixed the

TypeError: cannot concatenate 'str' and 'NoneType' objects

Hama.bundle/Contents/Code/common.py

Lines 508 to 510 in 81f72eb

	if not log in ["Missing Episodes", "Missing Specials"]: keys = ["AniDBid: "+AniDBid, "AniDBid: "+WEB_LINK % (ANIDB_SERIE_URL + AniDBid, AniDBid), "TVDBid: "+ TVDBid, "TVDBid: "+WEB_LINK % (TVDB_SERIE_URL + TVDBid, TVDBid)]
	elif not movie and (len(media.seasons)>2 or max(map(int, media.seasons.keys()))>1): keys = ["TVDBid: %s" % (WEB_LINK % (TVDB_SERIE_URL + TVDBid, TVDBid) )]
	else: keys = ["%s: %s" % (source, WEB_LINK % (ANIDB_SERIE_URL + AniDBid if source == "AniDBid" else TVDB_SERIE_URL + TVDBid, AniDBid if source == "AniDBid" else TVDBid) )]

    if not log in ["Missing Episodes", "Missing Specials"]:                              keys = ["AniDBid: %s" % AniDBid, "AniDBid: %s" % (WEB_LINK % (ANIDB_SERIE_URL + str(AniDBid), AniDBid)), "TVDBid: %s" % TVDBid, "TVDBid: %s" % (WEB_LINK % (TVDB_SERIE_URL + str(TVDBid), TVDBid))]
    elif not movie and (len(media.seasons)>2 or max(map(int, media.seasons.keys()))>1):  keys = ["TVDBid: %s"  % (WEB_LINK % (TVDB_SERIE_URL + str(TVDBid),  TVDBid) )]
    else:                                                                                keys = ["%s: %s" % (source, WEB_LINK % (ANIDB_SERIE_URL + str(AniDBid) if source == "AniDBid" else TVDB_SERIE_URL + str(TVDBid), AniDBid if source == "AniDBid" else TVDBid))]

Hama.bundle/Contents/Code/AnimeLists.py

Lines 163 to 164 in 81f72eb

	if not Dict(mappingList, 'TVDB', 's'+tvdbseason+'e'+str(ep+int(offset))):
	SaveDict((anidbseason, str(ep), AniDBid), mappingList, 'TVDB', 's'+tvdbseason+'e'+str(ep+int(offset)) ) #mappingList['TVDB'][s1e1]=(AniDB_season, AniDB_episode, AniDBid) for start-end mappings

          if not Dict(mappingList, 'TVDB', 's'+str(tvdbseason)+'e'+str(ep+int(offset))):
            SaveDict((anidbseason, str(ep),          AniDBid), mappingList, 'TVDB', 's'+str(tvdbseason)+'e'+str(ep+int(offset)) ) #mappingList['TVDB'][s1e1]=(AniDB_season, AniDB_episode, AniDBid) for start-end mappings

Hama.bundle/Contents/Code/AnimeLists.py

Lines 169 to 170 in 81f72eb

	elif not Dict(mappingList, 'TVDB', 's'+tvdbseason+'e'+ep.split('-')[1]):
	SaveDict((anidbseason, ep.split('-')[0], AniDBid), mappingList, 'TVDB', 's'+tvdbseason+'e'+ep.split('-')[1]) #mappingList['TVDB'][s1e1]=(AniDB_season, AniDB_episode, AniDBid) for manual mapping like '1-12'

          elif not Dict(mappingList, 'TVDB', 's'+str(tvdbseason)+'e'+ep.split('-')[1]):
            SaveDict((anidbseason, ep.split('-')[0], AniDBid), mappingList, 'TVDB', 's'+str(tvdbseason)+'e'+ep.split('-')[1])     #mappingList['TVDB'][s1e1]=(AniDB_season, AniDB_episode, AniDBid) for manual mapping like '1-12'

Hama.bundle/Contents/Code/AnimeLists.py

Lines 174 to 175 in 81f72eb

	if int(Dict(mappingList, 'season_map', AniDBid, 'max')) < int(season.get("tvdbseason")):
	SaveDict(season.get("tvdbseason"), mappingList, 'season_map', AniDBid, 'max') # Update the max season to the largest 'tvdbseason' season seen in 'mapping-list'

        tvdb_season_val = season.get("tvdbseason")
        max_season_val = Dict(mappingList, 'season_map', AniDBid, 'max')
        if tvdb_season_val is not None and str(tvdb_season_val).isdigit() and str(max_season_val).isdigit():
          if int(max_season_val) < int(tvdb_season_val):
            SaveDict(tvdb_season_val, mappingList, 'season_map', AniDBid, 'max')  # Update the max season to the largest 'tvdbseason' season seen in 'mapping-list'

However, after that it threw me

ValueError: too many values to unpack

2026-03-12 10:35:44,201 - 1484260d0b38 - Serializing to /config/Library/Application Support/Plex Media Server/Metadata/TV Shows/7/de80d634d086714ab76d52c860b99df55eda062.bundle/Contents/com.plexapp.agents.hama/Info.xml
2026-03-12 10:35:44,213 - 1484260d0b38 - Sending packed state data (104 bytes)
2026-03-12 10:35:44,213 - 1484260d0b38 - Response: [200] str, 16 bytes
2026-03-12 10:38:46,382 - 1515373deb38 - ==== common.PlexLog(file="/config/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/Anime/One Piece (1999) {tvdb4-81797}.agent-update.log")
2026-03-12 10:38:47,006 - 1515373deb38 - Requesting 'https://api.thetvdb.com/login'
2026-03-12 10:38:47,266 - 1515373deb38 - TheTVDBv2.LoadFileTVDB() - URL https://api.thetvdb.com/login, headers: {'Content-type': 'application/json', 'Accept-Language': 'en', 'User-agent': 'Plex/HAMA'}
2026-03-12 10:38:51,176 - 1515373deb38 - Exception in the update function of agent named 'HamaTV', called with guid 'com.plexapp.agents.hama://tvdb4-81797?lang=en' (most recent call last):
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-121068a07/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/api/agentkit.py", line 1093, in _update
    agent.update(obj, media, lang, **kwargs)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/__init__.py", line 166, in update
    def update (self, metadata, media, lang, force ):  Update (metadata, media, lang, force,  False)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/__init__.py", line 141, in Update
    dict_AniDB, ANNid, MALids                                     =       AniDB.GetMetadata(media, movie, error_log,       source, AniDBid, TVDBid, AnimeLists.AniDBMovieSets, mappingList)
  File "/config/Library/Application Support/Plex Media Server/Plug-ins/Hama.bundle/Contents/Code/AniDB.py", line 315, in GetMetadata
    elif epNumType in ['1', '2']:   SaveDict([episode],   missing,         season)
ValueError: too many values to unpack

2026-03-12 10:38:51,185 - 1515373deb38 - Serializing to /config/Library/Application Support/Plex Media Server/Metadata/TV Shows/7/de80d634d086714ab76d52c860b99df55eda062.bundle/Contents/com.plexapp.agents.hama/Info.xml
2026-03-12 10:38:51,256 - 1515373deb38 - Sending packed state data (104 bytes)
2026-03-12 10:38:51,257 - 1515373deb38 - Response: [200] str, 16 bytes

To fix that the following changes were made

Hama.bundle/Contents/Code/AniDB.py

Line 265 in 81f72eb

title, main, language_rank = GetAniDBTitle (ep_obj.xpath('title'), [language.strip() for language in Prefs['EpisodeLanguagePriority'].split(',')])

          ani_titles = GetAniDBTitle (ep_obj.xpath('title'), [language.strip() for language in Prefs['EpisodeLanguagePriority'].split(',')])
          title, main, language_rank = ani_titles[0], ani_titles[1], ani_titles[2]

Hama.bundle/Contents/Code/AniDB.py

Line 278 in 81f72eb

season, episode = AnimeLists.tvdb_ep(mappingList, season, episode, AniDBid)

            mapped_ep = AnimeLists.tvdb_ep(mappingList, season, episode, AniDBid)
            season, episode = mapped_ep[0], mapped_ep[1]

[RainOne]

So I applied those changes and the log now says that it does find the show and pulls the description, name, episodes and background images, but none of it is applied on the Plex side? I already did the "dance", moved folders, cleaned the library cache and everything, but the show is still not updated on Plex side. What could be wrong?

Edit: Something's amiss, i'm getting the error from another issue regarding Python files being screwy:

2026-05-04 23:35:47,412 (14606f1b3808) :  CRITICAL (runtime:1299) - Exception getting hosted resource hashes (most recent call last):
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-563d026ea/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/components/runtime.py", line 1293, in get_resource_hashes
    json = self._core.networking.http_request("http://127.0.0.1:32400/:/plugins/com.plexapp.system/resourceHashes", timeout=10).content
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-563d026ea/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/components/networking.py", line 243, in content
    return self.__str__()
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-563d026ea/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/components/networking.py", line 221, in __str__
    self.load()
  File "/usr/lib/plexmediaserver/Resources/Plug-ins-563d026ea/Framework.bundle/Contents/Resources/Versions/2/Python/Framework/components/networking.py", line 159, in load
    f = self._opener.open(req, timeout=self._timeout)
  File "/usr/lib/plexmediaserver/Resources/Python/python27.zip/urllib2.py", line 435, in open
    response = meth(req, response)
  File "/usr/lib/plexmediaserver/Resources/Python/python27.zip/urllib2.py", line 548, in http_response
    'http', request, response, code, msg, hdrs)
  File "/usr/lib/plexmediaserver/Resources/Python/python27.zip/urllib2.py", line 473, in error
    return self._call_chain(*args)
  File "/usr/lib/plexmediaserver/Resources/Python/python27.zip/urllib2.py", line 407, in _call_chain
    result = func(*args)
  File "/usr/lib/plexmediaserver/Resources/Python/python27.zip/urllib2.py", line 556, in http_error_default
    raise HTTPError(req.get_full_url(), code, msg, hdrs, fp)
HTTPError: HTTP Error 404: Not Found

I'll just re-install hama, re-edit the files and report back.

[RainOne]

A little background: I've always used Hama with forced TheTVDB series ids to index tokusatsu tv shows - It allows me to keep Movies and Shows in the same category and it has always worked fine. Recently, new shows weren't being picked up. Found this issue about the .py scripts and decided to fix it today.

• Hama re-installed, files manually edited.
• "Fix Match" finds the proper TV Show (Kamen Ridzer Zeztz).
• hama .agent-searcha and .agent-update find the show and list all of the information (show name, show description, episodes, titles, descriptions, banners, backgrounds, everything works).
• "Plex Media Scanner.log" and "Plex Media Server.log" not showing any errors.

Don't really know where else to look for any log error messages on why Hama stuff is not being applied. HamaTV and HamaMovies are at the top of the agent priorities and the library is set for ASS and Hama. Here are the logs - what other logs should I look for?

Kamen Rider ZEZTZ [tvdb-465550].agent-search.log
Kamen Rider ZEZTZ [tvdb-465550].agent-update.log