如何用小爱同学打造专属音乐中心？xiaomusic终极指南 🎵

xiaomusic是一款开源音乐播放工具，能让你的小爱音箱播放海量音乐，所有音乐资源通过yt-dlp自动下载，无需手动操作。支持Web界面管理，轻松实现语音控制、个性化配置，让普通音箱秒变智能音乐中心！

🚀 3分钟快速上手：从安装到播放

一键安装步骤

1. 环境准备
   确保已安装Python 3.8+，执行以下命令安装依赖：

git clone https://gitcode.com/gh_mirrors/xia/xiaomusic
cd xiaomusic && bash install_dependencies.sh

2. 基础配置
   复制配置模板并修改：

cp config-example.json config.json

在config.json中填入小米账号信息，保存后启动服务：

python xiaomusic.py

3. 访问管理界面
   打开浏览器访问 http://localhost:8090，首次登录会引导完成设备配对 🔗

最快使用技巧

• 语音指令模板：直接对小爱说 播放歌曲[歌名] 或 播放歌手[歌手名]的歌
• Web端批量操作：进入 tailwind/m3u.html 页面可管理播放列表
• 插件扩展：通过 plugins/ 目录添加自定义功能，如音量调节插件 setmyvolume.py

⚙️ 常见问题速解方案

设备连接失败？90%的人忽略这步！

检查 网络环境：小爱音箱与服务器必须在同一局域网！可通过 xiaomusic/cli.py 测试连接：

python xiaomusic/cli.py --test-connection

音乐下载慢？启用缓存加速 ⚡

1. 在配置文件中设置缓存目录：

"download": {
  "cache_dir": "./music_cache",
  "max_cache_size": "10G"
}

2. 重启服务后自动生效，已下载歌曲秒开播放 🚀

语音指令无响应？日志排查法

问题日志保存在 xiaomusic/logs/，重点关注：

• 设备认证错误：检查小米账号密码是否正确
• 网络超时：可能需要配置代理（详见 docs/issues/network.md）

🛠️ 进阶功能探索

节日主题自动切换

项目内置节日日历功能（holiday/ 目录），支持根据节气自动更换播放列表封面。2025年节假日数据已更新至 holiday/2025.json ✨

自定义Web界面

修改 xiaomusic/static/tailwind/ 目录下的CSS文件，可定制管理界面主题。官方提供3套模板：

• 默认主题：static/default/
• 纯净模式：static/pure/
• 高级播放器：static/xplayer/

📚 官方资源导航

• 完整文档：docs/index.md
• 插件开发指南：plugins/__init__.py
• 常见问题库：docs/issues/

遇到疑难问题？可提交issue到项目仓库，或加入社区讨论群获取实时支持 👥

💡 小贴士：定期执行 bash update-holiday.sh 可同步最新节假日数据，让音乐推荐更应景哦！