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

1. 项目目录结构及介绍

Plex Playlist Pusher（PPP）项目的目录结构如下：

PPP/
├── .github/
├── branding/
├── .gitignore
├── LICENSE
├── PPP.py          # 主程序文件
├── README.md       # 项目说明文件
├── example-variables.json  # 配置文件示例
└── variables.json   # 配置文件

• .github/: 存放与GitHub相关的配置文件。
• branding/: 包含项目品牌相关的资源。
• .gitignore: 指定Git忽略的文件和目录。
• LICENSE: 项目使用的GPL-3.0协议许可证文件。
• PPP.py: 项目的主程序，用于同步本地音乐播放列表和Plex播放列表。
• README.md: 项目说明文件，包含项目信息和使用说明。
• example-variables.json: 配置文件示例，用于帮助用户配置项目。
• variables.json: 项目的主要配置文件，保存用户设置的变量。

2. 项目的启动文件介绍

项目的启动文件是PPP.py。这是Python编写的脚本，用于执行音乐播放列表的同步工作。可以通过以下命令运行：

python3 PPP.py

启动脚本支持以下命令行参数：

• -h, --help: 显示帮助信息并退出。
• -setup: 强制运行设置程序。
• -nobackups: 禁用本地播放列表的备份。
• -retention n: 指定保留的本地播放列表备份数量。
• -nocleanup: 禁用临时目录的清理（仅用于调试）。

3. 项目的配置文件介绍

项目的配置文件是variables.json。该文件包含项目运行所需的各种配置参数。如果需要，可以将example-variables.json重命名为variables.json并进行编辑。

以下是一些重要的配置参数：

• server_url: Plex服务器的URL地址。
• check_ssl: 是否验证SSL证书。
• plex_token: Plex API的令牌。
• local_playlists: 本地播放列表的路径。
• working_directory: PPP的工作目录路径。
• working_directory_plex: Plex视角下的PPP工作目录路径。
• section_id: 包含所有音乐的Plex库部分的ID。
• local_prepend: 在本地播放列表路径中要忽略的部分。
• plex_prepend: 在Plex播放列表路径中要忽略的部分。
• local_convert: 如果本地播放列表使用不同的目录格式，则进行转换。
• plex_convert: 如果Plex播放列表使用不同的目录格式，则进行转换。

确保所有配置参数根据实际情况进行正确设置，以保障项目正常运行。