ofark/compressarr

Compressarr 镜像文档

概述

Compressarr是一个与Radarr和Sonarr集成的媒体压缩工具，通过FFmpeg对媒体库项目进行重新压缩。它支持自定义压缩选项或自动计算参数，能够在保持视频质量的同时优化文件大小，且作业会记住过滤条件而非具体文件，便于后续处理新匹配的媒体文件。

核心功能与特性

与Radarr/Sonarr集成

• 可过滤Radarr和Sonarr中的媒体项目进行处理
• 作业基于过滤条件而非具体文件，新匹配的文件可后续处理

FFmpeg完全控制

• 支持自定义编解码器（系统中安装的任何FFmpeg支持的编解码器）
• 可配置音频、视频、映射等参数，仅固定比特率下自动启用2 pass编码
• 提供质量维护与压缩优化的自动猜测计算功能

预设管理

• 可创建FFmpeg预设，包含输出容器（如Matroska）、视频编解码器（如libx265）、音频编解码器（支持复制）
• 编解码器选项可自定义，支持比特率、CRF值、预设（Preset）和调优（Tune）等参数配置

作业与自动导入

• 支持创建作业，关联过滤器、FFmpeg预设及文件路径
• 自动导入功能可通知Radarr/Sonarr导入新编码文件，支持SSIM（结构相似性）检查和压缩率检查
• 失败处理机制：单个文件编码失败不影响后续文件处理

自动计算功能

• 可测试编码器配置中的各选项，自动选择接近原视频质量且文件大小达标的参数
• 支持自定义视频采样长度，优化计算效率

使用场景与适用范围

• 媒体库管理员需要压缩视频文件以节省存储空间
• 希望在保持可接受质量的前提下优化媒体文件大小
• 需要与Radarr/Sonarr配合，自动处理新添加的媒体文件
• 对FFmpeg参数有一定了解，需要灵活控制压缩过程的用户

使用方法与配置说明

前置要求

• Radarr或Sonarr实例及对应的API密钥
• 媒体文件存储路径需与Radarr/Sonarr保持一致，确保Compressarr可访问

配置步骤

1. 配置Radarr/Sonarr连接

在选项页面输入Radarr/Sonarr的URL和API密钥，建立连接。

2. 创建过滤器

在Radarr/Sonarr页面通过顶部下拉选项选择过滤条件，或双击列标题按列过滤，保存并命名过滤器。

3. 定义FFmpeg预设

在FFmpeg页面创建预设：

• 输入预设名称
• 选择输出容器（如Matroska）
• 选择视频编解码器（如libx265）和音频编解码器（可选择复制）
• 配置编解码器选项：
  • 固定比特率：设置视频比特率
  • libx系列编解码器：可设置CRF值、预设（建议Slow）和调优（建议Fast Decode）
• 底部可预览最终传递给FFmpeg的命令参数

4. 创建作业

在作业页面创建作业：

• 选择过滤器和FFmpeg预设
• 设置Base文件夹和Destination文件夹
• 配置自动导入选项（可选）：
  • SSIM检查：设置最低相似度要求
  • 压缩率检查：设置新文件相对于原文件的最大允许大小百分比（建议95%）
• 测试作业配置，确认路径正确后启动编码过程

关键路径说明

Base文件夹

• 设置文件路径起点，通常留空，Compressarr会自动拼接Radarr/Sonarr的文件路径
• 若配置错误，作业测试会显示实际查找路径，便于调试

Destination文件夹

• 必须对Radarr/Sonarr可见，用于自动导入功能
• Compressarr会将完整文件路径传递给Radarr/Sonarr进行导入

安装与部署

Docker部署

需映射与Radarr/Sonarr相同的媒体卷，确保路径一致性。对于NVIDIA CUDA支持，需指定GPU设备ID。

示例Docker Run命令：

bash
docker run -d \
  --name=compressarr \
  -v /path/to/config:/config \
  -v /path/to/media:/media \  # 与Radarr/Sonarr相同的媒体卷映射
  -e NVIDIA_VISIBLE_DEVICES=0 \  # 仅NVIDIA版本需要，指定GPU ID（参考NVIDIA容器工具包文档）
  --restart unless-stopped \
  ofark/compressarr

其他平台

• Windows：直接运行Compressarr.exe
• Linux：运行Compressarr可执行文件
• Mac：依赖.NET Core 5运行时，具体操作未测试

应用启动时会自动下载最新版本的FFmpeg

配置文件说明

所有用户配置通过UI完成，高级配置文件位于/config目录（Docker环境）：

• appsettings.json：配置日志级别、日志目录和输出方式（文件、控制台、调试器）
• CodecOptions/：编解码器选项模板目录，JSON格式文件，文件名需与编解码器名称一致（区分大小写），包含编解码器的可用配置选项

已知问题

• Sonarr可连接，但目前无过滤器构建界面

注意事项

压缩过程会重建视频文件，启用自动导入时可能覆盖现有文件（取决于Radarr/Sonarr的设置）。建议先测试输出效果，确认满足需求后再启用自动导入功能。

支持与资源

• GitHub：https://github.com/OFark/Compressarr%EF%BC%88%E9%A1%B9%E7%9B%AE%E6%94%AF%E6%8C%81%E3%80%81%E6%96%87%E6%A1%A3%E5%92%8C%E6%BA%90%E7%A0%81%EF%BC%89
• Docker Hub：https://hub.docker.com/r/ofark/compressarr%EF%BC%88Docker%E9%95%9C%E5%83%8F%EF%BC%89
• Unraid论坛：[***]