XiaoMusic

XiaoMusic  是一款极具匠心的开源项目，它宛如一份精心准备的珍贵礼物，专门为小米系列的智能音箱量身定制，诸如小爱音箱、Redmi 音箱等皆在适配之列。它的功能就如同一位体贴入微的音乐大管家。在播放音乐时，它会优先在本地查找你想听的歌曲资源，要是本地没有，便会自动从知名的视频平台 B 站（Bilibili）以及 YouTube 上获取并“搬运”过来。 XiaoMusic 是采用 Python 语言编写的，并且有着 yt – dlp 这个得力的助手相伴，在下载音乐时不仅速度飞快，而且稳定性极高。更为精妙的是，用户仅需通过语音下达指令，就能轻松实现对音乐播放的各种操作，无论是调节音量大小，还是切换歌曲，都能一一完成，让原本普通的小爱音箱瞬间化身为懂你心意的家庭 DJ 。

✨ 核心功能

• • 本地音乐播放：支持播放本地存储的音乐文件，格式包括 mp3、flac、wav、ape、ogg、m4a 等。
• • 自动下载音乐：当本地没有指定歌曲时，自动从 Bilibili 或 YouTube 下载并播放。
• • 语音控制：通过小爱音箱的语音命令控制音乐播放，如“播放歌曲周杰伦晴天”、“下一首”、“随机播放”等。
• • Docker 部署：支持使用 Docker 部署，简化安装和运行过程。
• • 多设备支持：兼容多种小爱音箱设备，包括小米AI音箱、小爱音箱Play、小爱音箱Pro等。

🛠️ 安装与使用指南

1. 使用 Docker 部署（推荐）

在支持 Docker 的设备上（如 NAS、树莓派、Windows、Linux 等），可以使用以下命令快速部署：

docker run -p 58090:8090 \
  -e XIAOMUSIC_PUBLIC_PORT=58090 \
  -v /your/music/path:/app/music \
  -v /your/conf/path:/app/conf \
  hanxi/xiaomusic

请将 /your/music/path 和 /your/conf/path 替换为您本地的音乐和配置文件目录。

2. 使用 pip 安装

如果您更倾向于使用 Python 环境运行，可以使用 pip 安装：

pip install -U xiaomusic
xiaomusic --help

安装后，您可以根据提示进行配置和运行。

3. 配置小米账号

首次使用时，需要在 Web 界面中配置您的小米账号和密码，以便获取设备列表并进行绑定。

🗣️ 支持的语音命令

XiaoMusic 支持多种语音命令，提升使用体验：

• • “播放歌曲”
• • “播放歌曲 + 歌名”（如：“播放歌曲周杰伦晴天”）
• • “下一首”
• • “上一首”
• • “随机播放”
• • “单曲循环”
• • “全部循环”
• • “停止播放”
• • “刷新列表”
• • “播放列表 + 列表名”
• • “加入收藏”
• • “取消收藏”
• • “播放列表收藏”
• • “搜索播放 + 关键词”
• • “本地搜索播放 + 关键词”

这些命令都可以通过小爱音箱的语音识别功能进行控制。

已测试支持的设备

型号与产品名称对照可以在这里查询 https://home.miot-spec.com/s/xiaomi.wifispeaker⁠