XiaoMusic：让小爱音箱无限听歌的开源神器

如果你有一台小爱音箱，想要让它播放你喜欢的音乐，无论是本地收藏的歌曲还是网络上的热门曲目，那么XiaoMusic就是你需要的工具。XiaoMusic是一个开源项目，专为小爱音箱设计，让用户可以通过语音命令播放音乐，支持本地音乐文件和网络下载功能。它的安装和使用都非常简单，即使你不是技术大牛，也能轻松上手。

本文将详细介绍XiaoMusic的安装、配置和使用方法，帮助你快速解放你的小爱音箱，让音乐随心所欲地播放。

什么是XiaoMusic？

XiaoMusic是一个开源的音乐播放工具，专为小米的小爱音箱设计。它利用了yt-dlp工具来下载网络音乐，并支持多种音乐格式和设备型号。用户可以通过语音命令控制音乐播放，比如“播放歌曲周杰伦晴天”，XiaoMusic会自动下载并播放这首歌。此外，它还支持本地音乐播放、网络歌单、自定义口令等功能，让你的小爱音箱变得更加智能和实用。

XiaoMusic的主要功能

  • 语音控制：支持多种语音口令，如“播放歌曲”、“上一首”、“单曲循环”等。
  • 本地音乐播放：支持mp3、flac、wav等多种格式的本地音乐文件。
  • 网络音乐下载：通过yt-dlp工具下载网络音乐，支持自动下载和播放。
  • 网络歌单：支持配置JSON格式的网络歌单，方便管理大量音乐。
  • 多设备支持：支持多种小爱音箱型号，包括触屏版和非触屏版。
  • 安全配置：提供账号安全提醒和免责声明，确保用户使用安全。

如何安装和配置XiaoMusic？

XiaoMusic提供了两种安装方式：Docker和pip。无论你选择哪种方式，安装和配置都非常简单。下面将详细介绍这两种方式的步骤。

使用Docker安装XiaoMusic

Docker是一种容器化技术，可以让用户在隔离的环境中运行应用程序。使用Docker安装XiaoMusic非常方便，只需几行命令即可完成。

安装步骤

  1. 准备目录：在你的主机上创建两个目录，用于存放音乐文件和配置文件。例如：

    mkdir -p /xiaomusic_music
mkdir -p /xiaomusic_conf

  2. 运行Docker命令：在终端中运行以下命令，下载并启动XiaoMusic的Docker容器：

    docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic
    • -p 58090:8090：将容器的8090端口映射到主机的58090端口。
    • -e XIAOMUSIC_PUBLIC_PORT=58090：设置环境变量，告诉XiaoMusic公网端口是58090。
    • -v /xiaomusic_music:/app/music：将主机的/xiaomusic_music目录挂载到容器的/app/music目录，用于存放音乐文件。
    • -v /xiaomusic_conf:/app/conf：将主机的/xiaomusic_conf目录挂载到容器的/app/conf目录，用于存放配置文件。

  3. 访问Web界面：在浏览器中访问http://你的NAS_IP:58090，进入XiaoMusic的Web配置界面。

  4. 配置账号：在Web界面中输入你的小米账号和密码，保存后即可获取设备列表。

Docker Compose配置

如果你更喜欢使用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

将以上内容保存为docker-compose.yml文件，然后运行docker-compose up -d即可启动XiaoMusic。

使用pip安装XiaoMusic

如果你更喜欢使用Python的包管理工具pip来安装XiaoMusic，也可以轻松完成。

安装步骤

  1. 安装XiaoMusic：在终端中运行以下命令：

    pip install -U xiaomusic

  2. 配置config.json：参考项目中的config-example.json文件，创建一个config.json文件，并配置相关参数。

  3. 启动XiaoMusic：运行以下命令启动服务：

    xiaomusic --config config.json

    默认情况下，XiaoMusic会监听8090端口。你可以通过--port参数指定其他端口。

  4. 访问Web界面：在浏览器中访问http://localhost:8090，进行进一步的配置和管理。

安装注意事项

  • 目录权限：确保挂载的目录（如/xiaomusic_music和/xiaomusic_conf）有读写权限。
  • 账号配置：初次配置时，必须在Web界面输入小米账号Deputy和密码，保存后才能获取设备列表。
  • 日志文件：如果遇到问题，可以在Web界面下载日志文件，检查错误信息。

XiaoMusic的语音口令功能

