小爱音箱本地音乐，5分钟跑通xiaomusic
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
想让音箱播放自己喜欢的歌，却被在线平台的曲库限制住？xiaomusic 是一个免费开源的小爱音箱音乐服务，让音箱直接播放你自己本地库里的音乐。跟着做完下面的步骤，你对音箱说一句"播放歌曲"，出来的就是自己的歌。
让本地音乐接管音箱
| 依赖在线平台 | xiaomusic | |
|---|---|---|
| 音乐来源 | 受平台曲库限制 | 本地库+网络下载 |
| 语音控制 | 部分口令受限 | 完整语音口令 |
| 使用成本 | 会员订阅 | 免费开源 |
| 歌单管理 | 不可见不可改 | 网页可查可删 |
配置完成后，音箱的音源就不再受平台曲库限制。
动手前备齐三样
- 硬件：一台小爱音箱，型号在 README 的支持列表内
- 软件：一台装了 Docker 的电脑或 NAS，加一个小米账号
- 网络：音箱和服务器连在同一个 WiFi
五分钟跑起来
推荐用 Docker（一种把程序打包成独立容器运行的工具），共 4 步：
- 在服务器上新建两个目录，分别放音乐和配置：
mkdir -p /xiaomusic_music /xiaomusic_conf- 启动容器，58090 是对外开放的访问端口：
docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic- 浏览器打开
http://服务器IP:58090，能看到管理页面，界面长这样：
- 在页面里输入小米账号和密码并保存，设备列表会自动拉取，看到你的音箱即成功。
不想用 Docker 的话，也可以在 Python 环境里 pip install xiaomusic 直接运行，自己配好配置文件即可。
说话指定歌名就能播
对音箱说"播放歌曲 周杰伦 晴天"，它会匹配后直接播放。口令匹配带模糊匹配，不用一字不差。
它还能做的不止开始播放："下一首"、"单曲循环"、"加入收藏"都有效，"10分钟后关机"也会准时停。
控制台里有一张操作指引图，每个按钮的用途都标了出来，刚打开页面没看懂时先看它。
不想用默认口令，可以在仓库的 config-example.json 文件里改语音指令。
想听没下载的歌？自动下载
点一首本地库里没有的歌，它会先下载再播放。下载的歌保存在音乐目录里，之后播放直接出声，不用等。
歌单在网页上也能管理，分成全部、所有歌曲、收藏、下载四个页签，可以搜索、快速播放，也可以删除。
播不出声音先查这四处
| 现象 | 原因 | 动作 |
|---|---|---|
| 网页打不开 | 端口映射错了 | 检查启动命令里的 58090 |
| 设备列表为空 | 没登录小米账号 | 网页上输入账号密码保存 |
| 歌曲不播放 | 格式不兼容，部分型号不支持 flac | 设置里打开"转换为MP3" |
| 语音口令无效 | 口令没对上 | 在配置示例里改口令 |
现在就可以开始听
把几首歌曲拷进 /xiaomusic_music，对音箱说"播放歌曲"，本地音乐播放配置就完成了。网络歌单、定时播放等进阶用法，可以看仓库里的 README。
【免费下载链接】xiaomusic使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
