Roon Cover Art Extension – 沉浸式专辑封面展示，为你的音乐聆听增添色彩

这款 Roon 扩展程序旨在为你带来更具沉浸感的音乐体验，通过精美的专辑封面展示，让你的 Roon 播放更加赏心悦目。它提供实时播放显示和艺术墙模式两种模式，满足你不同的展示需求。

✨ 核心功能

1. 实时播放封面秀 (Real-time Playback Display)
   • 封面即时呈现: 同步 Roon 播放，实时显示当前播放曲目的专辑封面，让视觉与听觉同步律动。
   • 智能背景色: 自动提取专辑封面的主色调作为背景，营造和谐统一的视觉氛围。
   • 全屏沉浸: 支持全屏显示，放大视觉冲击力，带来更沉浸的体验。
   • 便捷全屏切换: 双击页面任意位置即可快速进入全屏模式，按下 ESC 键轻松退出。
2. 艺术墙模式 (Art Wall Mode)
   • 智能切换: 当音乐停止播放 15 秒后，自动优雅地切换到艺术墙模式。
   • 创意网格布局: 采用 4×2 网格布局，8 个位置随机展示已播放过的专辑封面，打造个性化的艺术墙。
   • 动态刷新: 每 60 秒自动更新 4 张封面，保持艺术墙的新鲜感和活力。
3. 封面自动保存 (Automatic Save Function)
   • 珍藏每一份感动: 自动保存所有播放过的专辑封面，为你记录音乐旅程中的美好瞬间。
   • 自定义目录: 支持自定义封面保存目录，方便你管理和整理。
   • 智能命名: 采用 “专辑名” 的智能文件命名方式，让封面文件一目了然。

🚀 安装指南 (Brain 系列系统)

本扩展程序特别为 Brain 系列系统用户设计，安装简单快捷：

mkdir -p /cache/Roonart/images && \
chown -R 1000:1000 /cache/Roonart/images && \
chmod -R 755 /cache/Roonart/images && \
docker run -d \
  --name roon-coverart_16_9 \
  --network host \
  --restart unless-stopped \
  -v /cache/Roonart/images:/app/images \
  epochaudio/coverart:16.9

安装步骤详解:

1. 创建目录: mkdir -p /cache/Roonart/images – 在 /cache/Roonart/ 目录下创建 images 文件夹，用于存放专辑封面。
2. 修改所有者: chown -R 1000:1000 /cache/Roonart/images – 将 images 文件夹及其内部文件的所有者和用户组更改为 1000:1000，这是为了确保 Docker 容器可以正常访问该目录。
3. 修改权限: chmod -R 755 /cache/Roonart/images – 设置 images 文件夹及其内部文件的权限为 755 (所有者读写执行，用户组和其他用户只读执行)，确保 Docker 容器具有读取和写入封面的权限。
4. 运行 Docker 容器:
   • docker run -d – 在后台运行 Docker 容器。
   • --name roon-coverart_16_9 – 为容器指定名称为 roon-coverart_16_9，方便后续管理。
   • --network host – 使用 host 网络模式，使容器与宿主机共享网络，简化网络配置。
   • --restart unless-stopped – 设置容器重启策略为 unless-stopped，即除非手动停止，否则容器会在重启后自动启动。
   • -v /cache/Roonart/images:/app/images – 将宿主机的 /cache/Roonart/images 目录挂载到容器内的 /app/images 目录，实现封面文件的持久化存储。
   • epochaudio/coverart:16.9 – 指定使用的 Docker 镜像为 epochaudio/coverart:16.9。

🛠️ 使用指南

1. 访问扩展页面: 在浏览器中访问 http://Brain主机IP地址:3666 。你将看到 Roon Cover Art Extension 的展示页面。
2. Roon 中启用扩展:
   • 打开 Roon 软件，进入 设置 (Settings) 菜单。
   • 选择 扩展 (Extensions) 选项卡。
   • 点击 启用扩展 (Enable Extensions) 按钮。
   • Roon 会自动检测到 roon-coverart_16_9 扩展，点击 启用 (Enable)。
3. 选择播放区域:
   • 在 Roon 的 扩展设置 中，找到 roon-coverart_16_9 扩展。
   • 在扩展设置中，选择你希望进行封面展示的 播放区域 (Zone)。
4. 开始享受吧! 现在，开始在 Roon 中播放音乐，你将在浏览器页面上看到精美的专辑封面展示，体验视觉与听觉的双重盛宴！

希望这个 Roon Cover Art Extension 能为你的音乐生活增添更多乐趣! 如有任何疑问或建议，欢迎反馈。