突破小爱音箱音源限制xiaomusic把你的音箱变成私人曲库【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你对着小爱音箱说播放我的工作歌单它却冷冰冰回一句暂不支持是不是觉得听歌体验瞬间断档本地MP3播不了、想听的歌不在内置曲库里、每次换歌都得掏出手机点半天。xiaomusic是一款让小爱音箱播放音乐的本地音乐服务器既能直接播放本地音乐又能用yt-dlp开源音视频下载工具先下载网络歌曲再播放让音箱真正做到想听就听。一、核心能力速览本地音乐直接播放音箱变身私人HiFi就像把家里的CD柜整个搬进了音箱——不接线、不配对张口就能放。xiaomusic会扫描音乐目录下mp3、flac、wav、ape、ogg、m4a共6种格式的文件你说播放歌曲周杰伦晴天它就把歌名和曲库文件自动对上。已测试支持20多种型号的小爱音箱个别老型号格式不兼容时在设置页开启【转换为MP3】即可自动转码。在线歌曲按需搜索库里没有先下载再播相当于给音箱配了一套即时下单机制说播放歌曲小猪佩奇的故事xiaomusic先用yt-dlp搜到歌曲下载成mp3存入曲库再开始播放。新歌从此沉淀在本地第二次听就走本地秒开。语音口令自定义每句指令随你改就像教音箱说自己的方言。config.json里的key_word_dict把口令和指令一一映射措辞可以全部换成你自己的习惯说法甚至能把自定义口令映射到插件调用如exec#code1(hello)执行plugins/目录里任意Python代码。把晚安设成加入收藏停止播放音箱从此懂你的黑话。Web控制台一块屏幕管多台音箱像全屋墙上的总控开关一次登录管到底。内置FastAPIPython Web框架后端服务启动后访问8090端口就是控制台设备切换、播放列表、收藏、播放模式在同一界面完成多台音箱也能逐台指使不用跑遍每个房间。二、五分钟快速上手方式一Docker一键部署步骤非开发者推荐操作目标一条命令拉起xiaomusic服务浏览器打开Web控制台。# 一键启动 xiaomusic音乐存 /xiaomusic_music配置存 /xiaomusic_conf docker run -p 58090:8090 \ -v /xiaomusic_music:/app/music \ -v /xiaomusic_conf:/app/conf \ hanxi/xiaomusic✅验证成功的标志浏览器打开 http://localhost:58090 NAS部署则用 http://NAS_IP:58090 出现xiaomusic控制台接着在账号设置页填入小米账号密码并保存设备列表出现即部署完成。方式二源码运行步骤面向开发者前置条件Python 3.10 及以上。获取代码git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic进入目录cd xiaomusic下载ffmpegbash install_dependencies.sh安装依赖并启动pdm install pdm run xiaomusic.py预期输出服务默认监听8090端口访问 http://localhost:8090 即Web控制台 http://localhost:8090/docs 可看接口文档。只想快速验证的话pip install -U xiaomusic后直接执行xiaomusic也能跑配置格式参考 config-example.json 。⚠️ 两个最常见的坑①8090是容器内固定服务端口不要改宿主机58090被占用时把它换成任意空闲端口即可②首次启动报找不到/xiaomusic_music目录先执行mkdir -p /xiaomusic_music /xiaomusic_conf建好目录再启动。国内拉取镜像慢时可把镜像名换成 docker.hanxi.cc/hanxi/xiaomusic 。三、实战场景深度体验以下场景假设你已按上文部署音箱和运行xiaomusic的机器在同一局域网。语音点播本地歌曲曲库里的歌张口就来核心目标让/mp3文件夹里的歌变成点名即播。基础操作音乐文件拷入 /xiaomusic_music 目录打开Web播放列表页确认歌曲已入库对小爱说播放歌曲周杰伦晴天下一首随机播放随意切换图1xiaomusic控制面板操作指引展示设备切换、播放列表、播放模式与进度条的完整布局进阶技巧说播放歌单子目录名如播放歌单古典整目录循环播放正在听的说一句加入收藏之后用播放歌单收藏随时召回本地听熟之后曲库里没有的歌就是下一个考验。在线歌曲按需搜索没有的曲源当场补进来核心目标本地曲库没有的歌一句话照样播放。基础操作对小爱说播放歌曲小猪佩奇的故事等待yt-dlp下载完成自动开始播放文件已存入曲库下次直接本地播放进阶技巧在设置页配置网络歌单JSON格式电台歌曲均可音箱直接点电台已有m3u电台文件用内置转换工具一键转成网络歌单JSON两台音箱、三种曲源都能管之后多设备切换就是最后一步。多设备切换与播放列表管理一块屏幕指挥全屋核心目标每台音箱的歌单和播放状态一个界面全管。基础操作网页右上角下拉框选择音箱型号在全部/所有歌曲/收藏/下载标签间切换视图双击歌曲在当前设备快速播放点播放模式按钮切全部循环/单曲循环图2xiaomusic播放列表页面展示小爱设备控制、播放列表、账号设置等左侧菜单与顶部设备下拉切换进阶技巧用config.json里的group_list把多台音箱编组一次口令全队出动老型号L05B、L16A等在设置页同时开启【转换为MP3】和【型号兼容模式】避免格式播不了四、进阶玩法与生态插件扩展能力plugins/ 目录自带code1.py、httpget.py、httppost.py等示例插件配合config.json里的exec#自定义口令即可触发任意逻辑社区还有JS在线播放插件可流式播放第三方平台音乐不落地文件直接听。安全与隐私音乐文件、歌单和播放记录全部落在你自己机器的目录里数据不过第三方云。如需公网访问务必在设置页开启Web登录密码httpauth并且别把同一小米账号再绑给摄像头。社区与迭代仓库issues区沉淀了FAQ问题合集docs/issues/ 收录了30多个高频问题的处理记录newversion.sh 等发版脚本保留在仓库中。作者已将项目接力给社区项目songloft功能更新仍在继续。从暂不支持该功能到想听什么说什么都行xiaomusic用一个本地服务、两个挂载目录就把这条路走通了。现在就去把它跑起来对小爱说播放周杰伦晴天——这一次它真的会唱。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考