让小爱音箱免费拥有本地曲库一条命令部署 XiaoMusic【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是一个用 yt-dlp 下载音乐、再通过小爱音箱播放的开源项目这篇文章带你从零跑通它在 NAS 上的部署。它适合家里有小爱音箱、嫌内置曲库老且要开会员、又想把 NAS 上的本地曲库接给音箱的人。用了半年的结论是部署完基本零维护唯一折腾人的是第一遍小米账号登录。说播放音乐小爱没反应一台二手小爱音箱摆在厨房内置曲库老旧点播大部分要开会员NAS 上躺着整箱 APE 和 FLAC 本地曲库音箱却碰不到。XiaoMusic 补的就是这块不开任何音乐平台让音箱直接放你自己服务器上的文件。还有个让我卡了两天的细节我头两天对着它说小爱同学播放音乐它装死。后来查了官方 FAQ 才明白默认口令前缀是【播放歌曲】说播放音乐是识别不了的除非你在设置页自定义口令词 它凭什么让小爱音箱放本地音乐一句话它每秒监听小爱音箱的对话记录拦下你的语音口令再把播放切到本地文件。官方 FAQ 也说得直白这个打断过程有延迟做不到无缝衔接所以点播时音箱可能先说完自己那句默认回答再切过来。用小米账号绑定音箱并拉取对话记录捕获播放歌曲 周杰伦 晴天这类口令本地没有的歌会调用 yt-dlp 搜索下载到本地音乐目录下次直接本地播放本地音乐目录就是曲库mp3、flac、wav、ape、ogg、m4a 都能识别每个子目录变成一个歌单提供网页后台搜索、播放、收藏管理都能点着完成不依赖语音一条命令部署 xiaomusic官方推荐 Docker 方式命令就一行docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic58090是主机端口可改后台地址就是http://NAS_IP:580908090是容器内端口别改如果你换了主机端口其他配置要同步改/xiaomusic_music是音乐目录/xiaomusic_conf是配置目录换成你自己的路径建议分开目录不存在会报错先mkdir -p建好不想用 Docker 也可以pip install -U xiaomusic后运行xiaomusic命令配置参考仓库里的config-example.json容器起来后浏览器打开后台左侧就是小爱音箱操控面板、播放列表、账号设置、设置、关于这几项。接下来在设置页填小米账号和密码保存设备列表会弹出来勾选你的音箱即可。不用手动获取 did系统自动拿到这一点官方有明确说明。跑通之后可以折腾的几件事自定义口令设置页有user_key_word_dict把一句短语映射成命令比如喊晨间唤醒就播晨间歌单也能指向插件脚本网络歌单设置页贴一份 json 歌单就行支持电台也能直接导入别人分享的歌单链接手头有 m3u 电台文件的话仓库自带转换工具可以转成网络歌单定时任务crontab 语法支持设置音量、关机、播放、TTS 等任务社区常见用法是晚上定时关闭对话记录拉取避开风控FLAC 兼容L05B、L05C 这类型号放不了 flac打开【转换为MP3】让服务端转一下代价是吃 CPU多设备可以勾选多台音箱后台右上角切换当前设备全屋音箱接同一个曲库⚠️ 想让后台暴露公网访问先把 web 登录密码打开并设成复杂密码账号绑了摄像头的别拿来用这是 README 里的安全提醒我踩过的坑如果你遇到这些情况如果填了账号密码后设备列表是空的基本就是登录失败了去看日志。官方 FAQ 的经验是到小米官网重新登录一次、完成人脸或滑块验证能解决大部分登录失败另外可以关代理、在局域网里重新登录一下米家 App 再试。如果后台能播但语音口令不灵查两处一是获取对话记录也就是语音口令开关有没有打开它是默认关的二是口令说得对不对前缀必须是播放歌曲。如果日志显示正在播放却没声音先确认音箱和服务器在同一个局域网hostname 要填服务器的局域网 IP别填 localhost触屏版音箱可以试试打开【型号兼容模式】。如果暂停之后音箱又自己唱了暂停和停止都不好使得说关机。这是社区反馈里提过的一嘴初看还以为是个 bug。如果 flac 歌曲播不了打开【转换为MP3】或者先用别的工具批量转成 mp3官方 FAQ 明确写了部分型号不支持 flac。顺带一提作者在 README 里已公告项目停止维护并指向了社区接力项目现在打算部署的话先去看看最新动态比较稳。想上手机厨房那台音箱试一条命令部署完对它说句播放歌曲看有没有声音这是验证部署成功最快的方式 卡壳时先去翻仓库的 FAQ 问题集合你遇到的问题多半已经有答案了。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
