优雅的 Roon 专辑封面显示工具,让您的音乐聆听体验更加视觉化。
- 优化非触摸设备的交互体验
- 平时自动隐藏鼠标指针
- 移动鼠标时显示指针
- 悬停在按钮上时保持显示
- 改进按钮交互效果
- 悬停时按钮亮度提升
- 更流畅的过渡动画
- 优化封面图片显示
- 保持原生显示效果
- 轻微的悬停放大效果
- 触摸设备适配
- 移除不必要的悬停效果
- 优化触摸反馈
- 专辑封面显示(可选4K分辨率)
- 完整的播放控制功能
- 主题切换(深色、主色调、封面背景)
- 实时播放状态更新
- 桌面通知支持
- 响应式设计,自动字体缩放
- 两种显示模式(标准和全屏)
- 区域选择状态保持
- WebSocket 实时连接
- Docker 容器化部署
- Docker
- Roon Core 已安装并运行
- 现代网页浏览器
- 创建
docker-compose.yml
文件:
version: '3'
services:
roonalbumart:
image: epochaudio/roonalbumart:latest
container_name: roonalbumart
ports:
- "3666:3666"
restart: unless-stopped
- 运行容器:
docker-compose up -d
docker run -d \
--name roonalbumart \
--network host \
--restart unless-stopped \
epochaudio/roonalbumart:latest
- 启动服务后,打开浏览器访问:
http://<你的IP>:3666
- 首次使用时,需要在 Roon Core 中授权此扩展
- 在界面中选择您要控制的 Roon 区域(Zone)
-
标准播放界面 (
/nowplaying.html
)- 专辑封面和播放信息显示
- 播放控制(播放/暂停、上一曲/下一曲)
- 音量控制和播放设置(循环、随机、电台)
- 可选4K专辑封面显示
- 支持主题切换
- 可选桌面通知
-
全屏模式 (
/fullscreen.html
)- 优雅的翻页时钟显示(小时:分钟)
- 最大化的专辑封面显示
- 智能背景主题(支持封面模糊、主色调、深色三种模式)
- 简洁的页面切换按钮
- 优雅的授权等待提示
- 自动字体缩放
- 沉浸式显示体验
- 标准模式:适合近距离操作,提供完整控制功能
- 全屏模式:适合远距离观看,突出视觉体验
- 通过界面右上角的切换按钮随时切换模式
- 支持不同主题风格
- 自动适应屏幕尺寸
- 保持与标准模式相同的区域选择
提示:根据使用场景选择合适的显示模式:
- 桌面使用:标准播放界面
- 远距离观看:全屏模式
- 跨平台支持:支持所有主流桌面和移动端浏览器
- 高清显示:专辑封面占据98%屏幕宽度,保持原始比例
- 智能适配:自动适应不同设备和屏幕尺寸
- 简洁界面:仅保留必要的控制按钮
- 优雅过渡:平滑的动画效果和背景模糊
- 访问全屏页面
- 点击左上角全屏按钮
- 按 ESC 或点击右上角按钮退出
- 使用 Chrome 或其他主流浏览器访问
- 点击左上角全屏按钮
- 允许全屏权限请求
- 使用返回键或右上角按钮退出
- 使用 Safari 浏览器访问
- 点击分享按钮
- 选择"添加到主屏幕"
- 从主屏幕图标启动,获得最佳全屏体验
- Chrome/Edge/Firefox:完整支持全屏功能
- Safari:完整支持,iOS 设备建议使用"添加到主屏幕"
- 其他主流浏览器:基本支持全屏功能
- iOS 设备请使用 Safari 浏览器获得最佳体验
- 确保浏览器已允许全屏权限
- 如遇全屏异常,请尝试刷新页面
本项目基于以下开源项目进行开发:
- Roon Web Controller - 原始项目由 Mike Plugge 开发
- Roon Web Controller (Miemo Fork) - 提供了界面优化版本
特别感谢:
- Mike Plugge (@pluggemi) 创建了最初的 Roon Web Controller
- Miemo Penttinen 提供了界面优化版本
- Roon Labs 提供了优秀的音乐播放器和 API
- 所有为这个项目做出贡献的开发者