终极指南：3步让小爱音箱变身全能音乐播放器
【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
还在为小爱音箱有限的音乐资源而烦恼吗？想让你的小爱音箱像专业播放器一样随心所欲播放任何歌曲吗？小爱音箱音乐播放器(XiaoMusic)正是你需要的解决方案。这款基于Python开发的开源工具，通过集成强大的yt-dlp下载引擎，彻底解放了小爱音箱的音乐播放能力，让你用语音指令就能畅享海量在线音乐。
🎯 为什么选择XiaoMusic？
想象一下这样的场景：早晨醒来，只需对小爱音箱说"播放周杰伦的晴天"，美妙的音乐即刻响起；工作时说"播放轻音乐"，舒缓的旋律营造完美氛围。XiaoMusic让这一切成为现实，它不仅仅是播放器，更是智能生活的好伙伴。
核心优势：
- 语音控制：支持20+种语音指令，完全解放双手
- 海量资源：基于yt-dlp，支持几乎所有主流音乐平台
- 多设备兼容：已测试支持15款小爱音箱型号
- 简单配置：只需3步即可完成安装
🚀 快速安装：选择最适合你的方式
方式一：Docker安装（推荐）
这是最快捷的安装方式，适合所有主流操作系统：
# 创建必要的目录 mkdir -p /xiaomusic_music /xiaomusic_conf # 启动容器 docker run -p 58090:8090 -e XIAOMUSIC_PUBLIC_PORT=58090 -v /xiaomusic_music:/app/music -v /xiaomusic_conf:/app/conf hanxi/xiaomusic或者使用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关键配置说明：
/xiaomusic_music：音乐文件存储目录/xiaomusic_conf：配置文件存储目录58090：Web管理界面访问端口
方式二：pip安装
如果你更喜欢传统的Python包管理：
pip install -U xiaomusic xiaomusic --config config.json方式三：源码安装
适合开发者或需要定制功能的用户：
git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic pdm install pdm run python xiaomusic.py⚙️ 配置实战：让音乐响起来
安装完成后，真正的魔法从这里开始：
第一步：访问管理界面
在浏览器中输入：http://你的设备IP:58090
你将看到XiaoMusic的Web控制台，这里是你配置所有功能的核心平台。
第二步：小米账号配置
在设置页面输入你的小米账号和密码，这是连接小爱音箱的关键。保存后系统会自动获取你的设备列表。
第三步：语音指令测试
现在可以开始享受语音控制的便利了：
# 播放指定歌曲 "播放歌曲周杰伦晴天" # 播放控制 "上一首"、"下一首"、"暂停播放" # 歌单管理 "播放列表收藏"、"加入收藏" # 智能搜索 "搜索播放林俊杰"界面功能详解：
- 左侧面板：设备控制、播放列表管理
- 中央区域：歌曲列表展示，支持搜索和双击播放
- 底部控制：播放进度、音量调节、循环模式
🎵 语音指令大全：解锁全部玩法
XiaoMusic支持丰富的语音指令，让你的小爱音箱真正智能化：
| 指令类型 | 具体指令 | 功能描述 |
|---|---|---|
| 基础播放 | "播放歌曲"、"暂停播放" | 控制音乐播放状态 |
| 歌曲搜索 | "播放歌曲+歌名"、"搜索播放+关键词" | 智能搜索并播放 |
| 播放模式 | "单曲循环"、"随机播放" | 切换播放策略 |
| 歌单管理 | "播放列表+列表名"、"加入收藏" | 个性化音乐收藏 |
隐藏彩蛋：对小爱同学说"播放歌曲小猪佩奇的故事"，会先下载故事音频，然后播放，特别适合有孩子的家庭。
🔧 高级功能：打造专属音乐空间
网络歌单配置
XiaoMusic支持自定义网络歌单，你可以：
- 配置JSON格式的歌单文件
- 使用他人分享的歌单链接
- 将M3U电台文件转换为网络歌单格式
多主题切换
项目提供多种界面主题：
- Pure主题：简洁现代的播放界面
- Tailwind主题：响应式设计，适配各种设备
- SoundScape主题：沉浸式音乐体验
📋 常见问题速查表
| 问题现象 | 解决方案 | 备注 |
|---|---|---|
| 无法获取设备列表 | 检查小米账号密码是否正确 | 首次配置必须输入 |
| 语音指令无效 | 确认设备型号在支持列表中 | 查看设备兼容性 |
| 下载速度慢 | 检查网络连接，可配置代理 | 支持多种下载源 |
🛡️ 安全提醒
为了保护你的账号安全，请注意：
- 配置公网访问时务必开启密码登录
- 避免在公共WiFi环境下使用
- 不建议将绑定摄像头的小米账号用于此项目
🎉 开始你的音乐之旅
现在，你已经完全掌握了XiaoMusic的安装和配置方法。从今天开始，你的小爱音箱将不再受限于原有的音乐库，而是成为一个真正的全能音乐播放器。无论是流行金曲、经典老歌，还是儿童故事、轻音乐，只需一句话，音乐即刻为你响起。
记住，音乐是生活中最简单的快乐，而XiaoMusic让这份快乐变得更加触手可及。现在就去试试吧，让你的小爱音箱带给你全新的音乐体验！
【免费下载链接】xiaomusic使用小爱同学播放音乐，音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
