绝对系列扫描器 (ASS)：

如果所有视频文件在Plex中都显示正确的季数和集数，说明扫描器已经完成了它的工作。请在此处查看ASS的说明文档：https://github.com/ZeroQI/Absolute-Series-Scanner/blob/master/README.md

HTTP AniDB元数据代理 (HAMA)

HAMA最初由Atomicstrawberry创建，直到v0.4版本[2015-08-31]。以下是HAMA代理的功能：

* 同时支持电影和剧集代理
* AniDB ID与TVDB/TMDB ID匹配（包括工作室和分集映射列表），使用ScudLee的xml映射文件
* 从TVDB获取海报（在anidb到tvdb映射文件中为每个anidb id分配一个海报，以避免海报重复）
* TVDB分集截图
* 分集摘要（仅英文），通过ScudLee的XML分集映射从TVDB获取
* 优先使用映射文件中的工作室信息，其次是AniDB（因为AniDB中经常缺失）
* 通过AniDB HTML API数据库文件anime-titles.xml完全本地化搜索
* 在代理设置中可单独选择剧集名称和分集标题的语言顺序（支持文件夹、文件名、标题中的汉字）
* 在html报告文件中显示警告（无可用海报、分集摘要为空、TVDB id不在映射文件中），方便社区更新映射XML或TVDB，列出缺失的分集
* 使用ScudLee的电影合集，并通过AniDB RelatedAnime字段进行补充
* 通过在映射中使用anidbid排名来轮换海报，实现独特的海报展示
* 当在AniDB中找不到某个剧集时，自动搜索TVDB和TMDB
* Trakt追踪支持Hama guids

本地媒体资源

这个由Plex编写的代理负责从用户文件夹加载以下本地数据（如果存在）：

字幕
电影预告片
主题曲
背景
剧集海报
剧集季度海报

它的复选框位于设置 > 服务器 > 代理 > 电视节目 > HamaTV | HamaMovies > "本地媒体资源（电视|电影）"

https://support.plex.tv/hc/en-us/articles/200220677-Local-Media-Assets-Movies

https://support.plex.tv/hc/en-us/articles/200220717-Local-Media-Assets-TV-Shows

将此代理放在HAMA之前，以优先使用本地文件。以下是命名约定的总结表格：<BR />

<TABLE> <THEAD> <TR> <TH> 数据类型 </TH> <TH> 源文件 </TH> <TH> 注释 </TH> </TR> </THEAD> <TBODY> <TR> <TD> 同人画 </TD> <TD> art/backdrop/background/fanart-1.ext </TD> <TD> -1可以省略 </TD> </TR> <TR> <TD> 剧集海报 </TD> <TD> 剧集文件夹：节目名称-1/folder/poster/show.ext</TD> <TD> (jpg, jpeg, png, tbn) </TD> </TR> <TR> <TD> 季度海报 </TD> <TD> 季度文件夹：Season01a.ext </TD> <TD> (jpg, jpeg, png, tbn) </TD> </TR> <TR> <TD> 横幅 </TD> <TD> banner/banner-1.jpg </TD> <TD> (jpg, jpeg, png, tbn) </TD> </TR> <TR> <TD> 主题曲 </TD> <TD> theme.mp3 </TD> <TD> (mp3) </TD> </TR> <TR> <TD> 字幕 </TD> <TD> 文件名.ext </TD> <TD> (srt, smi, ssa, ass) </TD> </TR> <TR> <TD> 预告片 </TD> <TD> 电影名称-Trailer.ext 或放在"Trailers"文件夹中 </TD> <TD> </TD> </TR> <TR> <TD> Plex忽略文件 </TD> <TD> .plexignore </TD> <TD> </TD> </TR> </TBODY> </TABLE>

https://support.plex.tv/hc/en-us/articles/200220677-Local-Media-Assets-Movies

通过这种方式支持字幕文件

在HamaMovies代理列表中的"本地媒体资源（电影）"，任何名为MovieName-Trailer.ext的文件或放在电影文件夹内的"Trailers"文件夹中的文件都会被Plex识别为预告片。我已经为一些内容这样做了，因为我有预告片文件，但我同意 - 如果我们能让Hama将任何S0E2xx也添加为"预告片"额外内容，那就更好了。

Plex的预告片功能还支持显示来自URL的预告片 - 元数据代理只需要添加Plex可以访问预告片的相关URL。如果我们添加对此的支持，这意味着没有预告片文件的用户也可以受益于预告片功能。

元数据来源

