jkirkcaldy/plex-utills

plex-utills 镜像文档

镜像概述

plex-utills是一个通过Web UI管理Plex媒体库的工具，旨在简化Plex库的维护工作。最新版本已全面迁移至Web界面，无需命令行操作，支持自动映射媒体目录，提供旧配置迁移功能，并新增HDR横幅设计及迁移脚本。工具使用TheMoviedb获取海报和元数据，建议配合TheMoviedb元数据代理使用以获得最佳兼容性。

核心功能与特性

4K/HDR海报管理

• 自动扫描媒体库，为电影和剧集添加4K横幅
• 支持全宽横幅或角落迷你横幅两种样式
• 可启用HDR横幅（包括Dolby Vision和HDR10专用设计）
• 自动备份原始海报至媒体目录
• 对电视剧集，仅为4K单集添加迷你4K横幅（因可能存在混合分辨率的季/剧）

3D海报管理

• 为3D电影添加3D横幅，支持全宽或迷你样式
• 需将3D电影存放在单独库中（因Plex无原生3D标签支持）
• 支持海报备份功能
• 若同时启用4K/HDR横幅，将自动组合显示

4K内容管理（Hide 4K）

• 为仅有4K版本的电影添加"Untranscodable"标签，通过用户权限限制隐藏
• 可选启用Plex优化功能，自动生成可播放版本
• 优化完成后自动移除标签，恢复用户可见性

合集管理

• 迪士尼合集：自动将迪士尼工作室电影添加到"迪士尼"合集中
• Pixar合集：自动将皮克斯动画电影添加到"Pixar"合集中

其他特性

• Web UI界面，简化配置与操作
• 旧配置文件自动迁移至新数据库
• 新HDR横幅设计及旧横幅迁移脚本

可用横幅样式

4K/3D横幅与HDR横幅可组合显示，以下为主要样式：

使用场景与适用范围

• Plex媒体库管理员，需美化电影/剧集海报
• 拥有4K/HDR/3D媒体内容，希望通过视觉标签区分
• 需要管理混合分辨率内容，避免低性能设备播放4K内容
• 希望自动创建迪士尼、Pixar等主题合集
• 偏好Web界面操作，无需命令行经验的用户

安装与使用方法

系统要求

• Docker环境
• Plex媒体库目录（容器需有写入权限）
• 网络访问（用于获取TheMoviedb元数据）

Unraid安装

1. 从Community Apps搜索并安装"plex-utills"
2. 挂载Plex媒体目录（必填）
3. 如需迁移旧配置，额外挂载原配置目录
4. 启动容器后，通过浏览器访问 http://<Unraid服务器IP>:5000

其他系统Docker安装

基本运行命令

bash
docker run -d \
  -p 5000:5000 \
  -v <你的Plex媒体目录>:/films \
  -v <日志目录>:/logs \
  -e TZ=Europe/london \  # 替换为你的时区，如Asia/Shanghai
  -e PUID=1000 \         # 运行容器的用户ID
  -e PGUI=1000 \         # 运行容器的组ID
  jkirkcaldy/plex-utills

迁移旧配置

如需从旧版本配置迁移，添加配置目录挂载：

bash
docker run -d \
  -p 5000:5000 \
  -v <你的Plex媒体目录>:/films \
  -v <日志目录>:/logs \
  -v <旧配置目录>:/config \  # 挂载旧配置目录
  -e TZ=Asia/Shanghai \
  -e PUID=1000 \
  -e PGUI=1000 \
  jkirkcaldy/plex-utills

访问Web UI

容器启动后，通过浏览器访问 http://<服务器IP>:5000，在Web界面中完成进一步配置（如选择库类型、横幅样式、启用合集等）。

注意事项

• 确保容器对Plex媒体目录有写入权限，以备份和更新海报
• 使用TheMoviedb作为Plex元数据代理可减少搜索失败问题（尤其对续集电影）
• 电视剧集的4K横幅仅应用于单集，而非季或剧海报
• 3D海报功能需3D内容存放在单独Plex库中