Plex Playlist Pusher（PPP）项目启动与配置教程

Plex Playlist Pusher（PPP）项目启动与配置教程

PPP Sync music playlists between your local music library and Plex! 项目地址: https://gitcode.com/gh_mirrors/ppp2/PPP

1. 项目目录结构及介绍

Plex Playlist Pusher（PPP）项目的目录结构相对简单，主要包括以下几个部分：

• /.github/：存放与GitHub相关的配置文件，如代码贡献指南、_issue模板等。
• /branding/：可能包含项目品牌相关的资源，如logo、图标等。
• /example-variables.json：一个示例配置文件，用于展示如何配置PPP。
• /LICENSE：项目使用的许可证文件，PPP遵循GPL-3.0协议。
• /PPP.py：PPP项目的主脚本文件，包含了项目的核心逻辑。
• /README.md：项目的自述文件，介绍了项目的功能、使用方法和配置指南。
• /variables.json：项目的配置文件，保存了运行PPP所需的所有配置信息。

2. 项目的启动文件介绍

项目的启动文件是PPP.py。该文件是PPP项目的核心，包含了以下几个主要部分：

• 命令行参数解析：允许用户通过命令行参数来控制PPP的行为，如启动设置向导、禁用备份等。
• 设置向导：在首次运行时，引导用户完成配置文件的设置。
• 主逻辑函数：负责加载本地播放列表、Plex播放列表，比较差异，并更新Plex和本地播放列表。

使用方法如下：

python PPP.py [options]

可用的选项包括：

• -h, --help：显示帮助信息并退出。
• -setup：强制运行设置向导。
• -nobackups：完全禁用本地播放列表的备份。
• -retention n：设置保留之前本地播放列表备份的数量。
• -nocleanup：禁用临时文件夹的清理（仅用于调试）。

3. 项目的配置文件介绍

项目的配置文件是variables.json。该文件包含了PPP运行所需的所有配置信息。以下是配置文件中可能包含的一些关键配置项：

• server_url：Plex服务器的URL，格式通常为http://<服务器IP>:<端口>。
• check_ssl：是否验证SSL证书。对于自签名HTTPS，设置为"False"。
• plex_token：Plex的访问令牌，可以在Plex的设置中找到。
• local_playlists：本地播放列表的路径。
• working_directory：PPP的工作目录，需要Plex能够访问。
• working_directory_plex：Plex看到的PPP工作目录路径，如果Plex在容器中运行可能需要修改。
• section_id：包含所有音乐的库部分的ID。
• local_prepend和plex_prepend：在比较和同步时忽略的路径前缀。
• local_convert和plex_convert：根据需要转换本地和Plex播放列表的路径格式。

配置文件应手动编辑或通过重命名example-variables.json为variables.json并进行修改。在编辑配置文件时，请确保所有路径和令牌都是正确的。

PPP Sync music playlists between your local music library and Plex! 项目地址: https://gitcode.com/gh_mirrors/ppp2/PPP