XiaoMusic 是一个开源项目，旨在通过小爱音箱播放音乐，支持本地和网络音乐资源的无缝整合。该项目允许用户通过语音命令控制播放，如播放歌曲、上一首、下一首、单曲循环、全部循环、随机播放等。XiaoMusic 使用 yt-dlp 下载音乐文件，支持多种音频格式，包括 mp3、flac、wav、ape、ogg、m4a 等。
- XiaoMusic官网入口网址：https://xdocs.hanxi.cc/
- XiaoMusic开源项目地址：https://github.com/hanxi/xiaomusic
- XiaoMusic安装部署说明：https://xdocs.hanxi.cc/issues/
- 如果你看不懂官方提供的教程，可以在网上搜索其他网友分享的XiaoMusic相关教程，你也可以点击：链接，查看b站相关博主分享的XiaoMusic安装部署视频教程。
功能特点
- 语音控制：用户可以通过小爱音箱的语音指令控制播放，如“播放歌曲陈奕迅十年”或“下一首”。
- 本地与网络音乐支持：XiaoMusic 支持本地音乐文件和网络音乐资源的播放。如果本地没有特定歌曲，系统会自动从 B 站或 YouTube 下载并存储为 MP3 格式 。
- Docker 部署：XiaoMusic 可以通过 Docker 容器进行部署，支持多种 NAS 设备（如威联通、绿联、飞牛、群晖等）的快速安装和配置。用户可以通过 Docker Compose 文件指定镜像、重启策略、挂载路径和环境变量 。
- Web 管理界面：XiaoMusic 提供了一个 Web 管理界面，用户可以通过浏览器访问，进行音乐管理、播放列表配置、设备设置等操作 。
- 自定义口令：用户可以设置自定义口令，通过语音指令调用特定功能，如“播放歌曲”或“停止播放”。
- 歌单管理：XiaoMusic 支持 JSON 格式的歌单管理，用户可以轻松创建和管理自己的音乐库 。
- 安全设置：为了确保安全，建议开启密码登录并设置复杂密码，避免在公共场所的 WiFi 环境下使用 。
部署与配置
- Docker 部署：用户可以通过 Docker Compose 文件快速部署 XiaoMusic。例如，在 NAS 上创建一个 docker-compose.yml 文件，指定镜像、端口映射、卷挂载和环境变量 。
- 环境变量配置：XiaoMusic 支持多种环境变量配置，如 MI_USER（小米账号）、MI_PASS（小米密码）、XIAOMUSIC_SEARCH（指定音乐来源，如 B 站或 YouTube）等 。
- 音乐文件管理：用户可以将音乐文件存储在 NAS 的指定目录中，XiaoMusic 会自动扫描并播放这些文件。如果本地没有特定歌曲，系统会自动从网络下载 。
- Web 界面访问：用户可以通过浏览器访问 XiaoMusic 的 Web 管理界面，进行播放列表管理、设备设置等操作。默认端口通常是 8090 或 58090 。
社区与支持
XiaoMusic 有一个活跃的社区，用户可以通过 GitHub 仓库提交问题、报告错误或提出建议。此外，项目还提供了 QQ 群和交流群，方便用户交流和获取帮助。
XiaoMusic 是一个功能强大且灵活的开源项目，旨在通过小爱音箱播放音乐，支持本地和网络音乐资源的无缝整合。通过 Docker 部署和 Web 管理界面，用户可以轻松管理和控制音乐播放。该项目不仅解决了小爱音箱播放源受限的问题，还推动了开源精神和网络共享文化的发展 。
