小爱音箱自定义音乐播放完整指南从部署到语音点歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic对着小爱音箱说播放我整理的歌单音箱只回一句暂不支持。你的歌单卡在平台上本地音乐库却够不着。XiaoMusic 是小爱音箱自定义音乐播放方案它在本地跑一台音乐服务器用 yt-dlp 在线下载歌曲再用语音口令接管播放让你想播什么就播什么。项目速览它是什么运行在 NAS 或树莓派上的开源音乐服务器音乐用 yt-dlp 下载MIT 协议解决什么小爱音箱只能播平台曲库的问题本地 mp3、flac 等 6 种格式文件和网络歌单都能播适合谁有局域网设备、想脱离平台曲库的 18 种已测试型号的小爱/小米音箱用户原理拆解把 XiaoMusic 想成点歌台接线员它每秒拉取一次小爱的对话记录对话记录即音箱后台保存的语音交互日志一旦发现你说了以播放歌曲开头的口令就立刻用局域网音乐链接打断原流程让音箱改播你指定的歌。正因如此口令必须带对前缀说播放音乐它听不懂。快速上手新手一键路线运行容器映射 58090 到 8090 端口并挂入音乐、配置目录docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic预期容器启动后访问http://NAS_IP:58090打开 Web 后台。在设置页填入小米账号密码设备列表自动出现再按需勾选设备、保存带*的必填项即可。⚠️ 目录不存在先mkdir -p创建 ⚠️ 8090 是容器端口不要改 ⚠️ 登录失败先查 FAQ 问题集 ⚠️ 国内拉取困难可换国内镜像源详见 FAQ 问题集合镜像拉取失败、无声等问题都有对应解法。源码路线克隆仓库并准备 PDM 依赖环境git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install预期依赖安装完成无报错。启动服务pdm run xiaomusic.py预期默认监听 8090 端口访问http://localhost:8090/docs可看 API 接口文档。配置文件参考 config-example.json。实战演示场景一语音口令点歌核心目标脱手用语音控制本地音乐播放。基础操作把 mp3、flac 等文件放进挂载的 music 目录每个子目录自动成为一个播放列表对音箱说播放歌曲周杰伦晴天命中即播说播放歌单某某按目录名播放用下一首单曲循环加入收藏等口令切换和收藏进阶技巧口令词可在key_word_dict中自定义播放歌单第几个列表名能精确点歌说一个本地没有的歌名XiaoMusic 会先在线下载成 mp3 再播放省去手动搜索下载。小爱音箱 Web 后台左侧管理设备与账号中间按分类点播底部控制播放与音量场景二播放网络歌单核心目标不占硬盘直接播电台和在线歌曲。基础操作打开设置页在自定义歌单输入框填入 JSON 歌单内容歌单支持电台m3u8 格式和在线歌曲两种条目格式示例[{name:英文电台,musics:[ {name:BBC NEWS,url:https://stream.live.vc.bbcmedia.co.uk/bbc_world_service,type:radio}]}]保存后对音箱说播放歌单英文电台即可收听进阶技巧type为radio的条目持续直播不切歌网页自带 m3u 转换工具可把电台文件直接转成 JSON 歌单详见 网络歌单用法。后台播放列表按分类检索歌曲右上角切换目标设备生态与扩展Python 插件plugins/ 下每个文件名即函数名配合口令词可挂任意自定义动作JS 在线音乐插件在 Web 后台加载第三方音源在线歌曲走代理播放第三方主题pure、Tailwind、移动端播放器等主题已随仓库打包社区维护issue 区沉淀 FAQ 与歌单分享注意 README 顶部公告项目已停止维护可关注社区接力项目写在最后XiaoMusic 把小爱音箱从平台曲库的播放器变成你自己的音乐服务器。用 Docker 一键拉起对着音箱喊出歌名剩下的交给它。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考