YouTube-Agent.bundle

YouTube-Agent.bundle项目介绍

项目背景

YouTube-Agent.bundle是一个用于Plex媒体服务器的元数据代理插件。它的主要功能是通过YouTube视频的ID在YouTube上查找已下载视频的元数据。要成功使用此代理，视频的文件名中需要包含YouTube视频ID。除此之外，此插件还支持从.info.json文件中读取元数据，建议用户在下载视频时生成这些文件。

文件命名规则

文件或文件夹名称中需包含YouTube ID，格式可以是[xxxxxxxx]、[youtube-xxx]、[YouTube-xxx]或[Youtube-xxx]。
例如：Person Of Interest Soundtrack - John Reese Themes (Compilation) [OR5EnqdnwK0].mp4。

安装指南

要安装此插件，需要将插件代码放入Plex Media Server的Plug-ins文件夹中。用户可以根据操作系统找到相应的插件目录，例如：

Windows Vista/7/8: %LOCALAPPDATA%\Plex Media Server\
Mac OS: $HOME/Library/Application Support/Plex Media Server/
Linux: /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/

具体步骤为：

从GitHub下载插件的Zip文件。
解压Zip文件，并将内容重命名为Youtube-Agent.bundle。
将此文件夹放入Plug-ins目录。
重启Plex Media Server以加载新插件。

使用方法

在使用此插件下载YouTube播放列表时，可使用youtube-dl命令行工具进行下载。示例命令为：

youtube-dl https://www.youtube.com/watch?list=PL22J3VaeABQD_IZs7y60I3lUrrFTzkpat

建议使用以下命令选项：

--restrict-filenames：确保文件名仅包含ASCII字符，避免Windows文件系统不支持的字符。
--write-info-json：从本地.info.json文件中加载元数据，可以减少YouTube API请求次数。

YouTube API Key

为了避免用尽内建API的使用额度，推荐用户自行注册YouTube API Key并替换插件中的设置。具体步骤包括：

访问Google开发者控制台，创建新项目。
按照指引创建API Key并启用YouTube Data API。
将生成的API Key放入插件目录的youtube-key.txt文件中。

支持的媒体库字段

电影库支持的字段：title、summary、poster、rating、originally_available_at、year、genres、directors。
TV系列库的命名规范同样需要包括YouTube ID，具体可以放在文件名或文件夹名中。

常见问题与支持

如果在使用过程中遇到问题，应确保已更新至最新版本的Absolute Series Scanner和YouTube-Agent，并重启Plex后尝试更新元数据。如需帮助，可以在GitHub上提出问题或参与相关论坛讨论。

捐赠

如果用户觉得插件有帮助，可以通过PayPal进行捐赠以支持开发者继续改进和维护项目。