XiaoMusic 教程小爱音箱免费解锁音乐播放语音控制 5 分钟跑通【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对小爱同学说播放周杰伦的晴天音箱会把歌下载到本地曲库然后直接放出来不用会员。XiaoMusic 是一个用 yt-dlp 下载音乐到本地曲库、再让小爱音箱播放的开源工具适合手里有小爱音箱、想免费听歌的人。这篇教程按实际使用顺序走一遍先看部署完成后的效果再把它跑起来然后完成配置最后是语音口令和进阶用法。 先听效果部署完成后能干什么说播放周杰伦的晴天时它的处理顺序是先查本地音乐目录有就直接播没有就用 yt-dlp 抓取资源下载到音乐目录后接着播放。第一次听需要等下载之后都从本地秒播。你还能在 Web 控制台里管理曲库浏览歌曲、切换设备、调整播放模式和音量。原理并不复杂XiaoMusic 跑在你的局域网里用小米账号拉取音箱的语音对话记录识别到播放口令后找到对应歌曲把播放链接发给音箱。音箱的使用体验不变只是歌从哪来被换掉了。 5 分钟跑通部署用 Docker 部署推荐docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic两个挂载目录分别存放音乐和配置建议分开。目录不存在会报错先在宿主机执行mkdir -p /xiaomusic_music /xiaomusic_conf建好。58090 是本机端口可以换8090 是容器端口别动。启动成功后浏览器打开http://你的服务器IP:58090进入 Web 后台。用 pip 或源码安装不想用容器的话先pip install -U xiaomusic把 config-example.json 复制成config.json填入自己的信息再用xiaomusic --config config.json启动。想跑源码的话用git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic获取代码按 README 里开发指南的步骤装好依赖pdm run xiaomusic.py启动。首次配置只需要三步填小米账号密码设置页带*的项必填保存后就能看到设备列表。打开语音口令开关主页的【获取对话记录】开关默认关闭不开它音箱不会响应任何口令这是新手最常踩的坑。换一个 TTS 音色建议选 Edge-TTS 音色避免 TTS 登录失败导致语音提示音失效。控制台布局如下图左侧是设备控制、播放列表、账号设置、设置四个入口中间区域是歌曲列表可以直接点击播放语音口令清单对小爱说什么说播放周杰伦的晴天播放指定歌曲本地没有就先下载说播放歌曲从本地曲库放歌下一首上一首切换曲目随机播放全部循环单曲循环随时切换播放模式说播放歌单流行音乐播放对应目录的歌单加入收藏取消收藏把当前歌曲加入或移出收藏歌单关机或停止播放停止当前播放还有个隐藏玩法说播放歌曲小猪佩奇的故事它会先下载故事音频再播放家里有小孩会很实用。口令词可以在配置文件的key_word_dict里改不局限于默认的播放歌曲前缀。⚙️ 进阶用法三个值得试的玩法网络歌单与电台除了本地曲库还可以配置 JSON 格式的网络歌单支持电台和 m3u8 链接也支持直接填别人分享的歌单 URL 一键加载。手上有 m3u 电台文件的话粘贴到内置的 m3u 转换工具 转成 JSON 再保存即可。格式和用法详见如何配置网络歌单与如何添加 m3u 格式文件的电台。自定义口令与插件在配置文件的user_key_word_dict里加自己的词比如把晨间唤醒映射到一个播放命令每天说小爱同学晨间唤醒就放背景音乐。plugins/ 目录提供 JS 插件运行环境可以写脚本扩展自己的口令逻辑。定时任务与多设备配置项支持 crontab 格式定时任务比如每天固定时间开始播电台。家里有多台音箱时可以在后台把设备分组一起播也可以切换设备单独播。音箱没反应时常见问题排查顺序后台看不到设备日志出现 Login Failed 基本是账号问题先确认账号密码没填错关掉本地代理重试还不行就去米家 App 或 mi.com 官网退出重新登录。日志报 DNS 解析错误的话把宿主机的 DNS 改成223.5.5.5再重启容器。网页能播、语音不灵按顺序查1【获取对话记录】开关是否打开2口令前缀是否正确默认必须带播放歌曲前缀光说播放音乐不识别3首次保存设备 did 后需要重启一次容器。日志显示播放中却没声音重点查hostname配置必须是音箱能访问到的局域网 IPv4 地址不能填localhost或 IPv6如果你把 8090 端口映射改了其他参数要同步改。部分触屏型号可以试着打开【型号兼容模式】。更多报错日志与解法见 FAQ 问题集合。开始之前几个提醒安全后台如果暴露到公网一定要开启密码登录并设强密码公共 WiFi 下别用这套工具小米账号密码可能泄露。格式兼容本地音乐支持 mp3、flac、wav、ape、ogg、m4aL05B、L05C 等部分型号放不了 flac可在后台打开【转换为 MP3】。维护状态README 已注明项目停止维护作者建议迁移到社区接力项目想要长期更新的话要心里有数。所有配置项的完整说明见文档汇总。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
XiaoMusic 教程：小爱音箱免费解锁音乐播放，语音控制 5 分钟跑通
XiaoMusic 教程小爱音箱免费解锁音乐播放语音控制 5 分钟跑通【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对小爱同学说播放周杰伦的晴天音箱会把歌下载到本地曲库然后直接放出来不用会员。XiaoMusic 是一个用 yt-dlp 下载音乐到本地曲库、再让小爱音箱播放的开源工具适合手里有小爱音箱、想免费听歌的人。这篇教程按实际使用顺序走一遍先看部署完成后的效果再把它跑起来然后完成配置最后是语音口令和进阶用法。 先听效果部署完成后能干什么说播放周杰伦的晴天时它的处理顺序是先查本地音乐目录有就直接播没有就用 yt-dlp 抓取资源下载到音乐目录后接着播放。第一次听需要等下载之后都从本地秒播。你还能在 Web 控制台里管理曲库浏览歌曲、切换设备、调整播放模式和音量。原理并不复杂XiaoMusic 跑在你的局域网里用小米账号拉取音箱的语音对话记录识别到播放口令后找到对应歌曲把播放链接发给音箱。音箱的使用体验不变只是歌从哪来被换掉了。 5 分钟跑通部署用 Docker 部署推荐docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic两个挂载目录分别存放音乐和配置建议分开。目录不存在会报错先在宿主机执行mkdir -p /xiaomusic_music /xiaomusic_conf建好。58090 是本机端口可以换8090 是容器端口别动。启动成功后浏览器打开http://你的服务器IP:58090进入 Web 后台。用 pip 或源码安装不想用容器的话先pip install -U xiaomusic把 config-example.json 复制成config.json填入自己的信息再用xiaomusic --config config.json启动。想跑源码的话用git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic获取代码按 README 里开发指南的步骤装好依赖pdm run xiaomusic.py启动。首次配置只需要三步填小米账号密码设置页带*的项必填保存后就能看到设备列表。打开语音口令开关主页的【获取对话记录】开关默认关闭不开它音箱不会响应任何口令这是新手最常踩的坑。换一个 TTS 音色建议选 Edge-TTS 音色避免 TTS 登录失败导致语音提示音失效。控制台布局如下图左侧是设备控制、播放列表、账号设置、设置四个入口中间区域是歌曲列表可以直接点击播放语音口令清单对小爱说什么说播放周杰伦的晴天播放指定歌曲本地没有就先下载说播放歌曲从本地曲库放歌下一首上一首切换曲目随机播放全部循环单曲循环随时切换播放模式说播放歌单流行音乐播放对应目录的歌单加入收藏取消收藏把当前歌曲加入或移出收藏歌单关机或停止播放停止当前播放还有个隐藏玩法说播放歌曲小猪佩奇的故事它会先下载故事音频再播放家里有小孩会很实用。口令词可以在配置文件的key_word_dict里改不局限于默认的播放歌曲前缀。⚙️ 进阶用法三个值得试的玩法网络歌单与电台除了本地曲库还可以配置 JSON 格式的网络歌单支持电台和 m3u8 链接也支持直接填别人分享的歌单 URL 一键加载。手上有 m3u 电台文件的话粘贴到内置的 m3u 转换工具 转成 JSON 再保存即可。格式和用法详见如何配置网络歌单与如何添加 m3u 格式文件的电台。自定义口令与插件在配置文件的user_key_word_dict里加自己的词比如把晨间唤醒映射到一个播放命令每天说小爱同学晨间唤醒就放背景音乐。plugins/ 目录提供 JS 插件运行环境可以写脚本扩展自己的口令逻辑。定时任务与多设备配置项支持 crontab 格式定时任务比如每天固定时间开始播电台。家里有多台音箱时可以在后台把设备分组一起播也可以切换设备单独播。音箱没反应时常见问题排查顺序后台看不到设备日志出现 Login Failed 基本是账号问题先确认账号密码没填错关掉本地代理重试还不行就去米家 App 或 mi.com 官网退出重新登录。日志报 DNS 解析错误的话把宿主机的 DNS 改成223.5.5.5再重启容器。网页能播、语音不灵按顺序查1【获取对话记录】开关是否打开2口令前缀是否正确默认必须带播放歌曲前缀光说播放音乐不识别3首次保存设备 did 后需要重启一次容器。日志显示播放中却没声音重点查hostname配置必须是音箱能访问到的局域网 IPv4 地址不能填localhost或 IPv6如果你把 8090 端口映射改了其他参数要同步改。部分触屏型号可以试着打开【型号兼容模式】。更多报错日志与解法见 FAQ 问题集合。开始之前几个提醒安全后台如果暴露到公网一定要开启密码登录并设强密码公共 WiFi 下别用这套工具小米账号密码可能泄露。格式兼容本地音乐支持 mp3、flac、wav、ape、ogg、m4aL05B、L05C 等部分型号放不了 flac可在后台打开【转换为 MP3】。维护状态README 已注明项目停止维护作者建议迁移到社区接力项目想要长期更新的话要心里有数。所有配置项的完整说明见文档汇总。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考