PlexTraktSync 项目教程

1. 项目的目录结构及介绍

PlexTraktSync 项目的目录结构如下：

PlexTraktSync/
├── README.md
├── plex_trakt_sync
│   ├── __init__.py
│   ├── main.py
│   ├── config.py
│   ├── sync.py
│   ├── watch.py
│   └── ...
├── requirements.txt
├── setup.py
└── ...

• README.md: 项目说明文档。
• plex_trakt_sync/: 项目的主要代码目录。
  • __init__.py: 模块初始化文件。
  • main.py: 项目的启动文件。
  • config.py: 配置文件处理模块。
  • sync.py: 同步功能实现模块。
  • watch.py: 监听和记录播放事件的模块。
• requirements.txt: 项目依赖的 Python 包列表。
• setup.py: 项目的安装脚本。

2. 项目的启动文件介绍

项目的启动文件是 plex_trakt_sync/main.py。这个文件包含了项目的入口点，负责初始化配置、处理命令行参数并调用相应的功能模块。

# main.py
import argparse
from .config import load_config
from .sync import sync
from .watch import watch

def main():
    parser = argparse.ArgumentParser(description="PlexTraktSync")
    subparsers = parser.add_subparsers(dest="command")

    sync_parser = subparsers.add_parser("sync", help="Perform sync between Plex and Trakt")
    sync_parser.add_argument("--sync", choices=["all", "movies", "tv"], default="all", help="Specify what to sync")

    watch_parser = subparsers.add_parser("watch", help="Listen to events from Plex Media Server and scrobble plays")

    args = parser.parse_args()

    config = load_config()

    if args.command == "sync":
        sync(config, args.sync)
    elif args.command == "watch":
        watch(config)

if __name__ == "__main__":
    main()

3. 项目的配置文件介绍

项目的配置文件处理模块是 plex_trakt_sync/config.py。这个模块负责加载和解析配置文件，配置文件通常是一个 JSON 文件，包含了 Plex 和 Trakt 的 API 密钥、用户凭证等信息。

# config.py
import json

def load_config():
    with open("config.json", "r") as f:
        config = json.load(f)
    return config

配置文件 config.json 的示例内容如下：

{
    "plex_username": "your_plex_username",
    "plex_password": "your_plex_password",
    "trakt_api_key": "your_trakt_api_key",
    "trakt_api_secret": "your_trakt_api_secret"
}

这个配置文件包含了连接 Plex 和 Trakt 所需的用户名、密码和 API 密钥等信息。