让小爱音箱播放任何歌XiaoMusic 本地部署指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic周五晚上你对小爱说播放歌曲 陈奕迅音箱却告诉你没有版权或者开始循环播放那首会员推广曲。这类情况通常不是音箱坏了而是你被平台曲库锁住了。XiaoMusic 是一个把小爱音箱的音乐源换成自己的开源项目服务跑在你自己机器上歌曲用 yt-dlp 自动下载之后全部走本地文件音箱想放什么就放什么。小爱音箱播放本地音乐XiaoMusic Docker 部署小爱音箱语音口令小爱音箱音乐库管理开源音乐服务器小爱音箱怎么播放本地音乐XiaoMusic 安装教程小米音箱自定义歌单智能音箱音乐下载工具小爱音箱语音控制音乐XiaoMusic 定时任务配置小爱音箱 flac 播放开源音乐播放解决方案一条命令部署对 NAS 或常开的电脑来说Docker 是成本最低的一条路下面这段 compose 只做一件事把容器跑起来并把音乐和配置挂到宿主机两个目录里。services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf国内网络拉不动镜像的话把 image 换成docker.hanxi.cc/hanxi/xiaomusic即可想用 pip 的方式直接pip install -U xiaomusic再运行xiaomusic配置文件参考仓库里的 config-example.json。跑通验证三条都满足才算成功浏览器打开http://你的机器IP:58090能进管理页面在设置页填入小米账号密码并保存设备列表出现你的音箱对小爱说播放歌曲 晴天音箱出声能力全景触发它完全沿用你本来就会说的小爱口令不用重新学。播放歌曲歌名、播放歌手名字、上一首/下一首、停止播放都直接生效说一句播放歌单收藏播的就是你攒下的收藏歌单。本地库里没有的歌服务会先联网搜索下载成 MP3 存进 music 目录再播第二次起走本地。播放播放模式全靠口令切单曲循环全部循环随机播放说哪个走哪个分钟后关机可以约定播完自动停。管理歌库结构就是你的文件夹结构。把 music 目录按目录名建几个分类播放歌单目录名就能点播对应一摞加入收藏取消收藏删除歌曲都能用语音完成。家里不止一台音箱时右上角的设备下拉框可以切换控制对象。扩展配置里填一个 json 网络歌单地址别人的歌单和电台链接就能直接播m3u 电台文件也能转成网络歌单格式不用手工整理。已测试支持的设备覆盖主流型号常见的几台都列在下面型号设备L06A小爱音箱L07ARedmi 小爱音箱 PlayLX01小爱音箱 miniLX06小爱音箱 ProL16AXiaomi Sound本地库支持 mp3、flac、wav、ape、ogg、m4a在线下载下来的统一是 mp3。值得动的三个配置这三个配置都在网页设置页完成保存即生效不用重启容器。口令词映射默认前缀是播放歌曲说播放音乐它是不认的而映射表里所有口令都可以改比如把放首歌绑到播放动作上口令从此按你的习惯走。定时任务crontab_json 接受一组 cron 表达式动作覆盖 play、play_music_list、stop、tts、set_volume 这些。早上 8 点播一份歌单、晚上 11 点自动停止配一次就不用管了。[ { expression: 0 8 * * *, name: play_music_list, did: , arg1: 晨间歌单 }, { expression: 0 23 * * *, name: stop } ]搜索前缀search_prefix 默认是bilisearch:yt-dlp 的不同前缀对应不同搜索平台想换个下载源改这里就行一行搞定。这些坑我替你踩了后台登录失败设备列表是空的。现象是保存账号密码后列表始终刷新不出来日志里一串 Login Failed。原因是开了加速代理或触发了小米风控。解法关代理去小米官网完成一次人脸或滑块验证或在米家 App 退出重登能解决绝大部分情况。网页点播放正常语音口令没反应。现象是音箱只认手动操作。原因最常见的是没打开获取对话记录开关其次是说错前缀默认只认播放歌曲开头。解法打开开关口令按默认前缀说自己映射过的除外。日志写着正在播放音箱却没声音。现象是页面进度条在走音箱安静。原因通常是 hostname 填错它必须是音箱能访问到的局域网 IPv4 地址不能是 localhost改过 8090 端口映射的端口参数要同步改。解法核对地址和端口部分触屏型号再打开型号兼容模式试试。flac 文件不响或报错。现象是无损格式的歌放不出来。原因是 L05B、L05C、LX06、L16A 等型号确认不支持 flac。解法设置里打开转换为MP3代价是转码时占 CPU。最后一条跟上面一样是坑但属于预防性质如果要把服务暴露到公网务必开启密码登录并设强密码另外别用绑了摄像头的那个小米账号账号密码一旦泄露连带的是家里的监控录像。生态与扩展pure 主题 — 内置的简洁界面就是本文截图来源目录在 xiaomusic/static/pure/tailwind 主题 — 支持深浅色切换的另一套内置界面目录在 xiaomusic/static/tailwind/xiaomusicUI 第三方主题 — 社区做的移动端播放器界面卯卯音乐 — 配套微信小程序出门在外也能控制家里这台肉肉音乐 TV — 安卓 TV 端客户端文档和排错入口在 docs/ 目录其中 docs/issues/99.md 是官方 FAQ 合集出问题先去那里翻。技术栈一览后端是 Python FastAPI对外提供 REST 接口和内置的接口文档页前端是静态页面加 jQuery多套主题共用同一套接口。控制音箱靠 MiService 库走小米服务接口歌曲的搜索和下载交给 yt-dlp格式转换和转码用 ffmpeg。选 FastAPI 的顺带好处是接口文档自动生成了社区才能照着接口做出上面那些第三方前端。XiaoMusic 解决的问题很具体小爱只能播平台曲库里的歌。它的办法是把音乐库搬到你自己的机器上下载过一次之后全是本地文件会员弹窗和版权限制从此与你无关。它适合家里有一台 NAS 或常开的电脑、手上有一台小爱音箱、想少被曲库限制管着的人。下一步去看 docs/issues/99.md 里那份 FAQ它比正文覆盖面广基本能回答你跑起来之后的大部分疑问。另外提醒一句官方 README 已声明项目停止维护并有社区接力项目装之前可以先确认一下。找一台设备照着第一条命令试一次十分钟就能听到第一首歌。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 让小爱音箱播放任何歌：XiaoMusic 本地部署指南
让小爱音箱播放任何歌XiaoMusic 本地部署指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic周五晚上你对小爱说播放歌曲 陈奕迅音箱却告诉你没有版权或者开始循环播放那首会员推广曲。这类情况通常不是音箱坏了而是你被平台曲库锁住了。XiaoMusic 是一个把小爱音箱的音乐源换成自己的开源项目服务跑在你自己机器上歌曲用 yt-dlp 自动下载之后全部走本地文件音箱想放什么就放什么。小爱音箱播放本地音乐XiaoMusic Docker 部署小爱音箱语音口令小爱音箱音乐库管理开源音乐服务器小爱音箱怎么播放本地音乐XiaoMusic 安装教程小米音箱自定义歌单智能音箱音乐下载工具小爱音箱语音控制音乐XiaoMusic 定时任务配置小爱音箱 flac 播放开源音乐播放解决方案一条命令部署对 NAS 或常开的电脑来说Docker 是成本最低的一条路下面这段 compose 只做一件事把容器跑起来并把音乐和配置挂到宿主机两个目录里。services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf国内网络拉不动镜像的话把 image 换成docker.hanxi.cc/hanxi/xiaomusic即可想用 pip 的方式直接pip install -U xiaomusic再运行xiaomusic配置文件参考仓库里的 config-example.json。跑通验证三条都满足才算成功浏览器打开http://你的机器IP:58090能进管理页面在设置页填入小米账号密码并保存设备列表出现你的音箱对小爱说播放歌曲 晴天音箱出声能力全景触发它完全沿用你本来就会说的小爱口令不用重新学。播放歌曲歌名、播放歌手名字、上一首/下一首、停止播放都直接生效说一句播放歌单收藏播的就是你攒下的收藏歌单。本地库里没有的歌服务会先联网搜索下载成 MP3 存进 music 目录再播第二次起走本地。播放播放模式全靠口令切单曲循环全部循环随机播放说哪个走哪个分钟后关机可以约定播完自动停。管理歌库结构就是你的文件夹结构。把 music 目录按目录名建几个分类播放歌单目录名就能点播对应一摞加入收藏取消收藏删除歌曲都能用语音完成。家里不止一台音箱时右上角的设备下拉框可以切换控制对象。扩展配置里填一个 json 网络歌单地址别人的歌单和电台链接就能直接播m3u 电台文件也能转成网络歌单格式不用手工整理。已测试支持的设备覆盖主流型号常见的几台都列在下面型号设备L06A小爱音箱L07ARedmi 小爱音箱 PlayLX01小爱音箱 miniLX06小爱音箱 ProL16AXiaomi Sound本地库支持 mp3、flac、wav、ape、ogg、m4a在线下载下来的统一是 mp3。值得动的三个配置这三个配置都在网页设置页完成保存即生效不用重启容器。口令词映射默认前缀是播放歌曲说播放音乐它是不认的而映射表里所有口令都可以改比如把放首歌绑到播放动作上口令从此按你的习惯走。定时任务crontab_json 接受一组 cron 表达式动作覆盖 play、play_music_list、stop、tts、set_volume 这些。早上 8 点播一份歌单、晚上 11 点自动停止配一次就不用管了。[ { expression: 0 8 * * *, name: play_music_list, did: , arg1: 晨间歌单 }, { expression: 0 23 * * *, name: stop } ]搜索前缀search_prefix 默认是bilisearch:yt-dlp 的不同前缀对应不同搜索平台想换个下载源改这里就行一行搞定。这些坑我替你踩了后台登录失败设备列表是空的。现象是保存账号密码后列表始终刷新不出来日志里一串 Login Failed。原因是开了加速代理或触发了小米风控。解法关代理去小米官网完成一次人脸或滑块验证或在米家 App 退出重登能解决绝大部分情况。网页点播放正常语音口令没反应。现象是音箱只认手动操作。原因最常见的是没打开获取对话记录开关其次是说错前缀默认只认播放歌曲开头。解法打开开关口令按默认前缀说自己映射过的除外。日志写着正在播放音箱却没声音。现象是页面进度条在走音箱安静。原因通常是 hostname 填错它必须是音箱能访问到的局域网 IPv4 地址不能是 localhost改过 8090 端口映射的端口参数要同步改。解法核对地址和端口部分触屏型号再打开型号兼容模式试试。flac 文件不响或报错。现象是无损格式的歌放不出来。原因是 L05B、L05C、LX06、L16A 等型号确认不支持 flac。解法设置里打开转换为MP3代价是转码时占 CPU。最后一条跟上面一样是坑但属于预防性质如果要把服务暴露到公网务必开启密码登录并设强密码另外别用绑了摄像头的那个小米账号账号密码一旦泄露连带的是家里的监控录像。生态与扩展pure 主题 — 内置的简洁界面就是本文截图来源目录在 xiaomusic/static/pure/tailwind 主题 — 支持深浅色切换的另一套内置界面目录在 xiaomusic/static/tailwind/xiaomusicUI 第三方主题 — 社区做的移动端播放器界面卯卯音乐 — 配套微信小程序出门在外也能控制家里这台肉肉音乐 TV — 安卓 TV 端客户端文档和排错入口在 docs/ 目录其中 docs/issues/99.md 是官方 FAQ 合集出问题先去那里翻。技术栈一览后端是 Python FastAPI对外提供 REST 接口和内置的接口文档页前端是静态页面加 jQuery多套主题共用同一套接口。控制音箱靠 MiService 库走小米服务接口歌曲的搜索和下载交给 yt-dlp格式转换和转码用 ffmpeg。选 FastAPI 的顺带好处是接口文档自动生成了社区才能照着接口做出上面那些第三方前端。XiaoMusic 解决的问题很具体小爱只能播平台曲库里的歌。它的办法是把音乐库搬到你自己的机器上下载过一次之后全是本地文件会员弹窗和版权限制从此与你无关。它适合家里有一台 NAS 或常开的电脑、手上有一台小爱音箱、想少被曲库限制管着的人。下一步去看 docs/issues/99.md 里那份 FAQ它比正文覆盖面广基本能回答你跑起来之后的大部分疑问。另外提醒一句官方 README 已声明项目停止维护并有社区接力项目装之前可以先确认一下。找一台设备照着第一条命令试一次十分钟就能听到第一首歌。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考