XiaoMusic：让小爱音箱秒变私人音乐管家，无限音乐自由播放

XiaoMusic：让小爱音箱秒变私人音乐管家，无限音乐自由播放

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

还在为小爱音箱有限的音乐资源而烦恼吗？想要随心所欲播放任何歌曲却总被平台限制？今天我要为你介绍一个开源神器——XiaoMusic，它能彻底解放你的小爱音箱，让你通过语音控制就能播放任何想听的音乐，还能自动下载保存，打造专属的个人音乐库！

想象一下：早上起床时，只需说一句"小爱同学，播放周杰伦的晴天"，你的音箱就会立即播放这首经典歌曲；晚上想听点轻音乐，说一声"播放古典音乐歌单"，美妙的旋律即刻响起。这不再是梦想，XiaoMusic让它变成了现实！

🎯 为什么选择XiaoMusic？三大理由让你无法拒绝

1. 语音控制，无缝衔接

• 🎤 完全兼容小爱音箱原生语音系统，无需学习新指令
• 🔧 支持自定义扩展语音口令，打造个性化控制体验
• ⚡️ 零学习成本，保持你原有的使用习惯

2. 智能下载，自动管理

• 📥 首次播放自动从网络获取并下载歌曲
• 💾 后续播放直接使用本地文件，享受极速体验
• 🎵 支持MP3、FLAC、WAV、APE、OGG、M4A等多种音频格式

3. 多主题界面，随心切换

• 🎨 提供4种不同风格的Web管理界面
• 📱 响应式设计，适配手机、平板、电脑各种设备
• 🔄 可根据心情随时切换主题风格

🚀 5分钟快速部署指南：三种方式任你选

Docker一键部署（新手推荐）

这是最简单的安装方式，适合大多数用户。只需几行配置，就能快速启动：

# 创建docker-compose.yml文件 version: '3.8' services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

部署步骤：

1. 创建配置文件目录：mkdir -p /xiaomusic_{music,conf}
2. 启动服务：docker-compose up -d
3. 访问管理界面：打开浏览器输入http://你的设备IP:58090

Pip安装方式（Python用户）

如果你熟悉Python环境，这种方式更加灵活：

# 安装Python包 pip install -U xiaomusic # 查看帮助信息 xiaomusic --help # 启动服务（默认端口8090） xiaomusic # 使用自定义配置文件启动 xiaomusic --config config.json

源码运行（开发者适用）

如果你想深入了解项目或进行二次开发：

# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic # 安装依赖 cd xiaomusic ./install_dependencies.sh # 启动服务 pdm run xiaomusic.py

🎵 核心功能深度体验

语音指令大全：一句话搞定所有操作

XiaoMusic支持丰富的语音指令，让你的小爱音箱变得更智能：

基础播放控制

• "播放歌曲周杰伦" - 搜索并播放周杰伦的歌曲
• "播放歌单收藏" - 播放收藏列表中的歌曲
• "下一首" / "上一首" - 切换歌曲
• "关机" / "停止播放" - 停止播放

播放模式控制

• "单曲循环" - 重复播放当前歌曲
• "全部循环" - 循环播放所有歌曲
• "随机播放" - 随机顺序播放
• "顺序播放" - 按列表顺序播放

歌单管理功能

• "播放歌单其他" - 播放指定目录的歌单
• "播放歌单第几个列表名" - 播放指定位置的歌单
• "加入收藏" - 将当前歌曲加入收藏
• "取消收藏" - 从收藏中移除当前歌曲

智能下载系统：一次下载，永久享受

XiaoMusic内置了强大的音乐下载功能，工作流程简单高效：

1. 首次播放触发下载：当你通过语音指令播放某首歌曲时，系统会自动从网络搜索并下载
2. 本地智能缓存：下载的歌曲会保存到本地music目录，格式为MP3
3. 后续播放极速响应：再次播放同一首歌曲时，直接使用本地文件，无需重复下载
4. 格式自动转换：支持将不支持的格式自动转换为兼容格式

四大主题界面：总有一款适合你

项目提供了多种Web界面主题，满足不同用户的审美需求：

🔧 高级功能配置技巧

自定义语音指令：打造专属控制体验

通过修改配置文件，你可以添加自定义的语音指令：

"user_key_word_dict": { "播放今日推荐": "play_music_list_index#今日推荐", "播放我的最爱": "play_music_list_index#我的最爱", "播放工作音乐": "play_music_list_index#工作音乐" }

网络歌单配置：轻松导入海量音乐

XiaoMusic支持配置网络歌单，可以轻松导入别人分享的歌单链接：

