rycochet/plex-copy

plex-copy

CLI工具，用于从Plex优化版本中复制转码后的文件到对应目录并替换原文件，确保操作安全（复制成功后才删除原文件）。

核心功能

• 复制Plex优化版本中的转码文件到指定目录
• 可选复制字幕（强制字幕默认始终复制）
• 自动删除空文件夹
• 干运行模式（仅模拟操作不修改文件系统）
• 定时运行（按指定分钟间隔重复执行）
• 监控目录变化并自动触发操作
• 详细日志输出（默认开启）

使用场景

• Plex用户需要将优化后的转码文件替换原文件以节省存储空间
• 自动同步Plex库目录中新增的优化版本文件
• 批量处理多个Plex媒体库目录的转码文件复制

配置说明

直接运行

需安装NodeJS，通过npx执行：

console
$ npx plex-copy --help
用法: plex-copy [选项]... 路径...
复制所有Plex优化版本文件到正确目录并替换原文件。
提供一个或多个源路径进行检查，若为 glob 模式将自动扩展（忽略点前缀文件夹）。

选项:
  --copy-subtitles  同时复制字幕（强制字幕始终复制）[布尔值] [默认值: true]
  --delete-empty    删除空文件夹 [布尔值] [默认值: true]
  --dry-run         执行所有操作但不修改文件系统 [布尔值] [默认值: false]
  --interval        每X分钟运行一次 [数字] [默认值: 0]
  --verbose         显示所有操作详情 [布尔值] [默认值: true]
  --watch           监控变化并自动运行 [布尔值] [默认值: false]
  --help            显示帮助信息 [布尔值]
  --version         显示版本号 [布尔值]

仅在新文件复制成功后删除原文件，若文件已存在则跳过（提示"Skipped 'xyz/s01e23.mp4'"）。

Docker / Docker-compose

可通过Docker镜像自动运行，建议与Plex镜像配合使用。需设置与Plex相同的UID和GID以避免权限问题。

yaml
services:
  plex-copy:
    container_name: plex-copy
    image: rycochet/plex-copy:latest
    restart: unless-stopped
    # user: "1000:1000" # 设置为与Plex相同的UID和GID
    volumes:
      - "/Multimedia/Anime:/data/Anime"
      - "/Multimedia/TV Shows:/data/TV Shows"
    # command: "/data/* --delete-empty --watch --interval 60" # Docker镜像默认参数

许可证

• MIT许可证
• 详情请查看LICENSE.md