小爱音箱音乐播放器(XiaoMusic)安装配置完全指南

小爱音箱音乐播放器(XiaoMusic)安装配置完全指南

xiaomusic 使用小爱同学播放音乐，音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic

项目基础介绍： 小爱音箱音乐播放器(XiaoMusic)是一款基于Python开发的开源软件，专为小米的小爱音箱设计。它允许用户通过小爱音箱播放在线音乐，利用yt-dlp进行音乐下载。此项目使得小爱音箱的音乐播放能力大大增强，支持多种命令控制以及自定义配置，极大提升了用户体验。

主要编程语言和技术栈：

• 主要编程语言： Python
• 关键技术与框架：
  • yt-dlp： 强大的视频和音频下载库，用于音乐资源的下载。
  • MiIO API： 用于与小爱音箱通信，控制播放等。
  • Web界面： 简易控制面板，基于HTTP服务，便于配置管理。

准备工作：

1. 安装Python环境： 确保您的系统中已安装Python 3.7或更高版本。
2. 安装Git： 用于克隆项目源代码。
3. 准备小爱音箱： 确认拥有一个小爱音箱，并注册小米账号。

详细安装步骤：

第一步：克隆项目

打开终端或命令提示符，使用以下命令克隆项目到本地：

git clone https://github.com/hanxi/xiaomusic.git
cd xiaomusic

第二步：安装依赖

使用pip安装所需的所有依赖：

pip install -r requirements.txt

或者，如果您想使用项目推荐的包管理方式：

pdm install

第三步：配置环境

1. 基本配置： 复制或创建config-example.json为config.json，并编辑该文件填入您的小米账号信息。

2. 端口和其他个性化配置： 根据需要，可在环境变量或config.json中调整，例如修改监听端口(XIAOMUSIC_PORT)。

第四步：启动服务

最简单的启动方法是直接运行：

python xiaomusic.py

或使用PDM运行：

pdm run python xiaomusic.py

如果您希望使用Docker，则需先确保Docker已安装，接着执行：

docker run -p 8090:8090 -v /path/to/local/music:/app/music -v /path/to/local/conf:/app/conf hanxi/xiaomusic

这里的路径 /path/to/local/music 和 /path/to/local/conf 需替换为您实际的音乐存储和配置文件存储路径。

第五步：配置小爱音箱

• 在Web界面（通常为 http://localhost:8090 或您设定的地址）完成初步配置，如输入小米账号密码，设置设备等。
• 根据指示配置好网络歌单、语音命令等高级功能。

第六步：享受音乐

现在，您可以使用小爱音箱的语音命令来播放音乐，例如“播放歌曲周杰伦晴天”，或通过Web控制面板进行更精细的操作。

注意事项：

• 在公共WiFi环境下避免配置公网访问，以防小米账号安全风险。
• 关注项目更新，定期同步最新代码或补丁以获得最佳体验。
• 对于遇到的具体问题，查看项目GitHub上的FAQ或直接在讨论区寻求帮助。

如此，您就可以轻松地让小爱音箱通过XiaoMusic播放海量在线音乐，享受智能家居带来的乐趣。

xiaomusic 使用小爱同学播放音乐，音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic