如何让小爱音箱免费放歌XiaoMusic 本地音乐服务器部署指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是面向小爱音箱的开源音乐服务器部署在 NAS 或家里任意一台常开的机器上它用 yt-dlp一个开源音视频下载工具把歌曲下载下来让音箱从平台曲库切换到你的本地曲库。小爱音箱自带的音乐服务绑在平台上部分歌曲提示需要会员曲库随时变动孩子想听的故事也不稳定。更关键的是这些歌曲并不留在音箱上每次都依赖平台链路播放。XiaoMusic 的做法是你用语音报出歌名它在本地曲库查找找不到就在线搜索并下载之后播放就走本地文件不再受平台限制。一、XiaoMusic 快速部署Docker 一条命令跑起来最短路径是 Docker 部署Docker 是一种把程序连同运行环境打包成镜像的容器工具NAS 上一般预装docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic三个参数各管一件事58090:8090是端口映射58090 用主机上空闲的端口即可8090 是服务内部端口不要改两个-v分别把音乐目录和配置目录映射到主机建议分开存放。国内网络环境可将镜像换成docker.hanxi.cc/hanxi/xiaomusic。如果报目录不存在先执行mkdir -p /xiaomusic_music /xiaomusic_conf建好再启动。习惯 Python 环境的话也可以用 pip 方式pip install -U xiaomusic xiaomusic --config config.jsonconfig.json直接照仓库里的 config-example.json 改。二、配置小米账号只有两处必填服务起来后浏览器访问http://NAS_IP:58090进入 Web 后台配置只有两步在设置页填入小米账号和密码带*号的项是必填项保存后页面会拉取到你的音箱设备列表。确认音乐存放目录其余配置项不用时保持默认即可。保存账号前看不到设备列表是正常的这是设计如此。如果登录失败日志里提示 Login FailedFAQ 里列了常见解法关本地代理、米家 App 重新登录、或在小米官网完成一次人脸/滑块验证详见 docs/issues/99.md。三、语音口令你能对音箱说什么部署后对音箱直接说这些就行“播放歌曲周杰伦晴天”核心玩法。先在本地曲库匹配没有就在线搜索用 yt-dlp 下载成 mp3 后播放下次再点同一首就是纯本地速度。“上一首 / 下一首 / 暂停 / 关机”基础播放控制。“单曲循环 / 全部循环 / 随机播放”切换播放模式音箱会用 TTS 语音确认。“播放歌单其他”播放音乐目录下指定子目录的全部歌曲目录名即歌单名。“加入收藏 / 取消收藏”把当前歌加入或移出收藏歌单。口令词本身可以改。配置文件里的user_key_word_dict段把任意短语映射到命令还支持exec#code1(...)、exec#httpget(...)这类写法去调用自定义函数仓库 plugins/ 目录带了两份示例插件TTS 播报、发起 HTTP 请求照着写就能给自己的音箱加专属指令。四、本地歌单与网络歌单两种曲库来源本地库扫描音乐目录下的 mp3、flac、wav、ape、ogg、m4a 文件生成歌单下载的歌曲统一是 mp3。已知 L05B、L05C、LX06、L16A 等型号不能直接播 flac遇到这种情况在设置里打开“转换为 MP3”即可。除本地文件外XiaoMusic 还支持配置一个 json 格式的网络歌单电台和歌曲都可以放也可以直接用别人分享的链接。仓库自带 m3u 文件转换工具能把 m3u 电台文件转成网络歌单格式具体用法见 docs/issues/78.md。五、Web 后台XiaoMusic 管理界面能做什么后台页面承担了日常管理的绝大部分工作搜索并下载歌曲、删除歌曲删除先进回收站有一次反悔机会、切换多台音箱设备、拖动进度条定点播放底部还能看到当前播放歌曲名、时长和设备音量条。六、长期使用 XiaoMusic 的建议与注意先了解维护状态README 顶部明确标注项目已停止维护不再接受新功能开发与 bug 修复作者建议迁移到社区接力项目 songloft。已部署的使用不受影响但新增需求建议到接力项目提。安全设置不可省如果要让后台走公网访问务必开启密码登录并设复杂密码同时不建议把这个小米账号与摄像头等设备共用账号泄露风险会连带扩散。语音口令功能要随手关语音控制依赖“获取对话记录”开关频繁拉取对话记录可能触发登录失败不听歌时可以在后台把它关掉。设备兼容性README 列了 L06A、L07A、S12、LX06、LX01 等已测试型号未列出的型号一般也能播个别型号需要开启“特殊型号获取对话记录”或“型号兼容模式”遇到语音控制无效时优先查 docs/issues/99.md。七、小结与入口XiaoMusic 解决的核心问题很单一把小爱音箱的音乐来源从平台曲库换成你自己的本地曲库一条 Docker 命令就能起步。项目说明与完整功能列表README.md新手常见问题与报错处理docs/issues/99.md文档站点入口docs/index.md核心源码目录xiaomusic/【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何让小爱音箱免费放歌：XiaoMusic 本地音乐服务器部署指南
如何让小爱音箱免费放歌XiaoMusic 本地音乐服务器部署指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicXiaoMusic 是面向小爱音箱的开源音乐服务器部署在 NAS 或家里任意一台常开的机器上它用 yt-dlp一个开源音视频下载工具把歌曲下载下来让音箱从平台曲库切换到你的本地曲库。小爱音箱自带的音乐服务绑在平台上部分歌曲提示需要会员曲库随时变动孩子想听的故事也不稳定。更关键的是这些歌曲并不留在音箱上每次都依赖平台链路播放。XiaoMusic 的做法是你用语音报出歌名它在本地曲库查找找不到就在线搜索并下载之后播放就走本地文件不再受平台限制。一、XiaoMusic 快速部署Docker 一条命令跑起来最短路径是 Docker 部署Docker 是一种把程序连同运行环境打包成镜像的容器工具NAS 上一般预装docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic三个参数各管一件事58090:8090是端口映射58090 用主机上空闲的端口即可8090 是服务内部端口不要改两个-v分别把音乐目录和配置目录映射到主机建议分开存放。国内网络环境可将镜像换成docker.hanxi.cc/hanxi/xiaomusic。如果报目录不存在先执行mkdir -p /xiaomusic_music /xiaomusic_conf建好再启动。习惯 Python 环境的话也可以用 pip 方式pip install -U xiaomusic xiaomusic --config config.jsonconfig.json直接照仓库里的 config-example.json 改。二、配置小米账号只有两处必填服务起来后浏览器访问http://NAS_IP:58090进入 Web 后台配置只有两步在设置页填入小米账号和密码带*号的项是必填项保存后页面会拉取到你的音箱设备列表。确认音乐存放目录其余配置项不用时保持默认即可。保存账号前看不到设备列表是正常的这是设计如此。如果登录失败日志里提示 Login FailedFAQ 里列了常见解法关本地代理、米家 App 重新登录、或在小米官网完成一次人脸/滑块验证详见 docs/issues/99.md。三、语音口令你能对音箱说什么部署后对音箱直接说这些就行“播放歌曲周杰伦晴天”核心玩法。先在本地曲库匹配没有就在线搜索用 yt-dlp 下载成 mp3 后播放下次再点同一首就是纯本地速度。“上一首 / 下一首 / 暂停 / 关机”基础播放控制。“单曲循环 / 全部循环 / 随机播放”切换播放模式音箱会用 TTS 语音确认。“播放歌单其他”播放音乐目录下指定子目录的全部歌曲目录名即歌单名。“加入收藏 / 取消收藏”把当前歌加入或移出收藏歌单。口令词本身可以改。配置文件里的user_key_word_dict段把任意短语映射到命令还支持exec#code1(...)、exec#httpget(...)这类写法去调用自定义函数仓库 plugins/ 目录带了两份示例插件TTS 播报、发起 HTTP 请求照着写就能给自己的音箱加专属指令。四、本地歌单与网络歌单两种曲库来源本地库扫描音乐目录下的 mp3、flac、wav、ape、ogg、m4a 文件生成歌单下载的歌曲统一是 mp3。已知 L05B、L05C、LX06、L16A 等型号不能直接播 flac遇到这种情况在设置里打开“转换为 MP3”即可。除本地文件外XiaoMusic 还支持配置一个 json 格式的网络歌单电台和歌曲都可以放也可以直接用别人分享的链接。仓库自带 m3u 文件转换工具能把 m3u 电台文件转成网络歌单格式具体用法见 docs/issues/78.md。五、Web 后台XiaoMusic 管理界面能做什么后台页面承担了日常管理的绝大部分工作搜索并下载歌曲、删除歌曲删除先进回收站有一次反悔机会、切换多台音箱设备、拖动进度条定点播放底部还能看到当前播放歌曲名、时长和设备音量条。六、长期使用 XiaoMusic 的建议与注意先了解维护状态README 顶部明确标注项目已停止维护不再接受新功能开发与 bug 修复作者建议迁移到社区接力项目 songloft。已部署的使用不受影响但新增需求建议到接力项目提。安全设置不可省如果要让后台走公网访问务必开启密码登录并设复杂密码同时不建议把这个小米账号与摄像头等设备共用账号泄露风险会连带扩散。语音口令功能要随手关语音控制依赖“获取对话记录”开关频繁拉取对话记录可能触发登录失败不听歌时可以在后台把它关掉。设备兼容性README 列了 L06A、L07A、S12、LX06、LX01 等已测试型号未列出的型号一般也能播个别型号需要开启“特殊型号获取对话记录”或“型号兼容模式”遇到语音控制无效时优先查 docs/issues/99.md。七、小结与入口XiaoMusic 解决的核心问题很单一把小爱音箱的音乐来源从平台曲库换成你自己的本地曲库一条 Docker 命令就能起步。项目说明与完整功能列表README.md新手常见问题与报错处理docs/issues/99.md文档站点入口docs/index.md核心源码目录xiaomusic/【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考