小爱音箱本地音乐播放说一句自动下载完整上手指南【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic下班回家喊一句“小爱播放周杰伦”音箱直接放出了《晴天》。第一次是它从网上自动下好再播第二次开始就是本地直出。这就是 XiaoMusic一个让小米小爱音箱用语音控制播放音乐、下载交给 yt-dlp 的开源工具。一、关键词区核心关键词小爱音箱音乐播放XiaoMusic语音控制自动下载长尾关键词小爱音箱怎么播放本地音乐XiaoMusic安装教程Docker部署XiaoMusic音箱自定义歌单智能音箱音乐下载工具开源音乐播放方案小爱音箱语音口令家庭音乐服务器搭建音箱播放列表管理NAS部署音乐服务二、它解决了什么问题小爱音箱一直能放歌但曲库绑在某个在线平台上想听的歌没有会员到期曲库缩水。XiaoMusic 把曲库搬回你自己的设备三件事都变了歌曲被平台限定→ 曲库换成你自己的文件加网络下载源说一句就自动下载播放不用找“有什么能听”配置门槛高→ 一条 docker 命令跑起来账号设备都在网页界面里填不用改配置文件语音口令白学了→ 原生指令“播放歌曲 / 下一首 / 单曲循环”全部兼容不用记新口令它的工作路径很直白收到口令先查本地曲库有就直接放没有就联网下载到 music 目录再放。下载过的歌会一直留在本地第二次播放不用等。设备兼容性也不用操心。官方 README 里列了从小爱音箱、Redmi 小爱音箱 Play 到 Xiaomi Sound 的完整型号清单均已测试过。家里有多台音箱的话一个服务可以同时管理网页上切换控制哪一台。本地支持的格式也不挑这几种都能扫出来mp3最常见flac、ape、wav无损格式ogg、m4a其他常见格式三、5 分钟跑起来 Docker 是最短路径。两条命令的事mkdir -p /xiaomusic_music /xiaomusic_conf docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic两个目录分别挂载进容器music 存音乐文件conf 存配置建议分开放。目录不存在会报错先跑第一条建一下就行。启动后打开http://局域网IP:58090在设置页填这几项配置项说明默认值account绑定音箱的小米账号必填空password小米账号密码必填空music_path音乐文件存放目录musichostname音箱能访问到的局域网 IPhttp://192.168.2.5port服务端口要和端口映射一致8090保存之后设备列表里能看到你的小爱音箱就说明部署成功了播放列表页面再刷出歌单就可以正式点播放了。同地址后面加/docs还能看到完整的接口文档爱折腾的可以翻一翻。国内拉镜像慢的话把 image 换成docker.hanxi.cc/hanxi/xiaomusic。更习惯 Pip 的话pip install -U xiaomusic后执行xiaomusic --config config.json配置文件参考仓库里的 config-example.json 即可。网页界面也不只是填设置点歌、搜索歌名、管理播放列表都在页面上做配合语音口令一个动手、一个动嘴两条路都通。四、按场景学功能 不照模块背功能直接上四个高频场景。让音箱自己下载歌曲你想干嘛歌不在本地库但又不想自己找链接下载怎么操作直接说“播放歌曲 周杰伦 晴天”库里有就放没有就自动搜、下、播效果第一次等几秒第二次起就是纯本地体验下载的文件会沉淀在 music 目录里用老语音口令控制新曲库你想干嘛保持原来小爱的使用习惯不学新口令怎么操作什么都不用做“下一首 / 上一首”切歌“单曲循环 / 随机播放”换模式“停止播放”停歌效果音箱大脑还是小爱只是曲库换了全家不用培训就会用按目录名播放歌单你想干嘛把一大堆音乐组织成一个个歌单怎么操作在 music 目录下建子目录比如“流行”“古典”说“播放歌单 流行”就放对应目录效果目录结构就是歌单结构复制了新文件说“刷新列表”即可同步进来接入在线电台与网络歌单你想干嘛连没有音乐文件的电台也想一起播怎么操作设置页填入分享的歌单 json 链接music_list_url或本地 json 路径电台条目 type 设 radio 就会持续播放效果本地文件和在线流进同一个播放列表语音切换无缝衔接不想下载、就想在线听的话口令里还有“在线播放”直接联网放不存到本地。收藏也是语音管的说“加入收藏”当前歌就进收藏歌单“取消收藏”拿出去“播放歌单 收藏”整单循环。五、进阶玩法如果你只想加自定义口令在config.json的user_key_word_dict里写一条口令到动作的映射对应逻辑放进plugins/目录容器部署记得把这个目录挂载出来。{ user_key_word_dict: { 测试自定义口令: exec#code1(\hello\) } }仓库自带的code1.py、httpget.py可以直接当模板抄。改完重启即可生效。如果你只想让音箱每天定时放歌用定时任务配置crontab 格式任务类型支持 play、stop、tts 文字转语音、刷新列表、设置音量等。[ {expression: 0 8 * * *, name: tts, arg1: 早上好该起床了}, {expression: 0 22 * * *, name: stop} ]任务可以指定 did多台音箱能分别定时表达式支持加# workday注释只在工作日触发。改完重启即可生效。如果你只想批量导入已有音乐把音乐文件拷进 music 目录子目录也按目录名建好然后在网页点“刷新列表”或对小爱说“刷新列表”。之后所有歌都能被语音点到按目录名整单播放。六、踩坑速查 ⚠️登录失败、设备列表不显示关掉本地代理NAS 容器网络从 bridge 改成 host米家 app 退出重登mi.com 官网重新登录一次滑块验证核对设置里账号密码无误语音口令没反应设置页打开语音口令获取对话记录开关检查口令前缀默认是“播放歌曲”重启一次容器查日志确认对话记录拉取正常歌曲链接打不开、没声音确认 hostname 是音箱能访问的局域网 IP确认端口和实际端口映射一致确认音箱与服务在同一局域网试试打开型号兼容模式flac 等格式播放不了打开“转换为 MP3”选项或提前批量转成 mp3注意转换会占 CPU体验略受影响七、安全与注意事项别用主力小米账号单独注册一个专用号真泄露了不用改全家密码该账号别绑定摄像头账号密码一旦泄露监控录像跟着有风险要公网访问就开网页密码设一个复杂密码防止陌生人动你的曲库八、资源与延伸更多配置与教程看这里FAQ问题集合文档汇总定时任务配置格式社区方面README 讨论区挂了 QQ 群和微信群入口卡住先去群里问一嘴通常有现成答案。另外还有多个第三方主题和配套小程序、手机 AppREADME 的“相关资源”一节都列了按需取用。音箱不再把曲库绑在平台上听到的都是你自己的库。现在就 docker run 起来试试。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考