rubasace/radarr-folder-organizer

Radarr Folder Organizer

镜像概述和主要用途

Radarr Folder Organizer是一款根据自定义格式为电影分配文件夹的工具，能够将文件移动到指定位置并更新Radarr以反映这些更改。

核心功能和特性

• 根据Radarr自定义格式自动分配电影文件夹
• 移动文件到指定目标文件夹并同步更新Radarr库信息
• 支持默认文件夹配置及多自定义格式文件夹映射
• 可通过Docker容器化部署，支持定时执行

为什么需要此工具

Radarr的自定义格式非常适用于特定场景，例如：电影原版一发布就下载，待双版本发布后进行升级。但Radarr本身不支持为自定义格式分配替代文件夹，本工具解决了这一问题，通过检查Radarr库中已下载电影的自定义格式，将其移动到对应的指定文件夹。

配置说明

示例Config.txt

ini
[Radarr]
url = http://changeme.com:3333
key = 4384803r2808rvsvj023r9fjvvd0fjv3
[CustomFormatMappings]
__default = /the/default/folder 
custom_format1 = /custom/format/1/folder
custom_format2 = /custom/format/2/folder

配置步骤

1. 将Config.example.txt文件复制到同一目录下并命名为Config.txt
2. 编辑Config.txt文件，在[Radarr]部分替换为您的Radarr服务器URL和API密钥
3. 编辑Config.txt文件，在[CustomFormatMappings]部分替换__default映射为Radarr电影的默认文件夹（必填项）
4. 在__default下方添加其他自定义格式映射，键为自定义格式名称（区分大小写），值为该格式对应的目标文件夹。键和值均允许包含空格

使用方法

独立运行

建议通过cron每15分钟或根据需要的间隔运行

bash
pip install -r requirements.txt
python FolderOrganizer.py

如果在Windows上运行时出现ImportError: no module named 'requests'错误，需通过以下命令安装依赖：

bash
python -m pip install -r requirements.txt
python FolderOrganizer.py

Docker运行

bash
docker run -d --name radarr-folder-organizer \
        --restart=unless-stopped \
        -v /path/to/Config.txt:/Config.txt \
        -v /path/to/logs:/logs \
        -v /your/media/folder:/same/media/folder/as/radarr:shared \
        -e DELAY=15m \
        -e LOG_LEVEL=INFO \
        -e MOVE_DEFAULT=false \
        rubasace/radarr-folder-organizer

参数说明（通过环境变量传递）

避免Docker循环执行

默认情况下，Docker入口点会使脚本按15分钟（或配置的间隔）循环执行。如果将镜像作为cronjob运行（例如通过Kubernetes），可能不需要此行为。此时可将环境变量DELAY设置为DISABLED，使脚本仅执行一次后退出。

未知文件夹处理

本脚本仅影响Config.txt中明确包含的文件夹。如果发现电影位于其他文件夹，将显示消息：Current path ${Path} from movie ${MovieName} is not in the configuration file. Skipping to avoid possible errors。

若希望脚本移动这些电影，可添加相应映射（自定义格式不必实际存在）。

示例

假设Config.txt文件如示例所示，若收到消息Current path /media/cool_movies from movie Deadpool (2016) is not in the configuration file. Skipping to avoid possible errors，可添加如下映射：

ini
[CustomFormatMappings]
__default = /the/default/folder 
custom_format1 = /custom/format/1/folder
custom_format2 = /custom/format/2/folder
whatever_you_want = /media/cool_movies

系统要求

• Python 3.4或更高版本
• Radarr服务器

故障排除

默认日志级别为INFO，仅记录基本信息。遇到问题时，建议将日志级别设置为DEBUG。如发现功能异常，欢迎提交issue。

注意事项

• Radarr Folder Organizer会尝试移动文件，若移动失败则会中止电影更新，因此工具需要有权访问电影库文件
• 使用Docker时，确保挂载的卷与Radarr使用的卷相同