让小爱音箱秒变“无限点歌机”——XiaoMusic开源音乐增强方案

 

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

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

💡 使用场景

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

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