PPP 的安装和配置教程

项目的基础介绍和主要的编程语言

PPP（Plex Playlist Pusher）是一个开源项目，其主要功能是实现本地音乐库与 Plex 媒体服务器之间的播放列表同步。通过自动比较、合并和更新播放列表，确保本地播放列表与 Plex 上的播放列表保持一致。该项目主要使用 Python 3 进行编写。

项目使用的关键技术和框架

• Python 3：作为主要的编程语言，用于编写脚本和自动化任务。
• Plex Playlist API：与 Plex 媒体服务器交互，用于读取和更新 Plex 上的播放列表。
• 文件处理和路径转换：处理本地文件系统的播放列表文件，并根据需要进行路径格式转换。

项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保以下准备工作已经完成：

1. 安装 Python 3：确保你的系统中安装了 Python 3。可以在 Python 官网下载并安装最新版本的 Python 3。
2. 访问 Plex 服务器的权限：确保你有权限访问你的 Plex 服务器，并能够获取到 Plex API 的 token。
3. 确定本地播放列表路径：准备一个本地文件夹用于存放你的音乐播放列表文件（.m3u 格式）。

安装步骤

1. 克隆项目仓库
   打开命令行工具，使用以下命令克隆项目仓库到本地：

   git clone https://github.com/XDGFX/PPP.git
   cd PPP
   

2. 配置项目
   在项目目录中，找到 example-variables.json 文件，将其重命名为 variables.json。然后根据你的 Plex 服务器配置和本地路径编辑该文件。以下是一些需要配置的变量：

   {
     "server_url": "http://你的Plex服务器IP:32400",
     "plex_token": "你的Plex API token",
     "local_playlists": "本地播放列表的路径",
     "working_directory": "PPP脚本的工作目录",
     "working_directory_plex": "Plex看到的PPP工作目录",
     "section_id": "你的音乐库在Plex中的section ID",
     "local_prepend": "本地文件路径前缀",
     "plex_prepend": "Plex文件路径前缀",
     "local_convert": "本地路径转换设置",
     "plex_convert": "Plex路径转换设置"
   }
   

3. 运行 setup 脚本
   在命令行中运行以下命令，开始配置向导：

   python PPP.py --setup
   

   按照提示完成配置。

4. 运行 PPP 脚本
   使用以下命令运行 PPP 脚本，同步你的播放列表：

   python PPP.py
   

   你也可以添加一些可选参数，例如：

   python PPP.py --nobackups --nocleanup
   

   这将禁用本地播放列表的备份和清理临时文件夹。

按照以上步骤，你应该能够成功安装和配置 PPP 项目，实现本地音乐库与 Plex 媒体服务器之间的播放列表同步。