这款 Roon 扩展程序旨在为你带来更具沉浸感的音乐体验，通过精美的专辑封面展示，让你的 Roon 播放更加赏心悦目。它提供实时播放显示和艺术墙模式两种模式，满足你不同的展示需求。
✨ 核心功能
实时播放封面秀
- • 封面即时呈现: 同步 Roon 播放，实时显示当前播放曲目的专辑封面，让视觉与听觉同步律动。
- • 智能背景色: 自动提取专辑封面的主色调作为背景，营造和谐统一的视觉氛围。
- • 全屏沉浸: 支持全屏显示，放大视觉冲击力，带来更沉浸的体验。
- • 便捷全屏切换: 双击页面任意位置即可快速进入全屏模式，按下 ESC 键轻松退出。
艺术墙模式
- • 智能切换: 当音乐停止播放 15 秒后，自动优雅地切换到艺术墙模式。
- • 响应式网格布局: 横屏5列3行，竖屏3列5行（15个封面位置），充分利用不同屏幕方向的显示优势。
- • 动态刷新: 每 60 秒自动更新 6张图片，保持艺术墙的新鲜感和活力。
封面自动保存
- • 珍藏每一份感动: 自动保存所有播放过的专辑封面，为你记录音乐旅程中的美好瞬间。
- • 自定义目录: 支持自定义封面保存目录，方便你管理和整理。
- • 智能命名: 采用 “专辑名_图片键值” 的智能文件命名方式，让封面文件一目了然。
🚀 安装指南（Brain 系列系统）
🎯 一键部署（推荐）
本扩展程序特别为 Brain 系列系统用户优化，无需手动设置权限，一键即可完成部署：
# 创建工作目录并部署
mkdir -p /cache/Roonart && cd /cache/Roonart && \
docker run -d \
--name roon-coverart_16_9 \
--network host \
--restart unless-stopped \
-v /cache/Roonart/images:/app/images:rw \
-v /cache/Roonart/config.json:/app/config.json:rw \
epochaudio/coverart:16.9
🛠️ 使用指南
1. 访问扩展页面
在浏览器中访问 http://Brain主机IP地址:3666。你将看到 Roon Cover Art Extension 的展示页面。
2. Roon 中启用扩展
- 1. 打开 Roon 软件，进入 设置 (Settings) 菜单
- 2. 选择 扩展 (Extensions) 选项卡
- 3. 点击 启用扩展 (Enable Extensions) 按钮
- 4. Roon 会自动检测到
Cover Art 16:9扩展，点击 启用 (Enable)
3. 选择播放区域
- 1. 在 Roon 的 扩展设置 中，找到
Cover Art 16:9扩展 - 2. 在扩展设置中，选择你希望进行封面展示的 播放区域 (Zone)
4. 开始享受
现在，开始在 Roon 中播放音乐，你将在浏览器页面上看到精美的专辑封面展示，体验视觉与听觉的双重盛宴！
🎨 显示特性
画屏专用优化
- • 21.5寸画屏: 超大字体显示，远距离观看优化
- • 10寸画屏: 精致显示效果，中距离观看模式
- • 智能设备检测: 自动识别画屏尺寸并应用专用样式
响应式布局
- • 横屏模式: 5列 × 3行布局，充分利用宽屏显示优势
- • 竖屏模式: 3列 × 5行布局，优化垂直空间利用
- • 16:9适配: 完美适配各种16:9屏幕尺寸
🔧 容器管理
查看运行状态
docker ps | grep roon-coverart查看日志
docker logs roon-coverart_16_9重启容器
docker restart roon-coverart_16_9停止并删除容器
docker stop roon-coverart_16_9
docker rm roon-coverart_16_9更新到最新版本
# 停止并删除旧容器
docker stop roon-coverart_16_9
docker rm roon-coverart_16_9
# 拉取最新镜像
docker pull epochaudio/coverart:latest
# 重新运行容器（使用相同的命令）
docker run -d \
--name roon-coverart_16_9 \
--network host \
--restart unless-stopped \
-v /cache/Roonart/images:/app/images:rw \
-v /cache/Roonart/config.json:/app/config.json:rw \
epochaudio/coverart:latest🔍 故障排除
❓ 容器启动失败？
检查端口占用：
# 检查3666端口是否被占用
netstat -tulpn | grep 3666
# 如果被占用，可以停止占用该端口的进程或修改扩展端口❓ 无法访问页面？
可能原因：
- • 防火墙阻止了3666端口
- • 网络配置问题
解决方案：
# 检查防火墙状态
systemctl status firewalld
# 如需要，开放3666端口
firewall-cmd --permanent --add-port=3666/tcp
firewall-cmd --reload❓ Roon 中看不到扩展？
检查项：
- 1. 确保容器正在运行：
docker ps | grep roon-coverart - 2. 确保使用了
--network host参数 - 3. 重启 Roon 应用程序
- 4. 检查扩展日志：
docker logs roon-coverart_16_9
❓ 图片无法保存？
自动诊断：
由于新版本的权限优化，图片保存问题已经大大减少。如果仍有问题：
# 检查images目录
ls -la /cache/Roonart/
# 检查容器内权限
docker exec roon-coverart_16_9 ls -la /app/❓ 容器重启后需要重新授权？
这个问题在新版本中已经彻底解决！如果仍然遇到：
# 检查config.json文件是否存在
ls -la /cache/Roonart/config.json
# 查看配置文件内容（应该包含认证信息）
cat /cache/Roonart/config.json🏷️ 版本信息
v3.1.1 (权限优化版)
- • ✅ 重大优化: Docker权限自动处理，无需手动设置
- • ✅ 修复: Docker 重启后需要重新授权的问题
- • ✅ 新增: config.json 文件映射，确保认证信息持久化
- • ✅ 简化: 一键部署，大幅简化安装流程
- • ✅ 增强: 自动权限修复和容器安全性提升
- • ✅ 完善: 全面的故障排除指南和容器管理命令
主要技术改进
- • 容器内自动创建必要的目录和配置文件
- • 智能权限管理，消除权限相关问题
- • 以非root用户运行，提升安全性
- • 更强的错误处理和诊断能力
🎵 让音乐更美好
希望这个 Roon Cover Art Extension 能为你的音乐生活增添更多乐趣！专辑封面不再只是静态的图片，而是你音乐旅程的视觉记录。
如有任何疑问或建议，欢迎反馈！
技术支持：门耳朵制作
项目版本：3.1.1 For 16:9 screen
更新日期：2025年7月
