小爱音箱音乐播放把 NAS 里的无损音乐推给音箱【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic小爱音箱音乐播放是一个叫 xiaomusic 的开源项目。它把 NAS 或电脑目录里的音乐文件推给小爱音箱播放本地找不到歌时再用 yt-dlp 在线下载后播放。全程保留小爱同学的语音控制照常说播放下一首就行。它能帮你做什么第一个场景NAS 里存了一堆 FLAC 无损音乐音箱自带的音乐服务却放不了。xiaomusic 会扫描music_path指向的目录mp3、flac、wav、ape、ogg、m4a 六种格式都能识别说播放本地歌曲就把歌单推上去。注意 L05B、L05C、LX06、L16A 这几个型号不支持 flac需要打开转换为MP3开关。第二个场景本地曲库里没有的歌不用自己去找资源。直接说播放歌曲 周杰伦晴天服务会用 yt-dlp 搜索并下载成 mp3 再播放。播放歌曲小猪佩奇的故事这种说法也会先把故事音频下载下来再播给孩子放睡前故事很省事。第三个场景睡前让音箱自己关。说10分钟后关机它会按时停止播放并关机不用爬下床按遥控器。配合网页端还能把目录建成歌单播放歌单收藏放你精选的播放歌单其他放剩下的。一条路径跑通推荐用 Docker 部署 xiaomusic四步跑通。第一步在宿主机建两个目录音乐和配置分开存放避免混在一起mkdir -p /xiaomusic_music /xiaomusic_conf第二步启动容器宿主机 58090 端口映射到容器内 8090docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic第三步浏览器打开http://NAS_IP:58090输入小米账号和密码保存设备列表就会拉出来其余参数在网页上按需改。第四步对小爱说播放歌曲听到歌声就算跑通了。其他路径一句话带过Python 环境直接pip install -U xiaomusic再执行xiaomusic --config config.json配置模板见 config-example.jsonDocker Compose 用户参考 README.md 里的 compose 片段加上restart: always适合长期跑。配置一次就懂配置文件不用全看第一次只用关心这四个字段字段示例值说明account / password你的小米账号首次必填保存后才能拉取设备列表music_pathmusic本地音乐目录自动扫描六种音频格式convert_to_mp3false型号不支持 flac 时设为 true边转边播search_prefixbilisearch:在线下载时 yt-dlp 的搜索前缀语音指令速查让 xiaomusic 接管语音后常用指令分三组。播放播放歌曲、播放歌曲周杰伦晴天、播放本地歌曲、播放歌手周杰伦切换上一首、下一首、单曲循环、全部循环、随机播放、停止播放歌单管理播放歌单收藏、播放歌单其他、加入收藏、取消收藏这套口令让 xiaomusic 成了小爱音箱播放本地音乐最顺手的入口不常用的两条值得记住播放歌曲小猪佩奇的故事自动下载后播放适合儿童内容和10分钟后关机定时停播。踩坑三则连接失败现象服务启动正常但设备列表为空音箱不受控制。原因小米账号密码没保存成功或音箱与服务器不在同一局域网。解决网页端重新输入账号密码并保存确认音箱与 NAS 在同一局域网重启音箱和服务后再试。播放无声现象进度条在走音箱没有声音。原因音箱音量被拉到最低或格式不被该型号支持如 L05B 放 flac。解决说声音大一点检查音量换一首 mp3 测试打开转换为MP3再播一次。下载失效现象说播放歌曲 xxx没反应下载任务一直为空。原因宿主机网络访问不到下载源或镜像内 yt-dlp 版本过旧。解决在宿主机上手动访问下载源确认可达给proxy字段配置代理升级到最新镜像版本。安全提醒与项目现状服务暴露公网时务必开启密码登录httpauth 相关字段并设复杂密码公共 WiFi 下不要运行防止小米账号密码随请求泄露别把同一个小爱账号绑定摄像头账号一旦泄露监控录像有暴露风险项目作者已宣布停止维护不再接受新功能开发与 bug 修复官方建议迁移到社区接力项目 songloft-org/songloft 获取后续更新。存量功能不受影响只是新 bug 不再有人接。跑通之后你会发现音箱终于能播放自己曲库里的歌了日常配置也就第一次那几个输入框。动手前可以翻一下 docs/ 和 xiaomusic/plugins/ 里的插件源码了解它能再往哪扩展。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考