XiaoMusic：小爱音箱无缝播放NAS音乐，解锁免费音乐播放，无限听歌

XiaoMusic是一个开源项目，旨在为小爱音箱用户提供免费、灵活的音乐播放解决方案。通过集成强大的音乐下载工具yt-dlp，用户无需订阅任何音乐服务，即可畅享丰富的音乐资源。该项目支持多种音乐格式，并提供便捷的语音控制功能，极大地提升了用户体验。

核心功能与优势

多格式音乐支持

XiaoMusic支持包括mp3、flac、wav、ape、ogg、m4a等多种音频格式。本地音乐会在指定目录中搜索上述格式的文件，下载的歌曲默认为mp3格式。部分小爱音箱型号（如L05B、L05C、LX06、L16A）可能不支持flac格式，用户可通过开启“转换为MP3”或“型号兼容模式”选项来解决兼容性问题。

语音控制功能

XiaoMusic提供丰富的语音指令，用户可通过小爱同学实现以下操作：

播放本地歌曲
播放指定歌曲（例如：“播放歌曲周杰伦晴天”）
控制播放（上一首、下一首、暂停、停止）
设置播放模式（单曲循环、全部循环、随机播放）
管理歌单（播放列表、加入收藏、取消收藏、播放收藏）
刷新歌单列表
搜索并播放指定关键词的歌曲（例如：“搜索播放林俊杰”）
播放本地搜索结果

这些指令使得用户可以轻松地通过语音控制音乐播放，无需手动操作。

自定义口令与插件支持

XiaoMusic支持自定义语音口令，用户可以根据个人习惯设置特定的指令来控制音乐播放。此外，项目还支持插件功能，开发者可以编写自定义插件，实现更复杂的控制逻辑和功能扩展。

网络歌单功能

用户可以配置JSON格式的网络歌单，支持电台和歌曲的播放。项目还提供了将m3u格式的电台文件转换为JSON格式的工具，方便用户导入和管理网络歌单。

安装与部署

XiaoMusic支持通过Docker进行部署，提供了简洁的安装命令和配置方式。用户可以根据官方文档的指导，在本地或NAS设备上快速搭建服务。部署完成后，可通过Web界面进行进一步的配置和管理。

已经支持在 web 页面配置其他参数，docker 启动命令如下:

docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

国内：

docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf docker.hanxi.cc/hanxi/xiaomusic

对应的 docker compose 配置如下：

services:
  xiaomusic:
    image: hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090
    environment:
      XIAOMUSIC_PUBLIC_PORT: 58090
    volumes:
      - /xiaomusic_music:/app/music
      - /xiaomusic_conf:/app/conf

国内：

services:
  xiaomusic:
    image: docker.hanxi.cc/hanxi/xiaomusic
    container_name: xiaomusic
    restart: unless-stopped
    ports:
      - 58090:8090
    environment:
      XIAOMUSIC_PUBLIC_PORT: 58090
    volumes:
      - /xiaomusic_music:/app/music
      - /xiaomusic_conf:/app/conf

其中 conf 目录为配置文件存放目录，music 目录为音乐存放目录，建议分开配置为不同的目录。
/xiaomusic_music 和 /xiaomusic_conf 是 docker 所在的主机的目录，可以修改为其他目录。如果报错找不到 /xiaomusic_music 目录，可以先执行 mkdir -p /xiaomusic_{music,conf} 命令新建目录。
/app/music 和 /app/conf 是 docker 容器里的目录，不要去修改。
XIAOMUSIC_PUBLIC_PORT 是用来配置 NAS 本地端口的。8090 是容器端口，不要去修改。
后台访问地址为： http://NAS_IP:58090

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

目前安装步骤已经是最简化了，如果还是嫌安装麻烦，可以微信或者 QQ 约我远程安装，需要赞助个辛苦费 💰 50 元一次。

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

Pip 方式安装运行

> pip install -U xiaomusic
> xiaomusic --help
 __  __  _                   __  __                 _
 \ \/ / (_)   __ _    ___   |  \/  |  _   _   ___  (_)   ___
  \  /  | |  / _` |  / _ \  | |\/| | | | | | / __| | |  / __|
  /  \  | | | (_| | | (_) | | |  | | | |_| | \__ \ | | | (__
 /_/\_\ |_|  \__,_|  \___/  |_|  |_|  \__,_| |___/ |_|  \___|
          XiaoMusic v0.3.69 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 文件配置。

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