healzangels/motif

motif

通过https://github.com/LizardByte/ThemerrDB%E4%B8%BAPlex%E8%87%AA%E5%8A%A8%E7%BC%96%E6%8E%92%E4%B8%BB%E9%A2%98%E6%AD%8C%E6%9B%B2%E3%80%82

motif每日同步ThemerrDB，通过用户提供的cookies下载***主题，以版本感知匹配方式硬链接到Plex影视文件夹，并触发单项目Plex刷新（无需全库扫描）。所有操作可通过端口5309的CRT风格Web UI管理，支持状态查看、搜索、手动覆盖及Plex覆盖报告。

完整文档（架构、故障排除、高级主题、贡献指南）请参见**https://github.com/Healzangels/motif**%E3%80%82

---

快速开始

motif采用双卷布局，与Plex容器的目录结构保持一致：

首次启动后，需在UI的/settings页面选择主题写入路径，通常为/data/media/themes。

选项1 — Docker Compose

yaml
services:
  motif:
    image: docker.xuanyuan.run/healzangels/motif:latest
    container_name: motif
    restart: unless-stopped
    ports:
      - "192.168.1.10:5309:5309"
    volumes:
      - /mnt/user/appdata/motif:/config
      - /mnt/user/data:/data
    environment:
      MOTIF_PLEX_URL: http://192.168.1.10:32400
      MOTIF_PLEX_TOKEN: YOUR_TOKEN_HERE
    user: "99:100"

bash
mkdir -p /mnt/user/appdata/motif
chown -R 99:100 /mnt/user/appdata/motif
# 放置Netscape格式的YouTube cookies
cp /path/to/cookies.txt /mnt/user/appdata/motif/cookies.txt
chmod 600 /mnt/user/appdata/motif/cookies.txt
docker compose up -d
docker compose logs -f motif

选项2 — 普通docker run

bash
docker run -d \
  --name motif \
  --restart unless-stopped \
  -p 192.168.1.10:5309:5309 \
  -v /mnt/user/appdata/motif:/config \
  -v /mnt/user/data:/data \
  -e MOTIF_PLEX_URL=http://192.168.1.10:32400 \
  -e MOTIF_PLEX_TOKEN=YOUR_TOKEN_HERE \
  --user 99:100 \
  docker.xuanyuan.run/healzangels/motif:latest

选项3 — Unraid社区应用

GitHub仓库中的unraid/motif.xml为模板文件，将其放入/boot/config/plugins/dockerMan/templates-user/，即可在Unraid Docker UI中添加容器。

---

首次设置

1. 打开http://YOUR_HOST:5309/，首次加载会重定向到一次性设置页面，创建管理员用户名和密码。
2. 登录后，若看到红色横幅CONFIGURE THEMES DIRECTORY，点击进入/settings→PATHS标签→设置THEMES DIRECTORY为/data/media/themes（或/data目录下的其他路径）。
3. motif默认启动DRY-RUN模式，仅同步ThemerrDB并分析操作，不会实际下载或放置文件。需从横幅中禁用该模式，确认匹配无误后再执行实际操作。
4. 禁用dry-run并设置路径后，motif开始下载主题。

---

必需环境变量

可选环境变量及完整配置参考见https://github.com/Healzangels/motif#configuration%E3%80%82

---

Cookies设置

motif使用yt-dlp结合用户的*** cookies下载主题，需将Netscape格式的cookies.txt放入/config/目录：

bash
chmod 600 /mnt/user/appdata/motif/cookies.txt

文件所有者需与容器用户一致（默认Unraid为99:100）。可使用浏览器扩展如"Get cookies.txt LOCALLY"导出Netscape格式的***会话cookies。

若无cookies.txt，motif仍可运行，但多数***下载会失败（如年龄限制、区域锁定或需登录的内容）。

---

镜像标签

---

反向代理（可选）

motif支持任何反向代理。使用Authentik forward-auth时，需设置：

MOTIF_TRUST_FORWARD_AUTH=1

motif会读取代理传递的X-Authentik-Username，并在首次请求时自动创建本地账户。若无此设置，motif使用自身登录流程（bcrypt哈希会话）。

---

motif不支持的功能

• 扫描媒体库：motif依赖上游ThemerrDB和针对性的单项目Plex刷新，不执行全库扫描或主题外的元数据刷新。
• 修改媒体文件：仅写入/themes目录并硬链接到Plex文件夹，原始文件保持不变。
• 独立运行：motif假设Plex为消费端，无法单独运行。

---

支持与贡献

• 问题反馈：https://github.com/Healzangels/motif/issues
• 源码：https://github.com/Healzangels/motif
• 许可证：MIT

完整README（架构图、故障排除、使用指南、贡献者手册）请参见GitHub仓库。