3步解锁小爱音箱全部潜力：Xiaomusic打造智能语音音乐中心

Xiaomusic是一款基于Python开发的智能音乐播放系统，通过集成yt-dlp工具实现音乐下载功能，让你可以轻松控制小爱音箱播放任意歌曲。无论是本地音乐还是在线音乐，都能通过简单的小爱语音命令进行控制，彻底解放你的双手。

🎯 为什么选择Xiaomusic？

核心优势一览

• 完全免费开源：无任何使用费用，代码透明可审计
• 5分钟极速部署：Docker一键安装，无需复杂配置
• 全能语音控制：丰富的语音指令库，彻底解放双手
• 全格式支持：兼容mp3、flac、wav、ape等主流音频格式
• 本地+在线双模式：既可以管理本地音乐库，也能在线搜索播放

与传统方案对比

传统音乐播放方案往往受限于平台版权，而Xiaomusic通过创新的技术方案，让你的小爱音箱突破限制，实现真正的自由播放体验。

🚀 3分钟快速部署指南

使用Docker一键安装

最简单的部署方式是使用Docker，只需一行命令即可启动服务：

docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic

源码部署方式

如果你更喜欢从源码部署，可以通过以下步骤操作：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
cd xiaomusic
chmod +x install_dependencies.sh
./install_dependencies.sh
python xiaomusic.py

访问控制界面

启动成功后，在浏览器访问 http://你的设备IP:58090 即可进入Xiaomusic的控制界面。

🎮 核心功能详解

智能语音控制中心

Xiaomusic支持丰富的小爱语音口令，让你彻底告别手动操作：

• "播放周杰伦的晴天" - 直接播放指定歌曲
• "切换到全部循环模式" - 调整播放模式
• "收藏当前歌曲" - 快速收藏喜欢的音乐
• "音量调到50%" - 精确控制播放音量
• "下一首" - 无缝切换歌曲

本地音乐管理系统

系统会自动扫描本地音乐文件，智能分类整理，让你轻松管理个人音乐库。支持多种音频格式，自动提取歌曲信息，生成美观的播放列表。

⚙️ 个性化功能配置

基础设置向导

初次使用只需完成两个关键配置：

1. 在[账号设置]中填写小米账号信息
2. 在[设备管理]中选择你的小爱音箱设备

高级功能探索

• 定时播放：通过[crontab.py]配置定时播放任务
• 歌单管理：支持导入导出m3u格式歌单
• 音质设置：在[设置]中调整音乐下载质量
• 插件扩展：通过[plugins/]目录安装额外功能插件

💡 实用技巧与常见问题

提升使用体验的小技巧

• 网络歌曲下载速度慢时，可以尝试切换不同的下载源
• 通过"刷新列表"命令让系统重新扫描本地音乐文件
• 使用"小爱音箱控制"功能可以远程控制设备开关机时间

常见问题解决

• 设备无法识别：尝试重启Docker容器或重新登录小米账号
• 语音命令无响应：检查网络连接或确认小爱音箱是否在线
• 音乐下载失败：检查存储空间是否充足或网络连接是否正常

🛠️ 技术架构与扩展

Xiaomusic采用模块化设计，核心功能位于[xiaomusic/]目录下，主要包括：

• [xiaomusic/api/]：提供Web API接口
• [xiaomusic/utils/]：工具函数库
• [xiaomusic/static/]：前端静态资源

通过插件系统，你可以轻松扩展功能，自定义属于你的音乐播放体验。

无论是音乐爱好者还是智能家居玩家，Xiaomusic都能为你带来全新的音乐体验。现在就开始动手，打造属于你自己的智能音乐系统吧！