sentriz/betanin

betanin Docker镜像文档

镜像概述

betanin是一个基于beets.io的中间人服务，用于连接torrent客户端和音乐播放器。它能够自动处理下载的音乐文件，通过beets进行音乐管理，并支持多种通知方式，帮助用户高效管理音乐库。

!https://github.com/sentriz/betanin/raw/master/.github/logo.png

核心功能与特性

主要功能

• 作为torrent客户端与音乐播放器之间的中间层，自动处理下载的音乐文件
• 基于beets.io提供专业的音乐元数据管理、整理和组织功能
• 通过Web界面进行配置和管理
• 支持多种通知方式，及时反馈处理状态

通知支持

betanin使用https://github.com/caronc/apprise%E5%AE%9E%E7%8E%B0%E9%80%9A%E7%9F%A5%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E6%9C%8D%E5%8A%A1%EF%BC%8C%E5%8C%85%E6%8B%AC%EF%BC%9A

• 电子邮件

• ---

• ---

• Emby
• 以及其他apprise支持的通知服务

工作流程

!https://github.com/sentriz/betanin/raw/master/.github/flow.png

使用场景与适用范围

• 音乐爱好者通过torrent下载音乐后需要自动整理和管理音乐库
• 需要将下载的音乐自动导入音乐播放器的用户
• 希望通过通知及时了解音乐处理状态的用户
• 已使用beets进行音乐管理，需要与torrent客户端集成的用户

详细使用方法

Docker镜像拉取

bash
docker pull sentriz/betanin

Docker运行示例

bash
docker run -d \
  --name betanin \
  -p 9393:9393 \
  --restart unless-stopped \
  -e UID=1000 \
  -e GID=1000 \
  -v /path/to/betanin/data:/root/.local/share/betanin/ \
  -v /path/to/betanin/config:/root/.config/betanin/ \
  -v /path/to/beets/config:/root/.config/beets/ \
  -v /path/to/music:/music/ \
  -v /path/to/downloads:/downloads/ \
  sentriz/betanin

Docker Compose配置

yaml
betanin:
  image: sentriz/betanin
  ports:
    - 9393:9393
  restart: unless-stopped
  environment:
    - UID=1000  # 可选：设置用户ID
    - GID=1000  # 可选：设置组ID
  volumes:
    - ${DATA}/betanin/data:/root/.local/share/betanin/  # 持久化数据库
    - ${DATA}/betanin/config:/root/.config/betanin/    # 持久化betanin配置
    - ${DATA}/betanin/beets:/root/.config/beets/       # 持久化beets配置（如已有beets配置可指向现有目录）
    - ${MEDIA}/music:/music/                           # 音乐库目录
    - ${MEDIA}/downloads:/downloads/                   # 下载目录

卷挂载说明

环境变量配置

启动与访问

1. 启动容器后，Web界面将在 http://<host>:9393 可用
2. 首次启动会生成配置文件，需添加凭据后重启
3. 可通过环境变量修改默认主机和端口，例如：

   bash
   BETANIN_HOST=0.0.0.0 BETANIN_PORT=4030 docker start betanin
   

命令行工具

如需执行数据库操作或调试，可使用cli：

bash
# 非Docker环境
betanin-shell

# Docker环境
docker exec -it <container_id> betanin-shell

与Torrent客户端集成

Transmission配置

1. 创建完成脚本 done.sh 并设置执行权限：

   bash
   chmod +x done.sh
   

2. 编辑Transmission配置文件 settings.json（示例片段）：

   json
   {
     "script-torrent-done-enabled": true,
     "script-torrent-done-filename": "/scripts/done.sh",
     ...
   }
   

3. 编写完成脚本内容：

   bash
   #!/bin/sh
   
   curl \
     --request POST \
     --data-urlencode "path=<path_to_transmission_downloads>" \
     --data-urlencode "name=$TR_TORRENT_NAME" \
     --header "X-API-Key: <your_api_key>" \
     "https://betanin.example.com/api/torrents"
   

4. Transmission Docker Compose配置（片段）：

   yaml
   volumes:
     - ${DATA}/transmission/config:/config
     - ${DATA}/transmission/scripts:/scripts
     - ${MEDIA}/download:/downloads
   

Deluge配置

1. 创建完成脚本 done.sh 并设置执行权限：

   bash
   chmod +x done.sh
   

2. 确保已安装Deluge的Execute插件，并设置为"Torrent Complete"事件触发

3. 编写完成脚本内容：

   bash
   #!/bin/sh
   
   curl \
     --request POST \
     --data-urlencode "path=<path_to_deluge_downloads>" \
     --data-urlencode "name=$2" \
     --header "X-API-Key: <your_api_key>" \
     "https://betanin.example.com/api/torrents"
   

界面截图

!https://github.com/sentriz/betanin/raw/master/.github/scrot_1.png !https://github.com/sentriz/betanin/raw/master/.github/scrot_2.png !https://github.com/sentriz/betanin/raw/master/.github/scrot_3.png !https://github.com/sentriz/betanin/raw/master/.github/scrot_4.png