我使用AniDB HTTP标题数据库文件和ScudLee的XML文件（经他同意）。HAMA使用了ScudLee的一个新分支：

ScudLee的XMLs： https://github.com/Anime-Lists/anime-lists ScudLee的XBMC AniDB修改代理： http://forum.xbmc.org/showthread.php?tid=142835&pid=1432010#pid1432010

* anime-titles.xml        AniDB HTTP API，包含所有动画标题，从http://anidb.net/api/anime-titles.xml.gz下载
* anime-list-master.xml   ScudLee的AniDB到TVDB xml映射文件，提供工作室和分集映射列表以获取分集概述，从[这里](https://raw.github.com/ScudLee/anime-lists/master/anime-list-master.xml)下载
* anime-movieset-list.xml ScudLee的电影合集（因为XBMC只支持电影合集，且这些文件是为AniDB mod XBMC插件开发的），从[这里](https://raw.github.com/ScudLee/anime-lists/master/anime-movieset-list.xml)下载

HAMA首先从互联网下载XMLs（使用Plex缓存1周），然后是本地，最后是资源文件夹。对于图片和主题曲，它首先从缓存获取，然后是互联网

XMLs会被下载（缓存）并保存一份副本在代理数据文件夹中，以备连接问题时使用

* anime-titles.xml：	         http://anidb.net/api/anime-titles.xml.gz [API: http://wiki.anidb.net/w/API]
* anime-list-full.xml：	 将AniDB ID映射到TVDB ID，提供工作室、分集映射矩阵、tmdb/tmdb id
* anime-movieset-list.xml： 	 允许将电影分组在一起
* tvdb横幅和剧集xml： 分集标题和摘要、截图、海报
* anidb剧集xml：           剧集信息、海报
* Plex主题曲：           剧集主题曲

Hama创建特定的html日志文件，其中包含链接，以方便更新所使用的元数据数据库，造福所有人，甚至列出缺失的分集：

[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/AniDB 海报缺失.htm - 不适用
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/AniDB 简介缺失.htm
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/anime-list anidbid 缺失.htm
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/anime-list 工作室标志.htm - anidbid: <a href='http://anidb.net/perl-bin/animedb.pl?show=anime&aid=266' target='_blank'>266</a> | 标题: '名侦探柯南' | AniDB 和 anime-list 都缺少工作室信息<br />
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/anime-list tvdbid 缺失.htm
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/TVDB 海报缺失.htm

  - <a href='http://thetvdb.com/wiki/index.php/Posters' target='_blank'>限制</a><br />

```
  - 无示例
```
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/TVDB 季度海报缺失.htm - tvdbid: <a href='http://thetvdb.com/?tab=series&id=307112' target='_blank'>307112</a> | 标题: '魔装学园H×H'
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/TVDB 简介缺失.htm

[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/Plex 主题曲缺失.htm - <a href='https://plexapp.zendesk.com/hc/en-us/articles/201572843' target='_blank'>限制</a><br /> - tvdbid: <a href='http://thetvdb.com/?tab=series&id=79796' target='_blank'>79796</a> | 标题: '飞轮少年' | <a href='mailto:themes@plexapp.com?cc=&subject=缺失主题曲%20-%20'%20-%2079796.mp3'' target='_blank'>上传</a><br />
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/缺失剧集.htm - anidbid: <a href='http://anidb.net/perl-bin/animedb.pl?show=anime&aid=4196' target='_blank'>4196</a> | 标题: '飞轮少年' | 缺失剧集: ['s1e1', 's1e2', 's1e3', 's1e4', 's1e5', 's1e6', 's1e7', 's1e8', 's1e9', 's1e10', 's1e11', 's1e12', 's1e13', 's1e14', 's1e15', 's1e16', 's1e17', 's1e18', 's1e19', 's1e20', 's1e21', 's1e22', 's1e23', 's1e24', 's1e25']<br /> - tvdbid: <a href='http://thetvdb.com/?tab=series&id=78914' target='_blank'>78914</a> | 标题: '全金属狂潮!' | 缺失剧集: ['s3e1', 's3e2', 's3e3', 's3e4', 's3e5', 's3e6', 's3e7', 's3e8', 's3e9', 's3e10', 's3e11', 's3e12', 's3e13']<br />
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/缺失剧集简介.htm - tvdbid: <a href='http://thetvdb.com/?tab=series&id=81797' target='_blank'>81797</a> | 标题: '海贼王' | 缺失剧集简介: ['753']<br />
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/缺失特别篇简介.htm - tvdbid: <a href='http://thetvdb.com/?tab=series&id=83322' target='_blank'>83322</a> | 标题: '魔法禁书目录' | 缺失特别篇简介: ['s0e1', 's0e2', 's0e3', 's0e4']<br />
[...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/缺失特别篇.htm - anidbid: <a href='http://anidb.net/perl-bin/animedb.pl?show=anime&aid=8166' target='_blank'>8166</a> | 标题: '星空之桥' | 缺失剧集: ['s0e2', 's0e1', 's0e3', 's0e5', 's0e4', 's0e8', 's0e7', 's0e6', 's0e9']<br /> 我确实将元数据 ID 从 Anidb ID 更改为 "anidb-xxxxx"，其中 xxxxx 是 anidbid。你可以在系列或 Series/Extras 文件夹中使用 anidb.id 文件，或在系列文件夹名称末尾使用 " [anidb-xxxxx]"，对 tvdb 也适用 " [tvdb-xxxxxxx]"。之前的旧代理需要重新创建库才能获得以 "anidb-" 开头的 metadata.id。

只有在向库中添加新项目或执行"强制刷新"或"修复错误匹配"时，才会调用代理的 update() 方法。

配置

代理设置将允许每个字段的元数据源可自定义，但并非所有源都存在所有字段。系列和剧集共享的字段可以使用 '|' 分隔系列和剧集部分。源包括：

AnimeLists：合集
'AniDB'
'TheTVDB'
'MyAnimeList'
'FanartTV'
'OMDb'：需要在代理设置中输入 API 密钥
'TheMovieDb'
'Plex'：主题
'AnimeLists'
'tvdb4'：季度海报
'TVTunes'：主题
'Local'：如果存在分组文件夹，则为合集

标题优先级可以使用常见的语言代码 'en'、'fr'、'sp'、'ja' 等，以及以下亚洲语言代码。标题将首先按照指定的优先级排序，其次按元数据源排序。

<TABLE> <THEAD> <TR> <TH> 语言代码 </TH> <TH> AniDB </TH> <TH> TheTVDB </TH> </TR> </THEAD> <TBODY> <TR> <TD> 中文（未指定） </TD> <TD> zh </TD> <TD> zh </TD> </TR> <TR> <TD> 中文（繁体） </TD> <TD> zh-Hant </TD> <TD> N/A </TD> </TR> <TR> <TD> 中文（简体） </TD> <TD> zh-Hans </TD> <TD> N/A </TD> </TR> <TR> <TD> 中文（粤语） </TD> <TD> zh-x-yue </TD> <TD> N/A </TD> </TR> <TR> <TD> 中文（普通话） </TD> <TD> zh-x-cmn </TD> <TD> N/A </TD> </TR> <TR> <TD> 中文（台湾） </TD> <TD> zh-x-nan </TD> <TD> N/A </TD> </TR> <TR> <TD> 日语 </TD> <TD> ja </TD> <TD> ja </TD> </TR> <TR> <TD> 日语（转写） </TD> <TD> jap </TD> <TD> N/A </TD> </TR> <TR> <TD> 韩语 </TD> <TD> ko </TD> <TD> ko </TD> </TR> <TR> <TD> 韩语（转写） </TD> <TD> x-kot </TD> <TD> N/A </TD> </TR> </TBODY> </TABLE>

安装

强烈建议安装 ASS 扫描器：将 https://raw.githubusercontent.com/ZeroQI/Absolute-Series-Scanner/master/Scanners/Series/Absolute%20Series%20Scanner.py 放入 Plex 主文件夹 / "Scanners" / "Series"（需要创建文件夹）。

安装 Hama 的方法与其他 Plex 代理相同：从 https://github.com/ZeroQI/Hama.bundle > "Code" > "Download Zip" 获取最新的源代码压缩包。在 Hama.bundle-master.zip 中，你会找到名为 "Hama.bundle-master" 的文件夹，将其重命名为 "Hama.bundle" 并放入 Plex 插件文件夹 [https://support.plex.tv/hc/en-us/articles/201106098-How-do-I-find-the-Plug-Ins-folder-] 或 Plex 主文件夹 / "Plug-ins"。

Plex 主文件夹位置：

* '%LOCALAPPDATA%\Plex Media Server\'                                        # Windows Vista/7/8
* '%USERPROFILE%\Local Settings\Application Data\Plex Media Server\'         # Windows XP, 2003, Home Server
* (userdir)/library/Logs/Plex Media Server/PMS Plugin Logs                   # Mac OS
* '$PLEX_HOME/Library/Application Support/Plex Media Server/',               # Linux
* '/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/', # Debian,Fedora,CentOS,Ubuntu
* '/var/lib/plex/Plex Media Server/',                                        # Arch
* '/usr/local/plexdata/Plex Media Server/',                                  # FreeBSD
* '/usr/pbi/plexmediaserver-amd64/plexdata/Plex Media Server/',              # FreeNAS
* '${JAIL_ROOT}/var/db/plexdata/Plex Media Server/',                         # FreeNAS
* '${JAIL_ROOT}/Plex Media Server/Plug-ins',                                 # FreeNAS 11.3 #skmagiik
* '/c/.plex/Library/Application Support/Plex Media Server/',                 # ReadyNAS
* '/share/MD0_DATA/.qpkg/PlexMediaServer/Library/Plex Media Server/',        # QNAP
* '/volume1/Plex/Library/Application Support/Plex Media Server/',            # Synology, Asustor
* '/raid0/data/module/Plex/sys/Plex Media Server/',                          # Thecus
* '/raid0/data/PLEX_CONFIG/Plex Media Server/'                               # Thecus Plex community

Hama 会在代理数据文件夹（"Plug-In Support/Data/com.plexapp.agents.hama/DataItems"）中自动创建一些文件夹：

"Logs"
"AniDB"
"Plex"
"OMDB"
"TMDB"
"TheTVDB"
"TheTVDB/banner/graphical"
"TVDB/episodes"
"TVDB/fanart/original"
"TVDB/json"
"TVDB/posters"
"TVDB/seasons"
"FanartTV"

我使用这些文件夹来缓存所有图片和主题曲，因为它们不会被 Plex 缓存。这样，即使你重新创建整个 Plex 动漫文件夹条目，也不需要再次下载相同的文件。

Synology DSM7- SSH 并复制到 /volume1/@apphome/PlexMediaServer/Plex Media Server

特定安装步骤请参阅 wiki：

Ubuntu Server 16.04：https://github.com/ZeroQI/Hama.bundle/wiki/Installing-Hama-and-ASS-on-Ubuntu

Linux 下的安装问题通常是权限问题...

OpenMediaVault (Debian)："sudo chmod 775 -R /var/lib/plexmediaserver"
Synology："chown -R plex:users" + "chmod -R 700"
FREENAS：chmod -R 777 /var/db/plexdata/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/.
如果出现：File "bundles-release/Framework.bundle-dist/Contents/Resources/Versions/2/Python/Framework/components/storage.py", line 81, in save IOError: [Errno 13] Permission denied: '/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/._StoredValues'

touch /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/._StoredValues

chmod 777 /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/._StoredValues

chown plex:plex /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/._StoredValues

service plexmediaserver restart

故障排除：

如果你询问的问题已经在 readme 中回答过，或者在代理页面上发布扫描器问题，反之亦然，请捐赠（将被称为 RTFM 税）如果文件和剧集在Plex图形界面中以正确的季数显示，说明扫描器已完成其工作。如果缺少元数据（剧集标题错误、没有海报、摘要、错误的分集标题或摘要、分集截图等），那是代理程序的问题。

如果缺少海报，请检查所有数据文件夹是否已创建，并查看日志是否显示权限问题。如果字幕未加载，请检查设置 > 服务器 > 代理 > 电视节目 > HamaTV，并勾选"本地媒体资源（电视）"，因为默认情况下未勾选。

为避免已解决的问题，并确保一次性包含所有相关日志，请执行以下操作：

删除媒体库
停止Plex
更新至最新的Absolute Series Scanner（master分支）、Hama（Master分支）和Plex
删除所有Plex日志，保留文件夹完整
重启Plex
重新创建媒体库
包含以下所有日志：（位置：https://support.plex.tv/hc/en-us/articles/200250417-Plex-Media-Server-Log-Files）
- [...]/Plex Media Server/Logs/PMS Plugin Logs/com.plexapp.agents.hama.log（代理日志）
- [...]/Plex Media Server/Logs/PMS Plugin Logs/com.plexapp.system.log（显示代理无法启动的原因）
- [...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/series_root_folder.filelist.log（分集信息）
- [...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/series_root_folder.scanner.log（分集信息）
- [...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/(Library_name/)series_root_folder.agent-search.log（guid分配）
- [...]/Plex Media Server/Plug-in Support/Data/com.plexapp.agents.hama/DataItems/_Logs/(Library_name/)series_root_folder.agent-update.log（元数据更新）
- 如有需要，请提供屏幕截图以说明问题。上述日志仍然是必需的