如何让小爱音箱播放本地音乐：XiaoMusic 部署与配置指南

如何让小爱音箱播放本地音乐XiaoMusic 部署与配置指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对小爱音箱说播放歌曲 周杰伦它自带的曲库经常搜不到歌。XiaoMusic 是一个跑在后台的开源音乐播放服务拦截语音口令缺少的音乐用 yt-dlp 自动下载存到本地再让小爱音箱直接播放。 它能做什么一句话把音箱的播放源从平台曲库换成你自己的音乐库。语音点播口令前缀播放歌曲加歌名即可从本地库播放在线播放、播放歌手等口令在本地没有的歌会先下载再播放。曲库自动扫描自动识别音乐目录下 mp3、flac、wav、ape、ogg、m4a 格式的文件拷进去就能点。语音控制上一首/下一首、单曲循环、全部循环、随机播放、按歌单播放、加入收藏/取消收藏、关机全部语音完成。Web 管理界面搜索、删除、收藏歌曲切换播放设备查看下载进度所有参数都在页面上改不需要动配置文件。网络歌单支持 json 格式的网络歌单电台、在线歌曲并附带 m3u 电台文件转 json 的工具。⚙️ 它是怎么做到的整体是一个 Python FastAPI 写的 Web 服务启动后默认监听 8090 端口核心流程四步用小米账号通过 MiService 接口登录小米服务持续拉取小爱同学的对话记录从中识别播放口令口令触发后先检索本地曲库没有就按配置的来源前缀默认 B 站搜索调 yt-dlp 下载必要时用 ffmpeg 转成 mp3、做响度均衡下载完的音乐存入本地目录服务给音箱下发一个 HTTP 播放链接音箱从你的服务器拉流播放歌曲列表、设备管理、设置项全部由 FastAPI 路由提供接口前端是网页页面。 快速上手启动容器把 8090 映射到宿主机任意端口音乐目录和配置目录分开挂载docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic不用 docker 也可以执行pip install -U xiaomusic然后用xiaomusic --config config.json启动。浏览器打开http://宿主机IP:58090设置页里首次填入小米账号和密码保存后才会拉出设备列表。对着音箱说播放歌曲验证本地有的直接播没有的进下载流程。配置文件关键字段说明参照 config-example.json 模板常用字段如下{ account: 小米账号, password: 小米密码, music_path: music, hostname: http://192.168.2.5, port: 8090, search_prefix: bilisearch:, convert_to_mp3: false }account/password小米账号与密码必填hostname音箱所在局域网内能访问到的地址须为 IPv4别填 localhostport默认 8090改端口要同步改其他引用处search_prefix在线搜索来源前缀默认 bilisearch: 走 B 站convert_to_mp3下载后统一转 mp3型号兼容时有用进阶玩法自定义语音口令在配置里往user_key_word_dict加词值可以写exec#code1(...)或exec#httpget(...)把晨间唤醒这类自定义词绑定到一段执行逻辑或一个 HTTP 请求。示例代码在 plugins/ 目录。在线音乐插件内置 JS 插件机制可接入 LXServer、MusicFree 等在线音乐源字段结构见 xiaomusic/plugins-config-example.json插件管理逻辑在 xiaomusic/js_plugin_manager.py配置入口在 Web 端的在线搜索设置页。曲库管理与多前端控制台里全部 / 所有歌曲 / 收藏 / 下载四个页签按设备维度管理歌曲xiaomusic/static/ 下还内置了 pure、tailwind、xplayer 等多套前端页面可按喜好切换。⚠️ 避坑指南问题登录失败后台看不到设备列表解答先核对账号密码仍失败可改用 cookie 登录或在 mi.com 官网重新登录过一次滑块验证。问题语音口令不生效解答语音口令获取对话记录默认关闭需在设置页打开口令要带播放歌曲前缀说播放音乐是不识别的。问题日志显示正在播放但没声音解答检查hostname是否为音箱同局域网可访问的地址端口若改过 8090 要同步修改。问题flac 歌曲播不了解答部分型号不支持 flac在设置里打开转换为MP3或型号兼容模式。只依赖语音点播和本地曲库的话默认配置基本够用遇到问题先查 docs/issues/ 里的 FAQ 集合。源码主体在 xiaomusic/ 目录项目文档见 docs/index.md。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考