3步打造智能音乐站：让小爱音箱秒变全能音乐中心

3步打造智能音乐站：让小爱音箱秒变全能音乐中心

【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic

🎯 项目价值概述

Xiaomusic是一款专为小爱音箱设计的开源音乐播放系统，通过智能整合yt-dlp下载工具与音乐管理功能，让普通音箱升级为集本地播放、网络音乐下载、语音控制于一体的智能音乐中心。无需编程基础，5分钟即可完成部署，让你的小爱音箱突破原厂限制，实现个性化音乐体验。无论是收藏多年的本地音乐库，还是热门网络歌曲，都能通过简单语音指令轻松掌控，重新定义智能音箱的音乐播放能力。

🚀 核心优势对比

📋 环境准备清单

• 操作系统：Windows 10/11、macOS 10.15+或任意Linux发行版
• Python环境：Python 3.7及以上版本（仅手动安装需要）
• 硬件要求：最低1GB内存，5GB可用存储空间
• 网络条件：稳定的互联网连接（用于音乐下载和设备通信）
• 小爱设备：任意型号小爱音箱（确保与安装设备在同一局域网）

🔧 安装方案一：Docker容器部署

目标：通过容器化方式快速部署完整系统

操作步骤：

1. 创建数据目录

mkdir -p /xiaomusic_music /xiaomusic_conf

用途：建立音乐存储和配置文件的持久化目录

2. 启动容器

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

用途：通过Docker镜像启动服务，映射端口并挂载数据卷

3. 验证部署 打开浏览器访问http://设备IP:58090，出现控制界面即部署成功

[!TIP] 若58090端口被占用，可替换为其他端口（如8080:8090），同时修改环境变量XIAOMUSIC_PUBLIC_PORT为新端口

🔧 安装方案二：Python源码部署

目标：通过源码方式安装，适合二次开发

操作步骤：

1. 获取项目代码

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic

用途：从代码仓库克隆最新版本

2. 配置环境

python -m venv venv source venv/bin/activate # Windows使用：venv\Scripts\activate pip install -r requirements.txt cp config-example.json config.json

用途：创建虚拟环境并安装依赖，复制配置文件模板

3. 启动服务

python xiaomusic.py

用途：启动应用服务，默认监听8090端口

🎮 基础功能演示

配置设备连接

1. 访问Web控制台，点击左侧"账号设置"输入小米账号
2. 在"小爱设备控制"中选择需要绑定的音箱
3. 验证连接状态，显示设备在线即完成绑定

语音指令体验

• "小爱同学，播放周杰伦晴天" - 自动搜索并播放歌曲
• "小爱同学，单曲循环" - 切换播放模式
• "小爱同学，下一首" - 播放列表切换
• "小爱同学，停止播放" - 暂停当前播放

音乐管理功能

• 本地音乐：系统自动扫描music目录下的所有音频文件
• 网络搜索：在搜索框输入关键词获取网络音乐资源
• 播放列表：创建自定义歌单，支持拖拽排序
• 下载管理：查看正在下载和已完成的音乐任务

🛠️ 常见问题速解

设备连接失败

• 确认音箱与服务器在同一网络
• 检查小米账号密码是否正确
• 尝试重启音箱后重新配对

音乐下载缓慢

[!TIP] 网络音乐下载速度受源站限制，建议避开高峰时段下载，或通过"设置-下载配置"调整并发数

播放无声音

• 检查音箱音量是否开启
• 确认当前选择的播放设备正确
• 尝试播放本地测试音频文件

💡 高级玩法探索

自定义语音指令

通过修改配置文件custom_commands.json，添加个性化语音指令：

{ "早上好": "播放歌单 清晨唤醒", "睡前音乐": "播放歌单 助眠轻音乐" }

插件扩展功能

项目plugins目录提供多种功能扩展：

• httpget.py：通过HTTP请求控制播放
• code1.py：自定义代码执行插件
• 可开发新插件实现定时播放、天气播报等功能

歌单同步

将音乐列表导出为M3U格式，通过"导入歌单"功能实现多设备同步，或使用网络歌单API自动更新热门歌曲。

[!TIP] 定期执行update-holiday.sh脚本可更新节假日特殊播放列表，让音乐体验更具节日氛围

🎯 使用技巧集锦

1. 快捷键操作：在播放界面按空格键快速暂停/播放，左右方向键调整进度
2. 音质设置：在"设置-音频"中选择适合音箱的音质参数，平衡音质与网络消耗
3. 定时关闭：通过"小爱设备控制"设置自动关机时间，避免夜间持续播放
4. 批量操作：按住Ctrl键可多选歌曲进行批量删除或添加到歌单
5. 日志排查：遇到问题时查看logs目录下的应用日志，快速定位故障原因

通过以上步骤，你已经掌握了Xiaomusic的核心使用方法。这个开源项目不仅打破了小爱音箱的功能限制，更通过灵活的扩展机制满足个性化需求。无论是音乐爱好者还是智能设备玩家，都能在这里找到属于自己的音乐管理方案。现在就开始探索，让你的小爱音箱焕发全新活力吧！

【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic