🎵 使用小爱音箱播放音乐，音乐使用 yt-dlp 下载
🏠 GitHub • 📖 文档 • 💬 FAQ • 💭 讨论区
Tip
新手指南：初次安装遇到问题请查阅 💬 FAQ问题集合，一般遇到的问题都已经有解决办法。
已经支持在 web 设置页面配置其他参数，不再需要设置环境变量， docker compose 配置如下（选一个即可）：
services:
xiaomusic:
image: hanxi/xiaomusic
container_name: xiaomusic
restart: always
ports:
- 58090:8090
volumes:
- /xiaomusic_music:/app/music
- /xiaomusic_conf:/app/conf🔥 国内：
services:
xiaomusic:
image: docker.hanxi.cc/hanxi/xiaomusic
container_name: xiaomusic
restart: always
ports:
- 58090:8090
volumes:
- /xiaomusic_music:/app/music
- /xiaomusic_conf:/app/conf测试版：
services:
xiaomusic:
image: hanxi/xiaomusic:main
container_name: xiaomusic
restart: always
ports:
- 58090:8090
volumes:
- /xiaomusic_music:/app/music
- /xiaomusic_conf:/app/conf对应的 docker 启动命令如下:
docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic🔥 国内：
docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf docker.hanxi.cc/hanxi/xiaomusic测试版：
docker run -p 58090:8090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic:main
- 其中 conf 目录为配置文件存放目录，music 目录为音乐存放目录，建议分开配置为不同的目录。
- /xiaomusic_music 和 /xiaomusic_conf 是 docker 所在的主机的目录，可以修改为其他目录。如果报错找不到 /xiaomusic_music 目录，可以先执行
mkdir -p /xiaomusic_{music,conf}命令新建目录。 - /app/music 和 /app/conf 是 docker 容器里的目录，不要去修改。
- 58090 是 NAS 本地端口的。8090 是容器端口，不要去修改。
- 后台访问地址为： http://NAS_IP:58090
Note
docker 和 docker compose 二选一即可，启动成功后，在 web 页面可以配置其他参数，带有 * 号的配置是必须要配置的，其他的用不上时不用修改。初次配置时需要在页面上输入小米账号和密码保存后才能获取到设备列表。
Tip
目前安装步骤已经是最简化了，如果还是嫌安装麻烦，可以微信或者 QQ 约我远程安装，我一般周末和晚上才有时间，需要赞助个辛苦费 💰 50 元一次。
遇到问题可以去 web 设置页面底部点击【下载日志文件】按钮，然后搜索一下日志文件内容确保里面没有账号密码信息后(有就删除这些敏感信息)，然后在提 issues 反馈问题时把下载的日志文件带上。
Tip
作者写的一个游戏服务器开发实战课程 https://www.lanqiao.cn/courses/2770 ，购买时记得使用优惠码: 2CZ2UA5u 。
Tip
- 适用于 NAS 上安装的开源工具： https://github.com/hanxi/tiny-nav
- 适用于 NAS 上安装的网页打印机： https://github.com/hanxi/cups-web
- PVE 移动端 UI 界面：https://github.com/hanxi/pve-touch
- 喜欢听书的可以配合这个工具使用 https://github.com/hanxi/epub2mp3
Tip
- 🔥【广告:可用于安装 frp 实现内网穿透】
- 🔥 海外 RackNerd VPS 机器推荐，可支付宝付款。
- 不知道选哪个套餐可以直接买这个最便宜的 https://my.racknerd.com/aff.php?aff=11177&pid=923
- 也可以用来部署代理，docker 部署方法见 hanxi/blog#96
Tip
- 🔥【广告: 搭建您的专属大模型主页 告别繁琐配置难题，一键即可畅享稳定流畅的AI体验！】https://university.aliyun.com/mobile?userCode=szqvatm6
Tip
- 免费主机
- 播放歌曲 - 播放本地的歌曲
- 播放歌曲+歌名 - 例如：播放歌曲周杰伦晴天
- 上一首 / 下一首 - 切换歌曲
- 关机 / 停止播放 - 停止播放
- 单曲循环 - 重复播放当前歌曲
- 全部循环 - 循环播放所有歌曲
- 随机播放 - 随机顺序播放
- 播放歌单+目录名 - 例如：播放歌单其他
- 播放歌单第几个+列表名 - 详见 #158
- 播放歌单收藏 - 播放收藏歌单
- 加入收藏 - 将当前播放的歌曲加入收藏歌单
- 取消收藏 - 将当前播放的歌曲从收藏歌单移除
- 搜索播放+关键词 - 搜索关键词作为临时搜索列表播放，例如：搜索播放林俊杰
Tip
隐藏玩法：对小爱同学说"播放歌曲小猪佩奇的故事"，会先下载小猪佩奇的故事，然后再播放。
详见 👋 快速入门指南
# 安装
pip install -U xiaomusic
# 查看帮助
xiaomusic --help
# 启动（使用配置文件）
xiaomusic --config config.json
# 启动（使用默认端口 8090）
xiaomusicNote
config.json 文件可以参考 config-example.json 文件配置。详见 #94
-
下载依赖
./install_dependencies.sh
-
安装环境
pdm install
-
启动服务
pdm run xiaomusic.py
默认监听端口 8090，使用其他端口请自行修改。
-
查看 API 文档
访问 http://localhost:8090/docs 查看接口文档。
Note
目前的 web 控制台非常简陋，欢迎有兴趣的朋友帮忙实现一个漂亮的前端，需要什么接口可以随时提需求。
提交前请执行以下命令检查代码和格式化代码：
pdm lintfmtdocker build -t xiaomusic .- 后端：Python + FastAPI 框架
- 容器化：Docker
- 前端：jQuery
| 型号 | 设备名称 |
|---|---|
| L06A | 小爱音箱 |
| L07A | Redmi小爱音箱 Play |
| S12/S12A/MDZ-25-DA | 小米AI音箱 |
| LX5A | 小爱音箱 万能遥控版 |
| LX05 | 小爱音箱Play（2019款） |
| L15A | 小米AI音箱（第二代） |
| L16A | Xiaomi Sound |
| L17A | Xiaomi Sound Pro |
| LX06 | 小爱音箱Pro |
| LX01 | 小爱音箱mini |
| L05B | 小爱音箱Play |
| L05C | 小米小爱音箱Play 增强版 |
| L09A | 小米音箱Art |
| LX04/X10A/X08A | 触屏版音箱 |
| X08C/X08E/X8F | 触屏版音箱 |
| M01/XMYX01JY | 小米小爱音箱HD |
| OH2P | XIAOMI 智能音箱 Pro |
| OH2 | XIAOMI 智能音箱 |
Note
- 型号与产品名称对照可在 小米IoT平台 查询
- 如果你的设备支持播放，请反馈给我添加到支持列表里，谢谢
- 目前应该所有设备类型都已经支持播放，有问题可随时反馈
- mp3 - 标准音频格式
- flac - 无损音频格式
- wav - 无损音频格式
- ape - 无损音频格式
- ogg - 开源音频格式
- m4a - AAC 音频格式
Note
- 本地音乐会搜索目录下上面格式的文件，下载的歌曲是 mp3 格式
- 已知 L05B、L05C、LX06、L16A 不支持 flac 格式
- 如果格式不能播放可以打开【转换为MP3】和【型号兼容模式】选项，详见 #153
可以配置一个 json 格式的歌单，支持电台和歌曲，也可以直接用别人分享的链接。同时配备了 m3u 文件格式转换工具，可以很方便地把 m3u 电台文件转换成网络歌单格式的 json 文件。
详细用法见 #78
Note
欢迎有想法的朋友们制作更多的歌单转换工具，一起完善项目功能！
Important
- 如果配置了公网访问 xiaomusic ，请一定要开启密码登陆，并设置复杂的密码。且不要在公共场所的 WiFi 环境下使用，否则可能造成小米账号密码泄露。
- 强烈不建议将小爱音箱的小米账号绑定摄像头，代码难免会有 bug ，一旦小米账号密码泄露，可能监控录像也会泄露。
💬 GitHub Issues • 🎮 QQ频道 • 👥 QQ交流群 • 💬 微信群
我们欢迎所有形式的贡献，包括但不限于：
- 🐛 报告 Bug：在 Issues 中提交问题
- 💡 功能建议：分享你的想法和建议
- 📝 改进文档：帮助完善文档和教程
- 🎨 前端美化：优化 Web 控制台界面
- 🔧 代码贡献：提交 Pull Request
Tip
提交代码前请确保运行 pdm lintfmt 检查代码规范
更多功能见 📝 文档汇总
核心依赖
开发工具
参考资料
特别感谢
- 所有帮忙调试和测试的朋友
- 所有反馈问题和建议的朋友
- 所有贡献代码和文档的开发者
本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。 本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。 作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。 使用本项目即表示您已阅读并同意本免责声明的全部内容。
如果这个项目对你有帮助，欢迎通过以下方式支持：
点击右上角的 ⭐ Star 按钮，让更多人发现这个项目
- 💝 爱发电 - 持续支持项目发展
- 扫码请作者喝杯奶茶 ☕
- 分享给更多需要的朋友
- 提交 Bug 报告和功能建议
- 贡献代码和文档
感谢你的支持！❤️
MIT License © 2024 涵曦