XiaoMusic支持多种语音口令，让你可以通过语音命令控制音乐播放。以下是一些常用的口令及其功能：

  • 播放歌曲：播放本地的歌曲。
  • 播放歌曲+歌名：例如“播放歌曲周杰伦晴天”，会自动下载并播放指定的歌曲。
  • 上一首：播放上一首歌曲。
  • 下一首：播放下一首歌曲。
  • 单曲循环：循环播放当前歌曲。
  • 全部循环：循环播放整个歌单。
  • 随机播放：随机播放歌单中的歌曲。
  • 关机或停止播放：停止播放音乐。
  • 刷新列表：刷新音乐列表，适用于复制新歌曲到music目录后。
  • 播放列表+列表名：播放指定的歌单，例如“播放列表其他”。
  • 加入收藏：将当前播放的歌曲加入收藏歌单。
  • 取消收藏：将当前播放的歌曲从收藏歌单中移除。
  • 播放列表收藏：播放收藏歌单。
  • 播放本地歌曲+歌名：播放本地歌曲，不会下载网络歌曲。
  • 搜索播放+关键词：搜索并播放指定关键词的歌曲，例如“搜索播放林俊杰”。
  • 本地搜索播放+关键词：搜索并播放本地指定关键词的歌曲。

这些口令让用户可以轻松控制音乐播放，无需手动操作，大大提升了使用体验。

支持的设备和音乐格式

支持的设备型号

XiaoMusic支持多种小爱音箱设备型号，包括但不限于：

  • L06A（小爱音箱）
  • L07A（Redmi小爱音箱 Play）
  • S12/S12A/MDZ-25-DA（小米AI音箱）
  • LX5A（小爱音箱 万能遥控版）
  • LX05（小爱音箱Play（2019款））
  • L15A（小米AI音箱（第二代））
  • L16A（Xiaomi Sound）
  • L17A（Xiaomi Sound Pro）
  • LX06（小爱音箱Pro）
  • LX01（小爱音箱mini）
  • L05B（小爱音箱Play）
  • L05C（小米小爱音箱Play 增强版）
  • L09A（小米音箱Art）
  • LX04 X10A X08A（触屏版）
  • X08C X08E X8F（触屏版）
  • M01/XMYX01JY（小米小爱音箱HD）
  • OH2P（XIAOMI 智能音箱 Pro）
  • OH2（XIAOMI 智能音箱）

如果你的设备不在列表中，也可以尝试使用，项目支持大多数小爱音箱型号。

支持的音乐格式

XiaoMusic支持以下音乐格式：

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

需要注意的是，某些设备型号可能不支持某些格式，例如L05B、L05C、LX06和L16A不支持flac格式。如果遇到格式不支持的问题，可以尝试将音乐文件转换为mp3格式。

网络歌单功能

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

如何配置网络歌单

  1. 创建JSON歌单文件：在music目录下创建一个JSON文件，格式参考项目文档。
  2. 配置歌单：在Web界面或配置文件中指定歌单文件路径。
  3. 使用口令：通过“播放列表+列表名”口令播放网络歌单。

网络歌单功能让用户可以轻松管理大量音乐，享受更多的音乐资源。

高级功能和自定义

对于有技术基础的用户，XiaoMusic还提供了一些高级功能和自定义选项，例如：

  • 自定义口令：用户可以定义自己的语音口令，实现更多功能。
  • 配置网络歌单：支持更复杂的歌单配置，满足个性化需求。
  • 型号兼容模式：对于某些触屏版设备，可以开启兼容模式以支持播放。

详细的配置方法和示例可以在项目文档中找到，用户可以根据自己的需求进行调整。

安全提醒和免责声明

在使用XiaoMusic时，用户需要注意以下安全事项：

  1. 账号安全：如果配置了公网访问，建议开启密码登陆并设置复杂的密码。
  2. 隐私保护：不建议将小爱音箱的小米账号绑定摄像头，以防账号泄露导致监控录像泄露。

项目的免责声明明确指出，XiaoMusic仅供学习和研究目的，不得用于商业活动。用户在使用时应遵守法律法规，对于违法使用所导致的后果，项目及作者不承担任何责任。作者不保证项目的准确性、完整性、及时性、可靠性，也不承担任何因使用本项目而产生的损失或损害责任。

结语

XiaoMusic是一个功能强大且易于使用的音乐播放工具，专为小爱音箱设计。通过简单的安装和配置，用户可以享受到本地音乐和网络音乐的播放乐趣。项目支持多种设备型号和音乐格式，同时提供了丰富的语音口令和网络歌单功能。对于有技术基础的用户，XiaoMusic还提供了高级功能和自定义选项。

如果你对XiaoMusic感兴趣，欢迎访问项目的GitHub页面了解更多信息，或者加入项目的讨论区与其他用户交流。你的反馈和建议将有助于项目的持续改进和发展。

这篇博客文章详细介绍了XiaoMusic的安装、配置和使用方法，内容通俗易懂，适合专科及以上毕业生阅读。文章保留了技术内容的真实性和有效性，逻辑清晰、语言流畅，希望能帮助你快速上手XiaoMusic，享受音乐带来的乐趣。