Absolute Series Scanner (for anime mainly)

Tried the updated beta scanner. Doesnt seem to help with the addition of new series. Here is the log:
ufile.io/fkvcp

Traceback (most recent call last):
File “/media/sdaf/pioneer782/Library/Application Support/Plex Media Server/Scanners/Series/Absolute Series Scanner.py”, line 608, in Scan
for item in misc_words: filename = filename.lower().replace(item, ’ ', 1)
UnboundLocalError: local variable ‘misc_words’ referenced before assignment

Still a scanner crash, corrected and uploaded new version, shouldn’t be any left now.
Impacted only people with files in root folder
Thanks for reporting, it could impact anybody with files at root, preventing added files addition into Plex


Here is the log of the updated version: https://files.fm/u/xcr2z9f3
Seems it does add new folders, but it is random. Also some of the series doesnt get added to the library for some reason. New shows also seems to have issue being recognized, for example, High School DxD Hero and Hinamatsuri

Traceback (most recent call last):
File “/media/sdaf/pioneer782/Library/Application Support/Plex Media Server/Scanners/Series/Absolute Series Scanner.py”, line 677, in Scan
add_episode_into_plex(media, file, root, path, show if path else title, 0, counter, title, year, counter, “”, length)
UnboundLocalError: local variable ‘length’ referenced before assignment

still an error, corrected it, uploaded new version.
Once all errors are gone, i promise it will work for you


Here is the log for the updated version:
ufile.io/v6lfg

corrected that bug, submitted new beta branch version, can’t reproduce any bug with files on root

Still no luck with the addition of new files. Here is the log:
ufile.io/ugd8w

Traceback (most recent call last):
File “/media/sdaf/pioneer782/Library/Application Support/Plex Media Server/Scanners/Series/Absolute Series Scanner.py”, line 648, in Scan
add_episode_into_plex(media, file, root, path, show, season, int(ep), title, year, int(ep2) if ep2 and ep2.isdigit() else None, rx, tvdb_mapping, unknown_series_length, offset_season, offset_episode, mappingList)
UnboundLocalError: local variable ‘unknown_series_length’ referenced before assignment

Sorry about that
 Should be fixed now, uploaded new beta branch version
I looked at other variables that could also be missed so hopefully that’s the one


No luck this time too
log: ufile.io/pk25w

my bad solved the issue locally but pasted wrong code, please try newest upload
I promise you i will solve all. Thanks for your assistance

Working fine now. Thanks for your help!

At last :slight_smile:
Thanks for working with me. Now it is more stable for everybody.

No problem. Least I could do for all your efforts!

Beta branch now support ‘[youtube-PL
]’ Playlist Id in series or season folder for playlist downloaded with 'youtube-dl PL
 and will number as per the playlist rank the episode number in series libraries and my YouTube series/movie agent will DL the metadata. Better use the playlist I’d on series folder. Movie and series libraries can put video Id in movie/series folder with single file and it works too

The agent read video files in zip too as if in sane folder.
Can’t think of any improvement

Please create github bugs for any issues and use beta branch. If somebody could merge it for bto main branch would be great, am very bad with github


Hi all

  • I merged the Scanner beta branch in the main branch at last.
  • I have re-written the read-me that grew a bit long since i had to explain what a scanner is, etc.

Any issues with the read-me (or scanner) please let me know, as i tried my best to explain scanner and agent responsibilities, best metadata sources to use, naming conventions, how to force ids, etc
 This should reduce questions and enabling ASS users do what they want in Plex, which i believes this enables way better than the stock series scanner.

Together with HAMA beta branch, it logs all scanner and agent logs (filelist, scanner, agent-search, agent-update) into HAMA agent data folders (can move it to ‘Plex Media Server/Logs/Absolute Series Scanner’ folder if you feel the scanner is used without HAMA much) but i thought agent logs and scanner in one place was convenient

I started it simply but i believe it sure grew in functionalities.
Any improvement request?

  • rar files support ?
  • Support Media stubs .Disc files ? http://kodi.wiki/view/Media_stubs. Anybody uses that ?
  • Shall i write a Movie scanner using the same code? The Plex default movie scanner does an good job i believe ? Please argument.

@ZeroQI Awesome that all your hard work is ready to go. Congrats!

So all the big updates to HAMA are still in beta branch though? Or has that been merged into stable/master now as well?

@deusxanime Hama HAMA still on beta branch for now, still few bugs to be resolved and once resolved will merge beta branch back in main branch at last. here are Beta branch specific improvements:

  • custom metadata source priority per field
  • multi anidb xml for tvdb numbered series
  • multi language episode title for tvdb episodes
  • full length theme song search support

Hello there! I had to reinstall my plex library due to a hdd failing. So I installed plex, hama, ASS and added my files. It’s missing almost all of my OVA collection and on shows with more than 100 episodes, it shows episode 101+ as 1x01 and causing it to show as a copy. Also, it’s not showing the posters for any of the shows I have listed

Is there anything I can do to correct this?

@cbanks79 logs mentioned in readme needed for both scanner and agents.
I took me long hours to make logs readable and what I believe is a decent readme with troubleshooting steps and list of logs to include and i even splitted logs into filelist scanner agent search and agent update logs per series in agent data folders and yet infuriately some users don’t bother attach logs on first post. Please have the decency to attach logs and if ever you were bad enough to not have actually selected my scanner when creating the library please do a donation so I at least gain something positive from a negative


You need to use Hama beta branch since you didn’t create agent data folders for posters seemingly. Really sound like Plex default scanner behaviour.
Cannot reproduce with information given

Well I came asking for help, didn’t think it was truly a negative posting. I went back and did all of the troubleshooting, again, and I came here for some advice
 not to be berated. One thing your troubleshooting doesn’t state, and you should add to it, IF the plexdata is being sent to another folder, you will need to make the changes there as well.

For example, you install plex on C drive, but The path where local application data is stored is on D drive, you will need to place the information to that drive location not the AppData folder on the C drive. Putting them in both is redundant since you are storing the data elsewhere.

So no need for logs, they weren’t at the original location, and when I did find them I deleted them so that I could troubleshoot properly.

@ZeroQI said:
@cbanks79 logs mentioned in readme needed for both scanner and agents.

Cannot reproduce with information given
It works both ways