如何用XiaoMusic让小爱音箱秒变智能音乐播放器：2025超详细配置指南

XiaoMusic是一款基于Python开发的开源工具，能让你的小爱音箱突破限制，通过yt-dlp下载并播放海量在线音乐。本文将带你从0到1完成安装配置，让普通音箱变身智能音乐中心 🎵

📋 准备工作：5分钟搞定环境搭建

系统要求

• Python 3.7+ 环境
• 已联网的小爱音箱
• Git工具（用于克隆项目）

一键安装依赖

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/xia/xiaomusic
cd xiaomusic

# 运行依赖安装脚本
chmod +x install_dependencies.sh
./install_dependencies.sh

⚙️ 核心配置：3步完成基础设置

第一步：创建配置文件

复制示例配置并修改个人信息：

cp config-example.json config.json

用文本编辑器打开config.json，填入小米账号信息和音箱IP地址

第二步：启动服务

# 直接运行
python xiaomusic.py

# 或使用进程守护（后台运行）
supervisord -c supervisord.conf

第三步：访问Web管理界面

打开浏览器访问 http://你的IP:8090，首次登录需扫码绑定小爱音箱

🎧 高级功能：解锁小爱音箱新玩法

语音控制指令大全

• 播放控制："小爱同学，播放周杰伦的歌"
• 音量调节："小爱同学，设置音量为50%"
• 定时播放："小爱同学，明天早上7点播放新闻联播"

插件扩展功能

项目提供丰富插件系统，可实现：

• HTTP请求控制：plugins/httpget.py
• 音量自定义：plugins/setmyvolume.py

🔧 常见问题解决

无法连接小爱音箱？

1. 确保音箱与服务器在同一局域网
2. 检查防火墙是否开放8090端口
3. 重启音箱后重试连接

音乐下载失败？

• 检查网络连接是否正常
• 更新yt-dlp到最新版本：pip install --upgrade yt-dlp
• 查看日志文件排查错误：tail -f xiaomusic.log

📊 项目结构速览

xiaomusic/
├── 核心模块：cli.py(命令行)、config.py(配置)
├── 工具函数：utils.py
├── Web界面：static/
└── 插件目录：plugins/

🎯 总结

通过XiaoMusic，你只需简单几步就能让小爱音箱实现强大的音乐播放功能。无论是本地音乐管理还是在线资源获取，这款工具都能完美胜任。立即尝试，开启智能音乐新生活！

提示：定期运行update-static-version.py可获取最新功能更新，关注项目docs/目录获取官方文档