如果你有小爱音箱,那么一定不能错过这个开源项目。
你只需要对小爱同学说:搜索播放林俊杰,你的小爱音箱就会播放所有林俊杰的歌。
这很正常。但厉害的是:
如果你没有林俊杰的歌,它会去搜索下载网络音乐。然后你就有林俊杰的歌了。

主要功能
- 支持通过 Docker 一键部署
- 支持多种音频格式(mp3、flac、wav、ogg、m4a)+本地/网络歌单
- 配置简便:一个 music 目录、一个 conf 目录即可,Web 界面可调整参数
- 支持语音口令控制:“播放歌曲 XXX”“下一首”“随机播放”“播放列表 XXX” 等
- 支持众多小爱音箱
到底能干什么?
一句话描述:用语音控制小爱音箱播发音乐,当没有音乐时,它去下载,然后播放音乐。
大概,就是这样。
这里有很详细的文档,感兴趣的同学可以试试。
安装指南:你至少需要一个 Docker 环境才能部署。并且需要提供小米账号密码(该项目开源,账号密码是提供给这个 Docker 容器的)
安全提示
- 如果配置了公网访问 xiaomusic ,请一定要开启密码登陆,并设置复杂的密码。且不要在公共场所的 WiFi 环境下使用,否则可能造成小米账号密码泄露。
- 强烈不建议将小爱音箱的小米账号绑定摄像头,代码难免会有 bug ,一旦小米账号密码泄露,可能监控录像也会泄露。
音乐来源
- bilisearch
- yt-dlp
已测试支持的设备
| 型号 | 名称 |
|---|---|
| L06A | 小爱音箱 |
| L07A | Redmi小爱音箱 Play |
| S12/S12A/MDZ-25-DA | 小米AI音箱 |
| LX5A | 小爱音箱 万能遥控版 |
| LX05 | 小爱音箱Play(2019款) |
| L15A | 小米AI音箱(第二代) |
| L16A | Xiaomi Sound |
| L17A | Xiaomi Sound Pro |
| LX06 | 小爱音箱Pro |
| LX01 | 小爱音箱mini |
| L05B | 小爱音箱Play |
| L05C | 小米小爱音箱Play 增强版 |
| L09A | 小米音箱Art |
| LX04 X10A X08A | 已经支持的触屏版 |
| X08C X08E X8F | 已经不需要设置了. ~需要设置【型号兼容模式】选项为 true~ |
| M01/XMYX01JY | 小米小爱音箱HD 需要设置【特殊型号获取对话记录】选项为 true 才能语音播放 |
| OH2P | XIAOMI 智能音箱 Pro |
| OH2 | XIAOMI 智能音箱 |
青小蛙测试
青小蛙没有小爱音箱,但不影响测试。
XiaoMusic 有一个 Web 界面,可以在这里直接播放本地音乐,以及,搜索下载没有的音乐:

它还有一些其他的工具,包括:m3u转换、歌曲下载工具、歌单合并工具
比如这个歌曲下载工具,你可以指定单曲 URL,或者歌单 URL,直接下载:

原理是通过 yt-dlp 下载视频,然后使用 ffmpeg 转换为 MP3,青小蛙随手下载了几个,还挺方便的。

不过也遇到了从网易云只下载到片段的问题,全部只有400KB左右。
适合有 NAS、Docker 环境的同学,当然你要先有一台小爱音箱!
获取
原文:https://www.appinn.com/xiaomusic-xiaoai/
关注我们
- 微博:https://weibo.com/appinncom
- B站:https://space.bilibili.com/10979326
- 小红书:https://kutt.appinn.com/6QwshF
- Facebook:https://www.facebook.com/appinncom/
- BlueSky:https://bsky.app/profile/appinn.bsky.social
- X:https://x.com/appinn
- 微信公众号:搜索「小众软件」
- TG频道:@appinnfeed
爱发电:https://afdian.com/a/qingxwa (打赏我们,让我们更好的创作)