使用 plex-localization-zh 可以将 Plex 媒体库中的媒体信息进行中文本地化。它可以通过与 Plex 服务器进行交互，获取媒体库中的电影、电视节目、艺术家、专辑、音轨和合集信息，将媒体的标题排序修改为媒体标题的拼音首字母缩写，并获取媒体的类型标签、风格标签和情绪标签等标签，将英文标签进行汉化。从而实现 Plex 媒体库的拼音排序、拼音搜索及类型标签汉化功能。
通过运行 plex-localization-zh，可以自动将媒体的标题排序修改为媒体标题的拼音首字母缩写，例如：
将电影的标题排序从 "重庆森林" 变更为 "CQSL"。
将电视节目的标题排序从 "怪奇物语" 变更为 "GQWY"。
将艺术家的艺术家排序从 "王菲" 变更为 "WF"。
将合集的标题排序从 "黑客帝国（系列）" 变更为 "HKDGXL"。
标题排序只影响排列顺序，不影响显示效果，媒体在 Plex 中依然会以中文标题进行显示，但是在使用标题排序时会根据拼音首字母缩写进行排序，并且可以通过拼音首字母缩写进行搜索，包括模糊搜索。
通过运行 plex-localization-zh 还可以自动将媒体的元数据标签从英文翻译成中文，例如：
将电影的类型从 "Action" 变更为 "动作"。
将电视节目的类型从 "Comedy" 变更为 "喜剧"。
将专辑的情绪从 "Sad" 变更为 "悲伤"。
将艺术家的风格从 "Pop" 变更为 "流行"。
脚本中已经预置了一些常用标签的中英翻译，主要是影视类型，若有其他标签需要汉化可以自己在脚本中添加中英翻译。
- 安装了 Python 3.0 或更高版本。
- 安装了必要的第三方库：requests、pypinyin。（可以通过命令
pip install requests pypinyin安装）
- 将仓库克隆或下载到计算机上的一个目录中。
- 修改
start.command (Mac)或start.bat (Win)中的路径，以指向您存放plex-localization-zh.py脚本的目录。 - 双击运行
start.command或start.bat脚本以执行plex-localization-zh.py脚本。 - 首次运行时需要您在控制台中输入您的 Plex 服务器地址和 X-Plex-Token，这些信息将被保存在与脚本相同目录下的
config.ini文件中，以便将来使用。 - 脚本将连接到您的 Plex 服务器并自动遍历所有媒体库，将中文标题的标题排序修改为媒体标题的拼音首字母缩写，并根据预定义的标签映射将元数据标签翻译为中文。
- 在处理过程中，脚本会打印出已变更的元数据，您可以在控制台中查看这些信息。
- 请确保您提供了正确的 Plex 服务器地址和正确的 X-Plex-Token。
- 如果脚本无法连接到 Plex 服务器，请检查您的网络连接，并确保服务器可以访问。
- 请使用服务器管理员账号的 X-Plex-Token 运行脚本，以确保您对 Plex 服务器具有足够的权限。
此脚本的原作是 plex_localization_zhcn，我在原作的修改版 plexpy 的基础上增加了对合集标题的支持，感谢 timmy0209、sqkkyzx、anooki-c 贡献的代码。
plex-localization-zh is a script that allows you to localize media information in your Plex media library. It interacts with your Plex server to retrieve information about movies, TV shows, artists, albums, tracks and collections. The script modifies the title sort of media to the initials of the Chinese pinyin of the title. It also translates metadata labels such as genre, style, and mood from English to Chinese. This provides features like Chinese pinyin sorting, searching, and Chinese labeling for your Plex media library.
By running plex-localization-zh, you can automatically change the title sort of media to the initials of the Chinese pinyin of the title, for example:
Change the title sort of a movie from "重庆森林" to "CQSL".
Change the title sort of a TV show from "怪奇物语" to "GQWY".
Change the artist sort of an artist from "王菲" to "WF".
Change the title sort of a collection from "黑客帝国（系列）" to "HKDGXL".
Title sorting affects the order of display but doesn't impact the actual display of media in Chinese. When using title sorting, the media will be sorted based on the initials of the Chinese pinyin abbreviation, and you can also search using these initials, including fuzzy searching.
By running plex-localization-zh, you can also automatically translate metadata labels from English to Chinese, for example:
Translate the genre of a movie from "Action" to "动作".
Translate the genre of a TV show from "Comedy" to "喜剧".
Translate the mood of an album from "Sad" to "悲伤".
Translate the style of an artist from "Pop" to "流行".
The script has preset some commonly used tag translations in Chinese and English, mainly film and television types. If there are other tags that need to be localized into Chinese, you can add Chinese-English translations in the script yourself.
- Installed Python 3.0 or higher.
- Installed required third-party libraries: requests, pypinyin. (You can install them using the command
pip install requests pypinyin)
- Clone or download the repository to a directory on your computer.
- Modify the path in
start.command (Mac)orstart.bat (Win)to point to the directory where you store theplex-localization-zh.pyscript. - Double-click
start.commandorstart.batto execute theplex-localization-zh.pyscript. - On the first run, you will need to input your Plex server address and X-Plex-Token in the console. This information will be saved in the
config.inifile in the same directory for future use. - The script will connect to your Plex server and automatically traverse all media libraries. It will change the title sort of Chinese titles to the initials of the Chinese pinyin of the title and translate metadata labels to Chinese based on predefined translations.
- During the process, the script will print out the changed metadata, and you can view this information in the console.
- Ensure you provide the correct Plex server address and the correct X-Plex-Token.
- If the script cannot connect to the Plex server, check your network connection and make sure the server is accessible.
- Run the script using the X-Plex-Token of a server administrator account to ensure you have sufficient permissions on the Plex server.
This script is based on the original work of plex_localization_zhcn. I added support for collection titles based on plexpy. Thanks to contributions from timmy0209、sqkkyzx、anooki-c.