tianon/beets

beets Docker镜像

beets官方网站

镜像概述

beets Docker镜像是音乐库管理工具beets的容器化实现。beets是一款功能强大的命令行音乐库管理工具，专注于音乐文件的整理、元数据标记与组织。通过Docker镜像形式分发，用户可避免本地环境配置复杂问题，实现跨平台、隔离化的音乐库管理。

核心功能与特性

• 元数据自动化处理：支持从多种数据源（如MusicBrainz、Discogs）自动匹配并校正音乐元数据（标题、艺术家、专辑、流派等）
• 音乐文件整理：按自定义规则（如$artist/$album/$track - $title）自动重命名和组织文件目录结构
• 格式兼容性：支持MP3、FLAC、AAC、OGG等多种音频格式，可处理封面图片嵌入
• 重复文件检测：通过音频指纹识别和元数据比对，识别并标记重复音乐文件
• 扩展性：支持插件系统，可扩展功能（如Last.fm集成、声学指纹生成、ReplayGain计算等）
• 命令行高效操作：通过简洁子命令实现批量处理，适合脚本化和自动化管理

使用场景

• 个人音乐库整理：统一管理散落的音乐文件，规范命名与元数据
• 音乐收藏维护：定期更新音乐元数据，清理重复文件，保持收藏整洁
• 媒体服务器准备：为Plex、Emby、Kodi等媒体服务器预处理音乐文件，确保识别准确性
• 音频格式标准化：批量转换音乐文件至指定格式，统一播放体验

使用方法

前置准备

1. 创建beets配置目录（用于持久化配置文件）：

   bash
   mkdir -p "$HOME/.config/beets"
   

2. （可选）在配置目录中创建config.yaml文件，自定义beets行为（参考beets配置文档）

基本运行命令

bash
docker run -it --rm \
  -u "$(id -u):$(id -g)" \
  -v "$PWD:/cwd" \
  -w /cwd \
  -v "$HOME/.config/beets:$HOME/.config/beets" \
  -e HOME \
  tianon/beets \
  beet <子命令>

参数说明

常用子命令示例

• 导入音乐文件（自动标记并整理）：

  bash
  docker run -it --rm -u "$(id -u):$(id -g)" -v "$PWD:/cwd" -w /cwd -v "$HOME/.config/beets:$HOME/.config/beets" -e HOME tianon/beets beet import ./music
  

  注：./music为宿主机待导入的音乐文件目录（需在当前工作目录下）

• 列出音乐库内容：

  bash
  docker run -it --rm -u "$(id -u):$(id -g)" -v "$PWD:/cwd" -w /cwd -v "$HOME/.config/beets:$HOME/.config/beets" -e HOME tianon/beets beet list
  

• 更新元数据（重新匹配选中文件的元数据）：

  bash
  docker run -it --rm -u "$(id -u):$(id -g)" -v "$PWD:/cwd" -w /cwd -v "$HOME/.config/beets:$HOME/.config/beets" -e HOME tianon/beets beet update <查询条件>
  

注意事项

• 首次使用需通过beet config子命令生成默认配置文件，或手动创建config.yaml
• 挂载目录权限需确保宿主机用户对挂载的音乐目录和配置目录有读写权限
• 复杂功能（如插件安装）需通过修改配置文件或在容器内执行beet plugin命令实现
• 详细子命令与配置说明可参考beets官方文档