ADDARR

概述

ADDARR是一款*** Bot，主要用于通过简单命令向Sonarr添加剧集或向Radarr添加电影，同时支持管理Transmission的下载/上传速度，提供安全认证机制及多语言支持，适用于家庭媒体服务器的远程管理场景。

核心功能与特性

• 向Sonarr/Radarr添加剧集或电影
• 获取Sonarr上所有剧集的列表
• 调整Transmission的下载/上传速度（临时速度限制）
• 密码保护机制，新聊天需先认证才能使用
• 错误登录尝试记录于addarr.log日志文件
• 可配置仅允许管理员使用Transmission命令
• 支持自定义命令入口点
• 提供英文和荷兰语两种语言版本
• 内置命令概览帮助功能

命令说明

默认命令如下：

• /help：显示所有命令及其功能说明
• /auth：认证当前聊天以使用Bot功能
• /start：启动添加剧集或电影到Sonarr/Radarr的流程
• /movie（英文）//film（荷兰语）：直接启动向Radarr添加电影的流程
• /series（英文）//serie（荷兰语）：直接启动向Sonarr添加剧集的流程
• /allSeries：获取Sonarr上所有剧集的列表（包含标题、年份、状态及监控状态）
• /transmission：切换Transmission的下载/上传速度（在临时速度限制与正常速度间切换）
• /stop：随时停止当前执行的命令

所有命令支持不带/前缀的纯文本形式，只要消息中仅包含命令关键词

配置指南

1. 从项目仓库获取配置文件示例config_example.yaml
2. 根据实际环境修改配置参数（如Sonarr/Radarr/Transmission的连接信息、Bot Token、密码等）
3. 修改完成后将文件重命名为config.yaml

管理员设置

若需限制仅管理员使用Transmission命令：

1. 在config.yaml中启用管理员权限功能
2. 创建admin.txt文件，添加管理员的username或id（每个用户占一行）

安装方法

详细安装指南可参考项目Wiki页面，支持以下系统：

• FreeBSD
• Docker
• Windows
• Linux

使用场景

• 家庭媒体服务器用户远程管理Sonarr/Radarr内容库
• 需要临时调整Transmission下载速度的场景（如夜间全速下载、白天限速）
• 多用户使用环境下的权限控制（通过管理员设置限制敏感操作）
• 非技术用户通过简单***命令管理媒体资源