用 xiaomusic 播放本地音乐让小爱音箱听懂你的歌库【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic夏夜躺在沙发上不想碰手机客厅里的小爱音箱说声播放歌曲周杰伦晴天就有声了——这是 xiaomusic 能做到的事。它是一个开源的本地音乐播放系统把 NAS 或旧电脑里的音乐库接给小爱音箱靠语音口令点播、切歌、收藏全程不用碰屏幕。 它能做什么你可以说播放歌曲歌名点播库里任意一首也支持模糊匹配歌名记不全也能找到你可以用上一首 / 下一首 / 单曲循环 / 全部循环 / 随机播放控制播放说关机停止你可以把音乐库按目录分歌单说播放歌单目录名整目录播放说加入收藏攒出常用曲单你可以让它自动下载音乐说播放歌曲小猪佩奇的故事它会先调用 yt-dlp 下载再播放 5 分钟跑起来第一步准备运行环境在 NAS 或一台常开的 Linux 电脑上装好 Docker。做完这步你应该能看到docker --version输出正常。第二步部署容器新建docker-compose.yml并启动services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/confdocker-compose up -d做完这步你应该能看到容器处于 running 状态。music 目录放你的音乐文件conf 目录自动存放配置两个目录建议分开。第三步Web 页面配置浏览器访问http://NAS_IP:58090输入小米账号密码保存后页面会拉出设备列表选中你的小爱音箱确认音乐路径后保存。做完这步你应该能在设备上听到一条提示音。 实际用起来之后如果你想按房间听不同的歌。把音乐库按目录分层目录名就是歌单名播放歌单钢琴曲、播放歌单儿歌分别对应不同文件夹。多个音箱各自配置客厅和卧室互不干扰。如果你想要自定义语音口令。在配置文件的key_word_dict里加一条映射口令就能对应任意动作也可以调用 plugins/ 里的 JS 插件key_word_dict: { 晚安音乐: play_music_list, 测试插件: exec#code1(\hello\) }保存后说晚安音乐 助眠曲单就会播放对应歌单目录。如果你想要定时播放。系统内置了基于 cron 表达式的定时任务可以定时播放、定时停止、定时调音量还支持跳过节假日配合30 分钟后关机口令睡前定时停播不用动手。⚠️ 容易踩的坑列表看着正常但音箱没声音多半是设备 IP 填了端口号或者音箱和主机不在同一局域网。IP 只填地址不带端口两边设备确保同网段。flac 文件播不出来L05B、L05C、LX06、L16A 等部分型号不支持 flac 格式。在设置里打开转换为 MP3播放时转成 mp3 再推。语音口令没反应先确认口令在key_word_dict里配置了、且命令在激活命令列表里。口令匹配有先后顺序短语越具体越靠前避免被播放歌曲抢先匹配。新放进的歌搜不到音乐目录新增文件后需要刷新。说刷新列表或在页面点扫描确认文件是 mp3 / flac / wav / ape / ogg / m4a 这些支持的格式。 适合谁 / 不太适合谁适合手上已有本地曲库NAS、硬盘盒、旧电脑家里有 20 多款已测试的小米系音箱之一习惯语音控制、单人或单家庭使用想完全摆脱在线曲库的账号和版权依赖。不太适合曲库主要存在在线平台、指望它当流媒体客户端用的需要多人协作管理歌单、云端同步收藏的以及用的是小米以外品牌音箱的——它目前只接小爱系设备。另外注意项目 README 已声明停止维护作者推荐社区接力版本部署前建议自行评估。 相关资源官方文档与配置说明docs/完整配置示例含所有自定义口令config-example.json插件示例JS/Pythonplugins/社区 FAQ 与问题反馈docs/issues/99.md网络歌单与 m3u 转换说明docs/issues/78.md音乐放在自己手里断网也想听什么就听什么。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考