1. JSON格式歌单配置：直接配置在线歌单URL
2. M3U文件转换：内置转换工具，将m3u格式的电台文件转换成网络歌单格式
3. 本地歌单管理：支持本地歌单文件的导入和管理

多设备支持：全家音箱都能用

支持同时控制多个小爱音箱设备，兼容性广泛：

❓ 常见问题快速解答

Q1: 小爱音箱无法连接到XiaoMusic服务怎么办？

解决方案：

1. 确保小爱音箱和运行XiaoMusic的设备在同一个局域网内
2. 检查防火墙设置，确保端口8090或58090已开放
3. 验证小米账号密码是否正确
4. 重启小爱音箱和XiaoMusic服务

Q2: 某些音乐格式无法播放怎么办？

解决方案：

1. 在Web设置页面开启"转换为MP3"选项
2. 启用"型号兼容模式"
3. 检查设备支持的格式列表
4. 使用ffmpeg进行格式转换

Q3: 歌曲下载速度很慢怎么办？

解决方案：

1. 检查网络连接质量
2. 配置代理服务器提升下载速度
3. 调整yt-dlp下载参数
4. 使用本地已有的音乐文件

Q4: 自定义语音指令不响应怎么办？

解决方案：

1. 确认指令格式正确
2. 检查配置文件中的关键词映射
3. 重启小爱音箱服务
4. 查看日志文件排查具体问题

🛡️ 安全使用建议

账号安全保护

1. 使用专用账号：建议创建专门的小米账号用于XiaoMusic
2. 定期修改密码：定期更新小米账号密码
3. 避免绑定摄像头：不要使用绑定摄像头的小米账号
4. 启用访问密码：在Web界面设置访问密码

网络安全配置

1. 局域网使用：建议仅在局域网内使用
2. 端口限制：不要将服务端口暴露到公网
3. HTTPS加密：如有公网访问需求，配置HTTPS加密
4. 日志管理：定期清理日志文件，避免敏感信息泄露

数据备份策略

1. 定期备份配置：备份config.json配置文件
2. 音乐文件备份：定期备份下载的音乐文件
3. 版本控制：使用Git管理配置文件变更

💡 进阶使用技巧

批量导入音乐

将已有的音乐文件直接复制到music目录，然后通过语音指令"刷新列表"更新歌单：

# 将音乐文件复制到music目录 cp /path/to/your/music/*.mp3 /xiaomusic_music/ # 或者在Web界面点击"刷新音乐库"

自定义播放列表

1. 创建分类目录：在music目录下创建子目录
2. 按分类存放音乐：将音乐文件按类型放入对应目录
3. 语音控制播放：使用"播放歌单+目录名"指令播放

性能优化建议

1. 硬件要求：建议使用至少2GB内存的设备
2. 存储空间：预留足够的存储空间存放音乐文件
3. 网络带宽：确保稳定的网络连接
4. 定期清理：清理临时文件和缓存

📚 项目架构与技术特色

核心技术栈

系统架构设计

用户语音指令 → 小爱音箱 → XiaoMusic服务 → 音乐下载/播放 → 返回结果 ↑ ↑ ↑ ↑ 语音识别 设备连接 服务处理 音乐管理

数据流说明

1. 语音指令接收：小爱音箱接收用户语音指令
2. 指令解析：XiaoMusic解析指令并执行相应操作
3. 音乐处理：搜索、下载、播放音乐文件
4. 结果返回：将播放结果返回给小爱音箱

🌟 总结：开启智能音乐新体验

XiaoMusic为小爱音箱用户带来了前所未有的音乐播放自由，通过简单的配置就能享受智能语音控制的便捷体验。无论是想听经典老歌还是最新热门单曲，都能通过简单的语音指令实现，真正让智能音箱成为你的私人音乐管家。

核心价值总结：

1. 解放限制：彻底打破平台音乐资源限制
2. 智能管理：自动下载和本地缓存管理
3. 语音控制：无缝对接小爱音箱原生指令
4. 多主题选择：满足不同用户的审美需求
5. 开源免费：完全开源，持续更新

未来发展方向：

1. AI推荐：基于听歌习惯的智能推荐
2. 多平台支持：扩展到更多智能音箱品牌
3. 云同步：多设备间音乐库同步
4. 社区歌单：用户分享和发现优质歌单

现在就开始你的智能音乐之旅吧！只需几分钟的部署时间，就能让你的小爱音箱焕发新生，成为真正的私人音乐管家。无论你是技术爱好者还是普通用户，XiaoMusic都能为你带来全新的音乐体验！

温馨提示：使用过程中遇到任何问题，可以参考项目文档中的常见问题解答，或者查看官方文档获取更多帮助信息。

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