小爱音箱音乐自由终极指南：告别会员限制，打造私人音乐管家

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

还在为小爱音箱频繁提示"需要开通会员"而烦恼吗？XiaoMusic开源项目让你彻底告别平台限制，实现真正的音乐自由！这个智能解决方案能让你的小爱音箱变身私人音乐管家，支持全网音乐资源下载和本地播放，完全免费且功能强大。无论你是技术新手还是普通用户，只需简单几步就能让小爱音箱焕发新生，享受无限听歌的乐趣。

🎯 为什么你需要XiaoMusic？

想象一下这样的场景：你想听周杰伦的新歌，小爱音箱却告诉你"暂无版权"；孩子想听故事，却发现大部分内容需要付费；你想创建个性化歌单，却受限于平台限制。这些问题都是传统智能音箱用户的痛点。

XiaoMusic通过创新的技术方案解决了这些问题：

• 🎵 全网音乐资源：利用yt-dlp技术下载各种音乐平台的内容
• 📱 本地音乐库：建立专属的音乐收藏，不受网络限制
• 🎤 智能语音控制：保持原有的语音交互体验
• 🔄 格式自动转换：支持MP3、FLAC、WAV等多种格式

🚀 快速上手：三分钟完成部署

第一步：环境准备

最简单的方式是使用Docker一键部署：

docker run -p 58090:8090 \ -v /your_music_folder:/app/music \ -v /your_config_folder:/app/conf \ hanxi/xiaomusic

如果你喜欢手动安装，也可以通过Pip安装：

pip install -U xiaomusic xiaomusic --config config.json

第二步：Web界面配置

启动服务后，在浏览器访问http://你的IP:58090，进入配置界面：

在设置页面输入你的小米账号密码，系统会自动发现局域网内的小爱音箱设备。配置完成后，你的音箱就准备就绪了！

第三步：开始使用

现在你可以对小爱同学说：

• "播放歌曲周杰伦晴天"
• "下一首"
• "随机播放"
• "加入收藏"

系统会自动下载并播放你想要的音乐。

🎨 界面功能全解析

主控制面板

界面设计简洁直观，包含以下核心区域：

1. 设备控制区：切换不同的小爱音箱设备
2. 音乐分类区：按"全部/收藏/下载"筛选歌曲
3. 播放列表区：显示当前可播放的音乐
4. 播放控制区：暂停、上一首、下一首、进度调节

交互体验演示

动画展示了手风琴式菜单的交互效果，让你轻松管理音乐分类和播放列表。

🎤 语音控制秘籍

基础播放命令

• 播放歌曲+ 歌名：下载并播放指定歌曲
• 上一首/下一首：切换曲目
• 停止播放：暂停当前音乐

播放模式控制

• 单曲循环：重复播放当前歌曲
• 全部循环：循环播放所有歌曲
• 随机播放：随机顺序播放

歌单管理功能

• 播放歌单+ 目录名：播放指定目录的音乐
• 播放歌单第几个+ 列表名：精确播放特定位置
• 播放歌单收藏：播放收藏的歌单

隐藏技巧

对小爱同学说"播放歌曲小猪佩奇的故事"，系统会先下载故事音频，然后自动播放。这个功能特别适合有孩子的家庭！

🔧 进阶配置技巧

配置文件详解

核心配置文件位于config-example.json，主要配置项包括：

{ "mi_account": "你的小米账号", "mi_password": "你的密码", "music_dir": "/app/music", "download_format": "mp3", "convert_to_mp3": true }

网络歌单配置

XiaoMusic支持JSON格式的网络歌单，你可以：

1. 创建自己的在线音乐列表
2. 导入M3U格式的电台文件
3. 使用他人分享的歌单资源

详细配置方法见官方文档：docs/official.md

插件系统扩展

项目支持自定义插件开发，你可以在 plugins/ai/ 目录中找到AI功能源码，或者创建自己的插件来扩展功能。

📱 设备兼容性列表

XiaoMusic经过广泛测试，支持以下小爱音箱型号：

🎵 音乐格式支持

• MP3：标准音频格式，兼容所有设备
• FLAC：无损音频格式（部分设备需转换）
• WAV/APE：高质量无损格式
• OGG/M4A：其他常见格式

系统会自动将不兼容的格式转换为MP3，确保在所有设备上都能正常播放。

⚠️ 常见问题解决

安装问题

Q: Docker启动失败怎么办？A: 检查端口58090是否被占用，或者尝试使用其他端口。

Q: 无法连接小爱音箱？A: 确保设备在同一局域网，检查小米账号密码是否正确。

使用问题

Q: 歌曲下载失败？A: 检查网络连接，确认yt-dlp能正常访问视频平台。

Q: 播放卡顿？A: 尝试开启"型号兼容模式"和"转换为MP3"选项。

性能优化

• 定期清理临时文件减少存储占用
• 使用本地缓存提升播放响应速度
• 调整下载队列设置优化网络使用

🔒 安全注意事项

1. 账号安全：不要在公网环境中使用，避免账号泄露
2. 数据保护：定期备份配置文件和音乐库
3. 权限管理：合理设置文件访问权限

🚀 开始你的音乐自由之旅

现在你已经掌握了XiaoMusic的全部功能，是时候动手尝试了！按照以下步骤开始：

1. 克隆项目：git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic
2. 快速部署：选择Docker或Pip安装方式
3. 配置连接：通过Web界面绑定你的小爱音箱
4. 享受音乐：开始语音控制你的私人音乐库

记住，智能设备应该服务于你，而不是限制你。通过XiaoMusic，你可以重新掌控自己的音乐体验，让每一台小爱音箱都成为家庭的音乐中心。开始你的音乐自由之旅吧！

提示：项目已停止维护，建议迁移到社区接力项目 songloft-org/songloft 继续使用。

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