小爱音箱音乐播放实战完整指南本地库在线下载10分钟跑通第一首歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是一个免费开源的小爱音箱音乐播放工具把你的本地音乐库推给小爱音箱同时用 yt-dlp 下载在线歌曲随时听而小爱同学的语音口令完全保留。下面按上手旅程带你走完部署、首播、进阶到调优的全过程。 先对号入座4 个典型场景在动手之前先看看你是不是这几类人——命中任意一条这个项目就值得装平台受限型音箱自带的音乐服务只覆盖特定平台想听的歌搜不到本地收藏根本放不了NAS/PC 音乐库型电脑或 NAS 上有一整盘 mp3、flac希望能像播客一样直接喊出来在线资源型想边下边听用 yt-dlp 把网络歌曲、电台拉下来实时播放纯语音党不想掏手机翻 APP所有操作都用嘴完成。设备方面基本不用担心小爱音箱L06A、Redmi 小爱音箱 PlayL07A、小爱音箱 ProLX06、miniLX01、Xiaomi SoundL16A、小米音箱 ArtL09A以及触屏版等主流型号都已验证可用。更完整的型号对照和讨论在官方文档docs/。还有一个隐藏收益对孩子说播放歌曲小猪佩奇的故事它会先下载再播天然适合做儿童故事机。 部署选型一条推荐路径 一条备选三种装法里不必平均了解按你的环境二选一即可推荐路径DockerNAS / 服务器 / 任意 Linux 主机适合 90% 用户不碰 Python 环境NAS群晖、威联通等均可。核心就三件事一条命令拉起容器58090是宿主端口可随意改8090是容器端口不要动docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic音乐目录和配置目录分开挂/app/music存歌、/app/conf存配置建议挂到不同目录如果报目录不存在先mkdir -p建好再启动长期运行建议改用 docker compose 并加上restart: always升级版本只需改镜像标签重新拉起数据不丢。备选路径pip 安装开发者 / 二次开发如果你要改代码、写插件直接pip install -U xiaomusic xiaomusic --config config.json配置文件可参考仓库里的模板config-example.json。⚠️ 提示作者已将重心转移项目停止更新维护社区接力的 songloft 项目在持续迭代需要新功能时值得关注一下。 从 0 到第一声最快启动路径目标只有一个——音箱出声。全程 4 步约 10 分钟起容器按上面推荐路径确认进程存活、端口可访问打开后台浏览器访问http://NAS_IP:58090填账号在 Web 设置页输入小米账号和密码并保存带*的必填项其余先不管。保存后设备列表会自动出现选择你的小爱音箱放歌把歌曲拷进挂载的 music 目录支持 mp3、flac、wav、ape、ogg、m4a然后对音箱说播放歌曲。听到声音验收通过。此时你会看到的就是下面这个控制台的完整形态——左侧是设备与歌单导航中间是播放列表和搜索框可搜本地/网络歌曲底部是播放控制和设备音量条 进阶能力按能力深度分 5 层解锁不用一次全配好按下面顺序逐层加第 1 层 · 语音口令默认就有播放、上一首/下一首、停止以及三种播放模式单曲循环、全部循环、随机播放再加加入收藏 / 取消收藏。所有口令文字都可在配置里自定义见 config-example.json 中的key_word_dict。第 2 层 · 目录即歌单music 目录下的每个子目录自动成为一个歌单口令直接说目录名播放歌单收藏、播放歌单其他。按家庭成员或心情建目录就是现成的歌单系统第 3 层 · 网络歌单与在线下载支持配置 JSON 格式的网络歌单电台和歌曲都行还能直接导入别人分享的链接项目自带 m3u 转换工具可把 m3u 电台文件一键转成网络歌单 JSON在线歌曲由 yt-dlp 下载后播放搜索前缀如bilisearch:可在配置里调整。第 4 层 · 格式兼容多数格式开箱即放但 L05B、L05C、LX06、L16A 这几个型号不支持 flac遇到有声道没声音打开转换为MP3和型号兼容模式两个开关即可。第 5 层 · 插件与主题想加歌词显示、在线播放等能力可以写 JS 插件插件源码目录plugins/也可以用第三方主题换一套界面皮肤pure、tailwind、SoundSpace 等仓库 static 目录下就内置了多套前端主题可参考。 排错速查按症状对号入座遇到不对劲别先怀疑人生按症状走流程症状一设备列表出不来 / 音箱不受控制① 确认 Web 设置页的小米账号密码已保存成功 → ② 音箱与跑服务的主机是否同一局域网 → ③ 核对设备 DID 是否正确 → ④ 重启音箱和服务再试。症状二播放状态正常但没声音① 先看设备音量条是不是被拖到最低 → ② 换一首歌再试排除单文件问题 → ③ 检查格式支持flac 机型见上文第 4 层开关→ ④ 拉日志看播放请求是否真正到达音箱。症状三在线歌曲下载失败① 确认外网连通性必要时在配置里加代理 → ② 检查 yt-dlp 依赖是否安装正常 → ③ 看下载目录权限 → ④ 换个搜索源前缀试试。所有情况通用一步在 Web 设置页底部点**【下载日志文件】**自查一遍确认里面没有账号密码等敏感信息后再贴出来求助能省掉大量来回。常见问题的沉淀合集在docs/issues/。✨ 把体验拉满几个实用细节常驻运行服务放 NAS 上 7×24 跑compose 里加restart: always断电自恢复歌单规划按家人 × 场景建目录儿童/通勤/运动语音一喊直达儿童模式给娃单独建歌单目录从源头过滤内容移动端体验手机访问时界面会自动收起为折叠菜单操作更顺手也可以换成移动端专用主题安全底线重要如果要把后台暴露到公网务必开启密码登录并设置复杂密码尽量别让绑定小爱音箱的小米账号再挂摄像头等敏感设备账号泄露的风险会外溢。到这里你的小爱音箱已经从只能听平台推什么变成了想听什么喊什么的私人音乐库。建议今晚就花 10 分钟把第一首歌放出来剩下的能力边用边解锁——下次回家进门不妨先试一句小爱同学播放歌曲周杰伦的晴天。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 小爱音箱音乐播放实战完整指南：本地库+在线下载，10分钟跑通第一首歌
小爱音箱音乐播放实战完整指南本地库在线下载10分钟跑通第一首歌【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusicxiaomusic 是一个免费开源的小爱音箱音乐播放工具把你的本地音乐库推给小爱音箱同时用 yt-dlp 下载在线歌曲随时听而小爱同学的语音口令完全保留。下面按上手旅程带你走完部署、首播、进阶到调优的全过程。 先对号入座4 个典型场景在动手之前先看看你是不是这几类人——命中任意一条这个项目就值得装平台受限型音箱自带的音乐服务只覆盖特定平台想听的歌搜不到本地收藏根本放不了NAS/PC 音乐库型电脑或 NAS 上有一整盘 mp3、flac希望能像播客一样直接喊出来在线资源型想边下边听用 yt-dlp 把网络歌曲、电台拉下来实时播放纯语音党不想掏手机翻 APP所有操作都用嘴完成。设备方面基本不用担心小爱音箱L06A、Redmi 小爱音箱 PlayL07A、小爱音箱 ProLX06、miniLX01、Xiaomi SoundL16A、小米音箱 ArtL09A以及触屏版等主流型号都已验证可用。更完整的型号对照和讨论在官方文档docs/。还有一个隐藏收益对孩子说播放歌曲小猪佩奇的故事它会先下载再播天然适合做儿童故事机。 部署选型一条推荐路径 一条备选三种装法里不必平均了解按你的环境二选一即可推荐路径DockerNAS / 服务器 / 任意 Linux 主机适合 90% 用户不碰 Python 环境NAS群晖、威联通等均可。核心就三件事一条命令拉起容器58090是宿主端口可随意改8090是容器端口不要动docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic音乐目录和配置目录分开挂/app/music存歌、/app/conf存配置建议挂到不同目录如果报目录不存在先mkdir -p建好再启动长期运行建议改用 docker compose 并加上restart: always升级版本只需改镜像标签重新拉起数据不丢。备选路径pip 安装开发者 / 二次开发如果你要改代码、写插件直接pip install -U xiaomusic xiaomusic --config config.json配置文件可参考仓库里的模板config-example.json。⚠️ 提示作者已将重心转移项目停止更新维护社区接力的 songloft 项目在持续迭代需要新功能时值得关注一下。 从 0 到第一声最快启动路径目标只有一个——音箱出声。全程 4 步约 10 分钟起容器按上面推荐路径确认进程存活、端口可访问打开后台浏览器访问http://NAS_IP:58090填账号在 Web 设置页输入小米账号和密码并保存带*的必填项其余先不管。保存后设备列表会自动出现选择你的小爱音箱放歌把歌曲拷进挂载的 music 目录支持 mp3、flac、wav、ape、ogg、m4a然后对音箱说播放歌曲。听到声音验收通过。此时你会看到的就是下面这个控制台的完整形态——左侧是设备与歌单导航中间是播放列表和搜索框可搜本地/网络歌曲底部是播放控制和设备音量条 进阶能力按能力深度分 5 层解锁不用一次全配好按下面顺序逐层加第 1 层 · 语音口令默认就有播放、上一首/下一首、停止以及三种播放模式单曲循环、全部循环、随机播放再加加入收藏 / 取消收藏。所有口令文字都可在配置里自定义见 config-example.json 中的key_word_dict。第 2 层 · 目录即歌单music 目录下的每个子目录自动成为一个歌单口令直接说目录名播放歌单收藏、播放歌单其他。按家庭成员或心情建目录就是现成的歌单系统第 3 层 · 网络歌单与在线下载支持配置 JSON 格式的网络歌单电台和歌曲都行还能直接导入别人分享的链接项目自带 m3u 转换工具可把 m3u 电台文件一键转成网络歌单 JSON在线歌曲由 yt-dlp 下载后播放搜索前缀如bilisearch:可在配置里调整。第 4 层 · 格式兼容多数格式开箱即放但 L05B、L05C、LX06、L16A 这几个型号不支持 flac遇到有声道没声音打开转换为MP3和型号兼容模式两个开关即可。第 5 层 · 插件与主题想加歌词显示、在线播放等能力可以写 JS 插件插件源码目录plugins/也可以用第三方主题换一套界面皮肤pure、tailwind、SoundSpace 等仓库 static 目录下就内置了多套前端主题可参考。 排错速查按症状对号入座遇到不对劲别先怀疑人生按症状走流程症状一设备列表出不来 / 音箱不受控制① 确认 Web 设置页的小米账号密码已保存成功 → ② 音箱与跑服务的主机是否同一局域网 → ③ 核对设备 DID 是否正确 → ④ 重启音箱和服务再试。症状二播放状态正常但没声音① 先看设备音量条是不是被拖到最低 → ② 换一首歌再试排除单文件问题 → ③ 检查格式支持flac 机型见上文第 4 层开关→ ④ 拉日志看播放请求是否真正到达音箱。症状三在线歌曲下载失败① 确认外网连通性必要时在配置里加代理 → ② 检查 yt-dlp 依赖是否安装正常 → ③ 看下载目录权限 → ④ 换个搜索源前缀试试。所有情况通用一步在 Web 设置页底部点**【下载日志文件】**自查一遍确认里面没有账号密码等敏感信息后再贴出来求助能省掉大量来回。常见问题的沉淀合集在docs/issues/。✨ 把体验拉满几个实用细节常驻运行服务放 NAS 上 7×24 跑compose 里加restart: always断电自恢复歌单规划按家人 × 场景建目录儿童/通勤/运动语音一喊直达儿童模式给娃单独建歌单目录从源头过滤内容移动端体验手机访问时界面会自动收起为折叠菜单操作更顺手也可以换成移动端专用主题安全底线重要如果要把后台暴露到公网务必开启密码登录并设置复杂密码尽量别让绑定小爱音箱的小米账号再挂摄像头等敏感设备账号泄露的风险会外溢。到这里你的小爱音箱已经从只能听平台推什么变成了想听什么喊什么的私人音乐库。建议今晚就花 10 分钟把第一首歌放出来剩下的能力边用边解锁——下次回家进门不妨先试一句小爱同学播放歌曲周杰伦的晴天。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考