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

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

https://github.com/hanxi/xiaomusic

文档: https://xdocs.hanxi.cc/

已经支持在 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

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

• 【播放歌曲】，播放本地的歌曲
• 【播放歌曲+歌名】，比如：播放歌曲周杰伦晴天
• 【上一首】
• 【下一首】
• 【单曲循环】
• 【全部循环】
• 【随机播放】
• 【关机】，【停止播放】，两个效果是一样的。
• 【刷新列表】，当复制了歌曲进 music 目录后，可以用这个口令刷新歌单。
• 【播放列表+列表名】，比如：播放列表其他。
• 【加入收藏】，把当前播放的歌曲加入收藏歌单。
• 【取消收藏】，把当前播放的歌曲从收藏歌单里移除。
• 【播放列表收藏】，这个用于播放收藏歌单。
• 【播放本地歌曲+歌名】，这个口令和播放歌曲的区别是本地找不到也不会去下载。
• 【播放列表第几个+列表名】，具体见： #158
• 【搜索播放+关键词】，会搜索关键词作为临时搜索列表播放，比如说【搜索播放林俊杰】，会播放所有林俊杰的歌。
• 【本地搜索播放+关键词】，跟搜索播放的区别是本地找不到也不会去下载。

> 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 文件配置。见 #94

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

• 使用 install_dependencies.sh 下载依赖
• 使用 pdm 安装环境
• 默认监听了端口 8090 , 使用其他端口自行修改。

pdm run xiaomusic.py

如果是开发前端界面，可以通过 http://localhost:8090/docs 查看有什么接口。目前的 web 控制台非常简陋，欢迎有兴趣的朋友帮忙实现一个漂亮的前端，需要什么接口可以随时提需求。

提交前请执行

pdm lintfmt

用于检查代码和格式化代码。

docker build -t xiaomusic .

• 后端代码使用 Python 语言编写。
• HTTP 服务使用的是 FastAPI 框架，早期版本使用的是 Flask。
• 使用了 Docker ，在 NAS 上安装更方便。
• 默认的前端主题使用了 jQuery 。

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

• mp3
• flac
• wav
• ape
• ogg
• m4a

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

见 #333

• 自定义口令功能 #105
• #312
• #269
• #159

• 点击链接加入QQ频道【xiaomusic】
• 点击链接加入群聊【满 xiaomusic官方交流群1】 604526973
• 点击链接加入群聊【满 xiaomusic官方交流群2】1021062499
• 点击链接加入群聊【xiaomusic官方交流群3】 1072151477
• https://github.com/hanxi/xiaomusic/issues
• 微信群二维码

• xiaomi
• PDM
• xiaogpt
• MiService
• 实现原理
• yt-dlp
• awesome-xiaoai
• 微信小程序: 卯卯音乐
• pure 主题 xiaomusicUI
• 移动端的播放器主题
• Tailwind主题
• 一个第三方的主题
• Umami 统计
• Sentry 报错监控
• 所有帮忙调试和测试的朋友
• 所有反馈问题和建议的朋友

更多功能见 📝 文档汇总

本项目仅供学习和研究目的，不得用于任何商业活动。用户在使用本项目时应遵守所在地区的法律法规，对于违法使用所导致的后果，本项目及作者不承担任何责任。 本项目可能存在未知的缺陷和风险（包括但不限于设备损坏和账号封禁等），使用者应自行承担使用本项目所产生的所有风险及责任。 作者不保证本项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的任何损失或损害责任。 使用本项目即表示您已阅读并同意本免责声明的全部内容。

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

MIT License © 2024 涵曦