三步解放小爱音箱XiaoMusic 免费听全网音乐的完整配置指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic周末早晨你对音箱说小爱同学播放周杰伦的《晴天》得到的回应却是抱歉这首歌需要开通音乐会员。孩子要听的童话故事、你收藏夹里的冷门老歌几乎处处碰壁。其实不用开会员也不用买 U 盘——开源项目XiaoMusic的思路很直接它把小爱音箱的语音指令截下来用 yt-dlp 把歌免费下载到本地再让音箱直接播本地文件。部署一次以后喊歌名就行。 价值速览这个项目值不值得你花 20 分钟先给你一张方案卡片看完再决定要不要折腾维度说明项目定位小爱音箱免费音乐方案拦截语音指令 yt-dlp 自动下载 本地播放绕开平台会员墙适用人群拥有小爱音箱全家桶、受够了暂无版权提示的普通家庭用户会基础 Docker 操作的 NAS 玩家上手难度Docker 一条命令启动剩下在网页里填小米账号即可全程不需要写代码核心收益歌曲一次下载、永久本地保存断网也能播支持 mp3/flac/wav/ape/ogg/m4a 六种格式参考文档完整问题集合见 docs/issues/index.md网络歌单玩法见 docs/issues/78.md它不是又一个播放插件而是把小爱音箱从平台点播器改造成你自己音乐库的遥控器。 它是怎么做到的拆成三件事讲清楚XiaoMusic 的核心代码在 xiaomusic/ 目录但你要理解的其实只有三个环节我一个个打比方。1. 听并拦截一个会看关键词表的秘书你每说一句小爱同学指令都会经过 XiaoMusic。它手里有一张关键词映射表配置项key_word_dict比如播放歌曲→ 触发搜索播放、下一首→ 切歌、加入收藏→ 收藏。这就像给小爱派了个贴身秘书秘书先听完你要什么能办就自己办办不了再转交给原系统。指令解析逻辑在 xiaomusic/command_handler.py。2. 抓并保存yt-dlp 这个全能搬运工本地没有这首歌怎么办XiaoMusic 调用 yt-dlp 引擎从多个音乐平台把音频抓下来默认存成 mp3按歌名存进你的音乐目录。一次下载永久可用——下次再点同一首歌直接走本地几乎秒播。下载与在线播放相关逻辑在 xiaomusic/online_music.py。3. 管并播放本地音乐库 网页控制台下载下来的文件就躺在你指定的目录里XiaoMusic 会自动扫描建库。你打开http://NAS_IP:58090的网页控制台服务入口 xiaomusic/api/app.py能切分类、搜歌曲、删歌曲、切换设备。它同时支持播放你自己目录里已有的 flac、ape 等无损文件——等于把你现成的音乐收藏也一并激活了。 部署三步走从一条 Docker 命令到出声部署过程真正的门槛只有目录映射这一个点下面逐步说清。第一步Docker 一条命令启动mkdir -p /xiaomusic_music /xiaomusic_conf docker run -d --restart always -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic两个-v是新手最容易错的地方/xiaomusic_music是主机上放歌的目录可以换成你自己的路径/app/music是容器内固定路径不要改58090是你在家里访问的端口8090是容器端口也不要改。国内拉镜像慢的话把镜像名换成docker.hanxi.cc/hanxi/xiaomusic即可。第二步网页里填两项必填配置浏览器打开http://你的IP:58090在设置页只需关心带*的项小米账号 密码唯一必须填的东西保存后设备列表才会出来音乐目录Docker 部署下默认已映射好源码部署时建议写成绝对路径避免权限问题其余几十项配置代理、定时任务、TTS 提示语等都有示例默认值参考 config-example.json用不到就不动。第三步源码安装备选方案想自己改代码的话用源码跑git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install pdm run xiaomusic.py或者更省事直接pip install -U xiaomusic再执行xiaomusic --config config.json配置文件同样参考config-example.json。⚖️ 改造前 vs 改造后小爱音箱到底变了什么使用场景改造前改造后点一首热门歌高概率需要开通会员/暂无版权自动下载后直接播本地命中秒响给孩子放故事平台上故事多要付费说播放歌曲小猪佩奇的故事先下载再播已有的无损音乐收藏音箱够不着只能连蓝牙将就丢进音乐目录即可语音点播 flac/ape多台音箱各平台各自为政一个控制台右上角切换全家统一控制几个可以写进笔记的实测口径设备覆盖官方已测试 20 款型号从小爱音箱 mini 到 Xiaomi Sound Pro含触屏版格式支持mp3 / flac / wav / ape / ogg / m4a 六种本地扫描 下载均可二次播放延迟歌曲已在本地时无需任何网络请求响应只取决于局域网快慢口令种类播放、切歌、三种循环模式、歌单点播、收藏/取消收藏开箱即用️ 玩法进阶让音箱真正懂你基础功能跑通后下面三个玩法是社区里被用得最多的每个都给你配了具体例子。自定义语音口令把场景说成一句话配置文件里的user_key_word_dict允许你给任意口令绑定动作甚至直接调用 Python 插件函数。比如user_key_word_dict: { 晨间唤醒: exec#code1(\播放晨间音乐\), 睡前安眠: exec#code1(\播放白噪音\) }插件怎么写看仓库自带的 6 行示例 plugins/code1.py——拿到当前设备号发一句 TTS 语音就这么简单。从此小爱同学晨间唤醒就能触发你编排的任何组合动作。多设备协同客厅卧室各放各的控制台右上角就是设备切换器配置里的devices和group_list还能把多台音箱编组。典型用法客厅音箱放背景音乐、卧室音箱定时放睡前故事配合定时任务配置项crontab_json、书房音箱只播专注歌单——同一套音乐库不同房间不同场景。网络歌单电台和在线歌曲一起点设置页支持填 JSON 歌单电台 网络歌曲也支持直接粘贴别人分享的链接一键导入。玩法文档在 docs/issues/78.md配合内置的 m3u 电台文件转换工具 xiaomusic/static/default/m3u.html可以把电台的 m3u 文件秒变网络歌单多个歌单还能用 xiaomusic/static/default/merge/index.html 合并成一个。⚠️ 避坑手册部署前必看的 5 个高频问题Q1网页里保存了账号密码设备列表却出不来先确认账号密码是否输错建议重新完整填写一遍再保存再确认音箱和运行 XiaoMusic 的机器在同一局域网、网络稳定。仍不行就按 Q4 下日志排查。Q2某首歌下载失败或没有资源平台版权会动态变动同一首歌换个搜索关键词、或调整配置里的search_prefix搜索源前缀再试多数情况能绕过去。Q3flac 放不出声音L05B、L05C、LX06、L16A 这几个型号不支持 flac 格式。设置页打开【转换为 MP3】和【型号兼容模式】两个开关即可。Q4出问题了去哪里看日志提 Issue 要注意什么Web 设置页底部有【下载日志文件】按钮。注意上传或贴日志前先检查并删掉里面的账号密码信息再连同日志去仓库提 Issue定位会快得多。Q5会影响音箱原有功能吗不会。XiaoMusic 只接管它识别的自定义口令放新闻定闹钟这类原有功能照常工作互不冲突。️安全提醒如果要把 XiaoMusic 暴露到公网务必在设置里开启密码登录并设复杂密码且不要在公共 WiFi 下使用另外强烈建议不要用绑定了家用摄像头的小米账号来跑这个项目——账号一旦泄露风险远不止音乐。 现在就动手你的音箱该解锁了部署只需要 20 分钟一条 Docker 命令、一个小米账号、一句播放歌曲全网音乐库就是你的了。遇到报错先翻 docs/issues/index.md 的问题集合90% 的新手坑都有现成答案想深入玩法网络歌单看 docs/issues/78.md源码入口在 xiaomusic/发现 bug 或有新想法去仓库提一个 Issue也欢迎提交前端美化或功能开发的贡献现在就去 NAS 上敲下那条docker run然后回家喊一句小爱同学播放歌曲试试。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 三步解放小爱音箱：XiaoMusic 免费听全网音乐的完整配置指南
三步解放小爱音箱XiaoMusic 免费听全网音乐的完整配置指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic周末早晨你对音箱说小爱同学播放周杰伦的《晴天》得到的回应却是抱歉这首歌需要开通音乐会员。孩子要听的童话故事、你收藏夹里的冷门老歌几乎处处碰壁。其实不用开会员也不用买 U 盘——开源项目XiaoMusic的思路很直接它把小爱音箱的语音指令截下来用 yt-dlp 把歌免费下载到本地再让音箱直接播本地文件。部署一次以后喊歌名就行。 价值速览这个项目值不值得你花 20 分钟先给你一张方案卡片看完再决定要不要折腾维度说明项目定位小爱音箱免费音乐方案拦截语音指令 yt-dlp 自动下载 本地播放绕开平台会员墙适用人群拥有小爱音箱全家桶、受够了暂无版权提示的普通家庭用户会基础 Docker 操作的 NAS 玩家上手难度Docker 一条命令启动剩下在网页里填小米账号即可全程不需要写代码核心收益歌曲一次下载、永久本地保存断网也能播支持 mp3/flac/wav/ape/ogg/m4a 六种格式参考文档完整问题集合见 docs/issues/index.md网络歌单玩法见 docs/issues/78.md它不是又一个播放插件而是把小爱音箱从平台点播器改造成你自己音乐库的遥控器。 它是怎么做到的拆成三件事讲清楚XiaoMusic 的核心代码在 xiaomusic/ 目录但你要理解的其实只有三个环节我一个个打比方。1. 听并拦截一个会看关键词表的秘书你每说一句小爱同学指令都会经过 XiaoMusic。它手里有一张关键词映射表配置项key_word_dict比如播放歌曲→ 触发搜索播放、下一首→ 切歌、加入收藏→ 收藏。这就像给小爱派了个贴身秘书秘书先听完你要什么能办就自己办办不了再转交给原系统。指令解析逻辑在 xiaomusic/command_handler.py。2. 抓并保存yt-dlp 这个全能搬运工本地没有这首歌怎么办XiaoMusic 调用 yt-dlp 引擎从多个音乐平台把音频抓下来默认存成 mp3按歌名存进你的音乐目录。一次下载永久可用——下次再点同一首歌直接走本地几乎秒播。下载与在线播放相关逻辑在 xiaomusic/online_music.py。3. 管并播放本地音乐库 网页控制台下载下来的文件就躺在你指定的目录里XiaoMusic 会自动扫描建库。你打开http://NAS_IP:58090的网页控制台服务入口 xiaomusic/api/app.py能切分类、搜歌曲、删歌曲、切换设备。它同时支持播放你自己目录里已有的 flac、ape 等无损文件——等于把你现成的音乐收藏也一并激活了。 部署三步走从一条 Docker 命令到出声部署过程真正的门槛只有目录映射这一个点下面逐步说清。第一步Docker 一条命令启动mkdir -p /xiaomusic_music /xiaomusic_conf docker run -d --restart always -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic两个-v是新手最容易错的地方/xiaomusic_music是主机上放歌的目录可以换成你自己的路径/app/music是容器内固定路径不要改58090是你在家里访问的端口8090是容器端口也不要改。国内拉镜像慢的话把镜像名换成docker.hanxi.cc/hanxi/xiaomusic即可。第二步网页里填两项必填配置浏览器打开http://你的IP:58090在设置页只需关心带*的项小米账号 密码唯一必须填的东西保存后设备列表才会出来音乐目录Docker 部署下默认已映射好源码部署时建议写成绝对路径避免权限问题其余几十项配置代理、定时任务、TTS 提示语等都有示例默认值参考 config-example.json用不到就不动。第三步源码安装备选方案想自己改代码的话用源码跑git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install pdm run xiaomusic.py或者更省事直接pip install -U xiaomusic再执行xiaomusic --config config.json配置文件同样参考config-example.json。⚖️ 改造前 vs 改造后小爱音箱到底变了什么使用场景改造前改造后点一首热门歌高概率需要开通会员/暂无版权自动下载后直接播本地命中秒响给孩子放故事平台上故事多要付费说播放歌曲小猪佩奇的故事先下载再播已有的无损音乐收藏音箱够不着只能连蓝牙将就丢进音乐目录即可语音点播 flac/ape多台音箱各平台各自为政一个控制台右上角切换全家统一控制几个可以写进笔记的实测口径设备覆盖官方已测试 20 款型号从小爱音箱 mini 到 Xiaomi Sound Pro含触屏版格式支持mp3 / flac / wav / ape / ogg / m4a 六种本地扫描 下载均可二次播放延迟歌曲已在本地时无需任何网络请求响应只取决于局域网快慢口令种类播放、切歌、三种循环模式、歌单点播、收藏/取消收藏开箱即用️ 玩法进阶让音箱真正懂你基础功能跑通后下面三个玩法是社区里被用得最多的每个都给你配了具体例子。自定义语音口令把场景说成一句话配置文件里的user_key_word_dict允许你给任意口令绑定动作甚至直接调用 Python 插件函数。比如user_key_word_dict: { 晨间唤醒: exec#code1(\播放晨间音乐\), 睡前安眠: exec#code1(\播放白噪音\) }插件怎么写看仓库自带的 6 行示例 plugins/code1.py——拿到当前设备号发一句 TTS 语音就这么简单。从此小爱同学晨间唤醒就能触发你编排的任何组合动作。多设备协同客厅卧室各放各的控制台右上角就是设备切换器配置里的devices和group_list还能把多台音箱编组。典型用法客厅音箱放背景音乐、卧室音箱定时放睡前故事配合定时任务配置项crontab_json、书房音箱只播专注歌单——同一套音乐库不同房间不同场景。网络歌单电台和在线歌曲一起点设置页支持填 JSON 歌单电台 网络歌曲也支持直接粘贴别人分享的链接一键导入。玩法文档在 docs/issues/78.md配合内置的 m3u 电台文件转换工具 xiaomusic/static/default/m3u.html可以把电台的 m3u 文件秒变网络歌单多个歌单还能用 xiaomusic/static/default/merge/index.html 合并成一个。⚠️ 避坑手册部署前必看的 5 个高频问题Q1网页里保存了账号密码设备列表却出不来先确认账号密码是否输错建议重新完整填写一遍再保存再确认音箱和运行 XiaoMusic 的机器在同一局域网、网络稳定。仍不行就按 Q4 下日志排查。Q2某首歌下载失败或没有资源平台版权会动态变动同一首歌换个搜索关键词、或调整配置里的search_prefix搜索源前缀再试多数情况能绕过去。Q3flac 放不出声音L05B、L05C、LX06、L16A 这几个型号不支持 flac 格式。设置页打开【转换为 MP3】和【型号兼容模式】两个开关即可。Q4出问题了去哪里看日志提 Issue 要注意什么Web 设置页底部有【下载日志文件】按钮。注意上传或贴日志前先检查并删掉里面的账号密码信息再连同日志去仓库提 Issue定位会快得多。Q5会影响音箱原有功能吗不会。XiaoMusic 只接管它识别的自定义口令放新闻定闹钟这类原有功能照常工作互不冲突。️安全提醒如果要把 XiaoMusic 暴露到公网务必在设置里开启密码登录并设复杂密码且不要在公共 WiFi 下使用另外强烈建议不要用绑定了家用摄像头的小米账号来跑这个项目——账号一旦泄露风险远不止音乐。 现在就动手你的音箱该解锁了部署只需要 20 分钟一条 Docker 命令、一个小米账号、一句播放歌曲全网音乐库就是你的了。遇到报错先翻 docs/issues/index.md 的问题集合90% 的新手坑都有现成答案想深入玩法网络歌单看 docs/issues/78.md源码入口在 xiaomusic/发现 bug 或有新想法去仓库提一个 Issue也欢迎提交前端美化或功能开发的贡献现在就去 NAS 上敲下那条docker run然后回家喊一句小爱同学播放歌曲试试。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考