你是否遇到过用小爱音箱播放想听的歌曲时，只能试听一分钟的尴尬？XiaoMusic 正是为解决这一痛点而生的开源项目。它通过 Docker 容器或 Python 环境部署，把小爱音箱变成一台可以自由播放全网音乐的“私人点歌台”。

✨ 核心功能亮点

  1. 跨平台音乐下载
    • 内置 yt‑dlp 引擎，支持从 YouTube、Bilibili 等平台抓取音频，并自动转换为音箱可播的格式。
    • 可通过配置 XIAOMUSIC_SEARCH 切换搜索源（如 ytsearch: 或 bilisearch:）。
  2. Web 控制台 & API 接口
    • 部署后访问 http://localhost:8090  即可进入管理界面，查看设备列表、配置账号、搜索并点播歌曲。
    • 提供 FastAPI 文档（/docs），方便开发者扩展自定义功能。
  3. 多设备兼容
    • 已测试支持小米智能家庭屏 10（X10A）、Redmi 小爱触屏音箱 8（X08C）等多款型号。
    • 通过环境变量设置 MI_USER（小米账号）、MI_PASS（密码）及 MI_DID（设备 ID）即可绑定音箱。
  4. 容器化一键部署
    • 推荐使用 docker‑compose，只需配置端口映射（默认 8090）和存储卷即可启动。
    • 支持 ARM/x86 架构，可在 NAS、树莓派等低功耗设备上长期运行。

💡 使用场景

  • 家庭音响中心：将旧手机或树莓派部署 XiaoMusic，实现全家音乐自由。
  • 开发者学习：代码完全开源，前端使用 jQuery + FastAPI，适合二次开发练手。
  • NAS 伴侣：在群晖、UnRAID 等 NAS 系统中以 Docker 形式运行，兼顾存储与播放。

源代码：https://github.com/hanxi/xiaomusic