小爱音箱音乐播放器(XiaoMusic)安装配置完全指南
xiaomusic 使用小爱同学播放音乐,音乐使用 yt-dlp 下载。 项目地址: https://gitcode.com/gh_mirrors/xia/xiaomusic
项目基础介绍: 小爱音箱音乐播放器(XiaoMusic)是一款基于Python开发的开源软件,专为小米的小爱音箱设计。它允许用户通过小爱音箱播放在线音乐,利用yt-dlp进行音乐下载。此项目使得小爱音箱的音乐播放能力大大增强,支持多种命令控制以及自定义配置,极大提升了用户体验。
主要编程语言和技术栈:
- 主要编程语言: Python
- 关键技术与框架:
- yt-dlp: 强大的视频和音频下载库,用于音乐资源的下载。
- MiIO API: 用于与小爱音箱通信,控制播放等。
- Web界面: 简易控制面板,基于HTTP服务,便于配置管理。
准备工作:
- 安装Python环境: 确保您的系统中已安装Python 3.7或更高版本。
- 安装Git: 用于克隆项目源代码。
- 准备小爱音箱: 确认拥有一个小爱音箱,并注册小米账号。
详细安装步骤:
第一步:克隆项目
打开终端或命令提示符,使用以下命令克隆项目到本地:
git clone https://github.com/hanxi/xiaomusic.git
cd xiaomusic
第二步:安装依赖
使用pip安装所需的所有依赖:
pip install -r requirements.txt
或者,如果您想使用项目推荐的包管理方式:
pdm install
第三步:配置环境
-
基本配置: 复制或创建
config-example.json
为config.json
,并编辑该文件填入您的小米账号信息。 -
端口和其他个性化配置: 根据需要,可在环境变量或
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