xiaomusic

使用小爱音箱播放音乐，音乐使用 yt-dlp 下载。

初次安装遇到问题请查阅 hanxi#99 上是否已经有解决办法。

最简配置运行

已经支持在 web 页面配置其他参数，docker compose 配置如下：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./music:/app/music
      - ./conf:/app/conf

对应的 docker 启动命令如下:

docker run -p 8090:8090 \
    -v ./music:/app/music \
    -v ./conf:/app/conf
    hanxi/xiaomusic

其中 conf 目录为配置文件存放目录，music 目录为音乐存放目录，建议分开配置为不同的目录。

启动成功后，在 web 页面可以配置其他参数，带有 * 号的配置是必须要配置的，其他的用不上时不用修改。初次配置时需要在页面上输入小米账号和密码保存后才能获取到设备列表。

✨✨✨ 修改默认8090端口映射 ✨✨✨

如果需要修改 8090 端口为其他端口，比如 5678，需要这样配，3个数字都需要是 5678 。见 hanxi#19

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 5678:5678
    volumes:
      - ./music:/app/music
    environment:
      XIAOMUSIC_PORT: 5678

遇到问题可以去 web 设置页面底部点击【下载日志文件】按钮，然后搜索一下日志文件内容确保里面没有账号密码信息后(有就删除这些敏感信息)，然后在提 issues 反馈问题时把下载的日志文件带上。

目前除了 XIAOMUSIC_PORT 只能在启动前配置，其他参数都可以在 web 网页里配置。

pip 方式安装运行

> pip install -U xiaomusic
> xiaomusic --help
 __  __  _                   __  __                 _
 \ \/ / (_)   __ _    ___   |  \/  |  _   _   ___  (_)   ___
  \  /  | |  / _` |  / _ \  | |\/| | | | | | / __| | |  / __|
  /  \  | | | (_| | | (_) | | |  | | | |_| | \__ \ | | | (__
 /_/\_\ |_|  \__,_|  \___/  |_|  |_|  \__,_| |___/ |_|  \___|
          XiaoMusic v0.1.92 by: github.com/hanxi

usage: xiaomusic [-h] [--port PORT] [--hardware HARDWARE] [--account ACCOUNT]
                 [--password PASSWORD] [--cookie COOKIE] [--verbose]
                 [--config CONFIG] [--ffmpeg_location FFMPEG_LOCATION]

options:
  -h, --help            show this help message and exit
  --port PORT           监听端口
  --hardware HARDWARE   小爱音箱型号
  --account ACCOUNT     xiaomi account
  --password PASSWORD   xiaomi password
  --cookie COOKIE       xiaomi cookie
  --verbose             show info
  --config CONFIG       config file path
  --ffmpeg_location FFMPEG_LOCATION
                        ffmpeg bin path
> xiaomusic --config config.json

其中 config.json 文件可以参考 config-example.json 文件配置。见 hanxi#94

不修改默认端口 8090 的情况下，只需要执行 xiaomusic 即可启动。

开发环境运行

使用 install_dependencies.sh 下载依赖
使用 pdm 安装环境
参考 xiaogpt 设置好环境变量

export MI_USER="xxxxx"
export MI_PASS="xxxx"
export MI_DID=00000
export XIAOMUSIC_SEARCH='bilisearch:'

然后启动即可。默认监听了端口 8090 , 使用其他端口自行修改。

pdm run xiaomusic.py

如果是开发前端界面，可以通过 http://localhost:8090/docs 查看有什么接口。

支持口令

播放歌曲
播放歌曲+歌名比如：播放歌曲周杰伦晴天
下一首
单曲循环
全部循环
随机播放
关机
停止播放
刷新列表
播放列表+列表名比如：播放列表其他

隐藏玩法: 对小爱同学说播放歌曲小猪佩奇的故事，会播放小猪佩奇的故事。

已测试支持的设备

型号	名称
L06A	小爱音箱
L07A	Redmi小爱音箱 Play
S12/S12A/MDZ-25-DA	小米AI音箱
LX5A	小爱音箱万能遥控版
LX05	小爱音箱Play（2019款）
L16A	Xiaomi Sound
L17A	Xiaomi Sound Pro
LX06	小爱音箱Pro
LX01	小爱音箱mini
L05B	小爱音箱Play
L05C	小米小爱音箱Play 增强版
LX04 X10A X08A	已经支持的触屏版

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

如果你的设备支持播放，请反馈给我添加到支持列表里，谢谢。目前应该所有设备类型都已经支持播放，有问题随时反馈。其他触屏版不能播放可以设置 XIAOMUSIC_USE_MUSIC_API 为 true 试试。

支持音乐格式

mp3
flac
wav
ape
ogg
m4a

本地音乐会搜索目录下上面格式的文件，下载的歌曲是 mp3 格式的。已知 L05B L05C 不支持 flac 格式。

在 Docker 里使用

docker run -e MI_USER='your-xiaomi-account' \
    -e MI_PASS='your-xiaomi-password' \
    -e MI_DID='your-xiaomi-speaker-mid' \
    -e MI_HARDWARE='L07A' \
    -e XIAOMUSIC_PROXY='proxy-for-yt-dlp' \
    -e XIAOMUSIC_HOSTNAME=192.168.2.5 \
    -e XIAOMUSIC_SEARCH='bilisearch:' \
    -p 8090:8090 \
    -v ./music:/app/music hanxi/xiaomusic

XIAOMUSIC_SEARCH 可以配置为 'bilisearch:' 表示歌曲从哔哩哔哩下载;
- 配置为 'ytsearch:' 表示歌曲从 youtube 下载。
XIAOMUSIC_PROXY 用于配置代理，默认为空;
- 当 XIAOMUSIC_SEARCH 配置为 'ytsearch:' 时在国内需要用到。
MI_HARDWARE 是小米音箱的型号，默认为'L07A'
注意端口必须映射为与容器内一致， XIAOMUSIC_HOSTNAME 需要设置为宿主机的 IP 地址，否则小爱无法正常播放。
可以把 /app/music 目录映射到本地，用于保存下载的歌曲。

XIAOMUSIC_PROXY 参数格式参考 yt-dlp 文档说明:

Use the specified HTTP/HTTPS/SOCKS proxy. To
enable SOCKS proxy, specify a proper scheme,
e.g. socks5://user:pass@127.0.0.1:1080/.
Pass in an empty string (--proxy "") for
direct connection

见 hanxi#2 和 hanxi#11

本地编译Docker Image

docker build -t xiaomusic .

docker compose 示例

使用哔哩哔哩下载歌曲:

version: '3'

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./music:/app/music
    environment:
      MI_USER: '小米账号'
      MI_PASS: '小米密码'
      MI_DID: 00000
      MI_HARDWARE: 'L07A'
      XIAOMUSIC_SEARCH: 'bilisearch:'
      XIAOMUSIC_HOSTNAME: '192.168.2.5'

使用 youtobe 下载歌曲:

version: '3'

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./music:/app/music
    environment:
      MI_USER: '小米账号'
      MI_PASS: '小米密码'
      MI_DID: 00000
      MI_HARDWARE: 'L07A'
      XIAOMUSIC_SEARCH: 'ytsearch:'
      XIAOMUSIC_PROXY: 'http://192.168.2.5:8080'
      XIAOMUSIC_HOSTNAME: '192.168.2.5'

如果想让 setting.json 文件不存储到 music 目录，可以这样配，下面的示例会把 setting.json 文件放到容器的 /app/conf 目录且映射到本地的 ./conf 目录：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./music:/app/music
      - ./conf:/app/conf
    environment:
      MI_USER: '小米账号'
      MI_PASS: '小米密码'
      XIAOMUSIC_HOSTNAME: 'docker 主机 ip'
      XIAOMUSIC_CONF_PATH: '/app/conf'

简易的控制面板

浏览器进入 http://192.168.2.5:8090

ip 是 XIAOMUSIC_HOSTNAME 设置的
8090 是默认端口
支持功能
- 显示正在播放的歌曲
- 模糊搜索本地歌曲
- 播放列表
- 删除歌曲
- 设置页面
- 配置网络歌单
- 日志文件下载

采用新的设置页面之后，必须在启动前配置的环境变量只剩下:

MI_USER
MI_PASS
XIAOMUSIC_HOSTNAME

其他的这些可以在网页里配置:

MI_DID
MI_HARDWARE
XIAOMUSIC_SEARCH
XIAOMUSIC_PROXY

网络歌单功能

可以配置一个 json 格式的歌单，支持电台和歌曲，也可以直接用别人分享的链接，同时配备了 m3u 文件格式转换工具，可以很方便的把 m3u 电台文件转换成网络歌单格式的 json 文件，具体用法见 hanxi#78

欢迎有想法的朋友们制作更多的歌单转换工具。

高级篇

自定义口令功能 hanxi#105
缺少一篇教程如何写自定义插件

讨论区

感谢

xiaomi
PDM
xiaogpt
MiService
yt-dlp
NAS部署教程
群晖部署教程
QNAS部署教程
所有帮忙调试和测试的朋友
所有反馈问题和建议的朋友

Star History

赞赏

爱发电 https://afdian.net/a/imhanxi
点个 Star ⭐
谢谢 ❤️

Lugic1993/xiaomusic