epochaudio/coverart_docker

Roon Cover Art Docker镜像

镜像概述

本镜像为Roon Cover Art的16:9显示版本，专为电视、宽屏显示器和嵌入式显示设备设计，提供直观的音乐播放可视化体验。

核心功能

• 实时显示Roon当前播放的专辑封面
• 展示标题、艺术家、专辑等元数据信息
• 停止播放后自动切换至封面墙模式
• 自动缓存已播放的专辑封面
• Roon配对信息持久化存储
• 支持浏览器触摸控制
• 可通过Docker端直接监听宿主机键盘事件控制Roon

使用场景

• 家庭影院系统的音乐播放可视化
• 嵌入式显示设备（如智能音箱屏幕）的音乐界面
• 宽屏显示器上的音乐播放状态展示

配置说明

镜像版本

bash
epochaudio/coverart_docker:5.0.3
epochaudio/coverart_docker:latest

快速安装

1. 准备数据目录：

bash
mkdir -p ./roon-coverart_data/images
printf '%s\n' '{}' > ./roon-coverart_data/config.json

2. 运行容器：

bash
docker run -d \
  --name roon-coverart \
  --network host \
  --restart unless-stopped \
  --device /dev/input:/dev/input \
  --device-cgroup-rule 'c 13:* rwm' \
  -e KEYBOARD_ENABLED=true \
  -e KEYBOARD_DEBOUNCE_MS=180 \
  -v "$(pwd)/roon-coverart_data/images:/app/images" \
  -v "$(pwd)/roon-coverart_data/config.json:/app/config.json:rw" \
  -v /dev/input/by-id:/dev/input/by-id:ro \
  -v /dev/input/by-path:/dev/input/by-path:ro \
  epochaudio/coverart_docker:latest

3. 访问地址：http://宿主机IP:3666

注意：若宿主机无/dev/input/by-id或/dev/input/by-path，可删除对应-v参数；若Docker不支持--device-cgroup-rule，可删除该参数。

更新容器

bash
docker pull docker.xuanyuan.run/epochaudio/coverart_docker:latest
docker stop roon-coverart
docker rm roon-coverart
# 重新执行上述docker run命令（保留数据目录）

键盘控制

容器可监听宿主机键盘事件，无需浏览器焦点。默认按键：

• 右方向键/下一曲媒体键：下一曲
• 左方向键/上一曲媒体键：上一曲
• 空格/播放暂停媒体键：播放/暂停
• 上方向键/播放键：播放
• 下方向键/停止键：停止
• 暂停键：暂停

配置选项：

• 启用键盘监听：-e KEYBOARD_ENABLED=true（默认）
• 关闭键盘监听：-e KEYBOARD_ENABLED=false
• 指定单个键盘设备：-e KEYBOARD_DEVICE=/dev/input/by-id/your-keyboard-event-kbd
• 指定多个设备：-e KEYBOARD_DEVICES=/dev/input/by-id/kbd1,/dev/input/by-id/kbd2

注意：若启动后插入键盘，需执行docker restart roon-coverart生效。

OpenWrt / EpochBrain支持

部分系统提供一键安装脚本install_coverart.sh，可直接运行；若无脚本，使用通用Docker安装方式即可。脚本可能使用约定数据目录（如/cache/roon-coverart_data）。