rickgc/scrobblex

scrobblex

概述

scrobblex是一款自托管的Node.js应用，通过Webhooks实现Plex与Trakt的播放记录（scrobbling）集成，还可将Plex中的媒体评分推送到Trakt。Plex Pass订阅者可利用Plex提供的Webhook功能，在用户执行观看电影、剧集等操作时，将事件发送至scrobblex，由其完成Trakt账户的播放记录同步。本工具与Plex Inc无关联。

核心功能与特性

• Trakt播放记录同步：将Plex中的媒体播放记录同步至Trakt
• 评分推送：支持将Plex中的媒体评分推送到Trakt
• 自托管：可部署在个人服务器或Plex服务器上
• 无需Trakt VIP：使用该应用无需Trakt VIP账户

使用场景与适用范围

适用于拥有Plex Pass订阅，希望将Plex观看记录和评分自动同步到Trakt的用户。尤其适合需要自托管解决方案，希望控制数据隐私的个人媒体服务器用户。

使用方法与配置说明

前提条件

• Plex Pass订阅（用于Webhook功能）
• Trakt账户
• 已在Trakt创建API应用（创建地址），Allowed Hostnames需设置为scrobblex访问地址+/authorize（例：http://10.20.30.40:3090/authorize）

Docker部署

使用docker run

bash
docker run \
  --name=scrobblex \
  --restart always \
  -v <本地配置路径>:/app/data \
  -e TRAKT_ID=<trakt应用ID> \
  -e TRAKT_SECRET=<trakt应用密钥> \
  -p 3090:3090 \
  rickgc/scrobblex:latest

使用compose.yml

yaml
services:
  scrobblex:
    image: rickgc/scrobblex:latest
    container_name: scrobblex
    restart: always
    ports:
      - 3090:3090
    environment:
      - TRAKT_ID=YOUR_TRAKT_ID  # Trakt应用ID
      - TRAKT_SECRET=YOUR_TRAKT_SECRET  # Trakt应用密钥
      - LOG_LEVEL=info  # 日志级别，可选info、debug等
    volumes:
      - ./scrobblex:/app/data  # 本地配置文件存储路径

初始化配置

容器启动后，访问http://<服务器IP>:3090，根据网页引导完成Trakt授权，获取同步所需的令牌。

环境变量配置

常见问题

如何获取Plex用户名？

1. 登录Plex官网，用户名显示在右上角
2. 或登录Plex账户设置，用户名位于个人资料图片下方

注意：Plex用户名不同于Plex ID，需使用登录账号的用户名。