sureshfizzy/cinesync

CineSync - 轻松组织您的媒体库

镜像概述和主要用途

CineSync是一个基于Python的库管理系统，旨在高效组织Debrid平台的电影和电视剧库，无需依赖Sonarr/Radarr。对于通过DMM Manager下载的用户，无论是单个文件还是文件夹，都能无缝地将库整理为季结构。CineSync通过创建符号链接来简化库的组织，同时让您对本地数据保持完全控制。虽然针对Debrid平台高度优化，但CineSync也具备多功能性，可有效用于非Debrid平台。

核心功能和特性

• 库组织：轻松将库按季分类，无论文件或文件夹结构如何。
• 快速扫描：优化了文件和目录扫描速度，改进了目录检查、文件处理和多线程处理（由MAX_PROCESSES控制），尤其适合大型库。
• 符号链接创建：创建符号链接来组织库，无需移动或复制原始文件。
• 文件实时监控：监控监视目录中的新文件并自动为其创建符号链接，确保库实时更新（可通过SLEEP_TIME配置监控间隔）。
• 支持单个符号链接创建：支持为单个文件或文件夹创建符号链接，提供库管理灵活性。
• 跳过已存在的符号链接：能够跳过已存在的文件或文件夹的符号链接创建（即使文件夹名称不同），避免重复。
• 文件重命名：当RENAME_ENABLED=true时，根据TMDb数据正确重命名文件。
• 跨平台支持：适用于Linux和Windows操作系统。
• 电影合集分离：基于TMDb或IMDb数据将电影组织为合集，确保同一合集的电影分组（通过MOVIE_COLLECTION_ENABLED启用）。
• Docker支持：轻松在Docker容器中部署CineSync，实现一致且隔离的环境。
• TMDb/IMDB/TVDB ID集成：利用TMDb/IMDB/TVDB ID实现更精确的媒体文件组织和命名。
• 自动分离附加内容和分辨率：自动将附加内容与主剧集分离，并按分辨率（如720p、1080p、4K）排序文件（通过SKIP_EXTRAS_FOLDER配置）。
• 基于分辨率的文件排序：按分辨率分离文件，若未启用，则按源文件夹结构组织。
• 数据库配置：优化数据库操作，支持可配置的限流速率、重试机制和批处理，用于管理媒体元数据和符号链接创建（由DB_*变量控制）。
• Rclone挂载验证：支持在处理文件前检查rclone挂载点是否可用，适用于管理远程存储（通过RCLONE_MOUNT启用）。

使用场景和适用范围

• 管理Debrid平台下载的电影和电视剧库，无需手动整理。
• 需要保持原始文件位置不变，通过符号链接维护整洁库结构的用户。
• 定期下载剧集或系列内容，需要自动组织新添加文件的场景。
• 希望按分辨率、合集或附加内容分离媒体文件的用户。
• 使用Docker部署以确保环境一致性的场景。
• 同时使用本地存储和远程存储（如rclone挂载）的媒体库管理。

使用方法和配置说明

开始使用

有关安装、配置和使用的详细说明，请访问项目Wiki：

• https://github.com/sureshfizzy/CineSync/wiki/Installation
• https://github.com/sureshfizzy/CineSync/wiki/Configuration
• https://github.com/sureshfizzy/CineSync/wiki/Usage
• https://github.com/sureshfizzy/CineSync/wiki/Volumes

Docker Hub仓库

CineSync Docker镜像可在Docker Hub获取：

• https://hub.docker.com/r/sureshfizzy/cinesync

支持的架构

• amd64 (x86_64)
• arm64 (aarch64)

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name cinesync \
  -v /path/to/source:/source \  # 源媒体文件目录
  -v /path/to/destination:/destination \  # 目标符号链接目录
  -v /path/to/config:/config \  # 配置文件目录
  -e SLEEP_TIME=60 \  # 监控间隔（秒）
  -e MAX_PROCESSES=4 \  # 最大线程数
  -e RENAME_ENABLED=true \  # 启用文件重命名
  -e MOVIE_COLLECTION_ENABLED=true \  # 启用电影合集分离
  --restart unless-stopped \
  sureshfizzy/cinesync

Docker Compose配置

yaml
version: '3'
services:
  cinesync:
    image: docker.xuanyuan.run/sureshfizzy/cinesync
    container_name: cinesync
    volumes:
      - /path/to/source:/source
      - /path/to/destination:/destination
      - /path/to/config:/config
    environment:
      - SLEEP_TIME=60
      - MAX_PROCESSES=4
      - RENAME_ENABLED=true
      - MOVIE_COLLECTION_ENABLED=true
      - RCLONE_MOUNT=true  # 启用rclone挂载验证
      - DB_THROTTLE_RATE=5  # 数据库限流速率
    restart: unless-stopped

实时监控

CineSync集成了完整的实时监控功能，可自动跟踪媒体库变化，特别适用于定期更新的剧集管理，确保库无需手动干预即可保持最新。

工作原理

• 初始全量扫描：启动时执行全量扫描，识别所有现有文件和文件夹并完成初始组织。
• 自动触发监控：全量扫描完成后，实时监控自动启动，持续监控指定目录。
• 监视目录：持续监控新文件/文件夹的添加位置。
• 监控间隔：默认每60秒检查一次目录变化，可通过SLEEP_TIME调整。
• 自动识别与链接创建：检测到新文件/文件夹后，自动识别内容并创建符号链接，保持库结构整洁。
• 效率与自定义：自动处理新内容，减少手动操作；可自定义监控间隔和其他参数以适应需求。

CineSync的实时监控功能已集成到脚本和Docker镜像中，可无缝融入您的媒体管理工作流。