epochaudio/roon-art

Roon艺术墙：优雅展示您的音乐收藏

https://img.shields.io/badge/license-Apache%202.0-blue.svg](LICENSE)

Roon艺术墙是为Roon音乐库打造的沉浸式视觉展示系统，通过3D翻转动画将专辑封面转化为动态艺术墙，提升音乐欣赏的视觉体验。

✨核心特性

• 全屏自适应布局：适配各类屏幕尺寸，自动调整封面排列。
• 动态刷新：每60秒更新一批封面，保持内容新鲜感。
• 3D翻转动画：独特的扑克牌翻转效果，增强视觉趣味。
• 卓越性能优化：图片预加载、智能缓存、批量DOM更新、懒加载技术，确保流畅体验。

🚀快速上手

推荐使用Docker部署以简化流程。

🐳 Docker方式（推荐）

方式一：docker run命令

替换/path/to/your/Roon/art为实际Roon艺术图片目录：

bash
docker run -d \
  --name roon-art \
  -p 3090:3090 \
  -v /path/to/your/Roon/art:/app/art \
  --restart unless-stopped \
  epochaudio/roon-art:latest

方式二：docker-compose

创建docker-compose.yml文件：

yaml
version: '3'
services:
  roon-art:
    image: epochaudio/roon-art:latest
    ports:
      - "3090:3090"
    volumes:
      - /path/to/your/Roon/art:/app/art # 替换为实际目录
    restart: unless-stopped

启动服务：docker-compose up -d

⚙️配置Roon Core

1. 启用“艺术刮刀”扩展：在Roon Core设置中找到并启用。
2. 配置扩展：选择高质量图片，设置下载数量1000-5000张。
3. 启动封面下载：等待进度完成。

🖼️欣赏艺术墙

1. 等待封面下载完成。
2. 访问http://localhost:3090即可查看动态艺术墙。

⚠️重要提示：

• 必须等待封面下载完成再访问，否则无法显示图片。
• 首次下载需一定时间，请耐心等待。
• 确保目录映射正确且容器有读取权限。
• Roon艺术图片目录位置：
  • Windows：C:\Users\YourUsername\AppData\Local\Roon\Application Data\Roon\art
  • macOS：/Users/YourUsername/Library/Application Support/Roon/Application Data/Roon/art
  • Linux：/home/YourUsername/.roon/Application Data/Roon/art

🛠️源码构建（开发者）

1. 克隆仓库：git clone https://github.com/epochaudio/RoonArtWall.git && cd RoonArtWall
2. 构建并启动：docker-compose up -d --build
3. 访问：http://localhost:3090

🔨手动安装

1. 克隆仓库：git clone https://github.com/yourusername/roon-art-wall.git && cd roon-art-wall
2. 安装依赖：npm install && cd art-wall && npm install && cd ..
3. 启动服务：npm start
4. 访问：http://localhost:3090

🧑‍💻开发指南

📚环境要求

• Node.js 20.x及以上
• 现代浏览器（Chrome/Firefox/Safari）
• 推荐独立显卡设备以优化动画效果

📂目录结构

roon-art-wall/
├── art/                # Roon图片存放目录
│   ├── Albums/        # 专辑封面
│   └── Artists/       # 艺术家图片
├── art-wall/          # 前端应用
│   ├── public/        # 静态资源
│   └── server.js      # 前端服务器
├── css/               # 样式文件
├── js/                # JS文件
└── art-scraper.js     # 图片抓取脚本（可选）

✍️开发规范

• 代码风格：ES6+，遵循ESLint规范。
• Git提交规范：feat/fix/docs/style/refactor/test/chore前缀。
• 贡献流程：Fork仓库→创建分支→提交变更→推送→PR。

🖼️图片尺寸选项

Roon扩展支持三种尺寸：

• 小图：225x225像素
• 中图：500x500像素（默认）
• 大图：1000x1000像素

🚀权限设置

容器使用node用户（UID:1000）运行，若遇权限问题：

1. 宿主机设置权限：

bash
sudo chown -R 1000:1000 /path/to/your/Roon/art
sudo chmod -R 755 /path/to/your/Roon/art
sudo chmod 777 /path/to/your/Roon/art/Albums

2. Docker Compose添加用户映射：

yaml
services:
  roon-art:
    user: "1000:1000"

⚙️配置说明（手动安装）

1. 启动后在Roon设置启用“艺术刮刀”扩展。
2. 配置：选择下载类型（专辑/艺术家）、图片尺寸、最大数量（1-***）。

💾下载位置（手动安装）

• 专辑封面：art/Albums/
• 艺术家图片：art/Artists/

⚠️注意事项

• 自动过滤文件名特殊字符。
• 下载失败自动重试3次。
• 强烈推荐Docker部署。

📜版本历史

• v2.0.3：优化性能、改进动画、增加重试机制。
• v1.0.1：添加数量限制、优化中文显示、改进错误处理。
• v0.1.1：初始版本发布。

📄许可证

采用Apache License 2.0。

🤝技术支持

• ：
• 网站：[***]

🙏致谢

感谢Roon Labs提供API支持，感谢TheAppgineer/roon-extension-art-scraper项目灵感。 ===END===