如何用3个简单方法让小爱音箱变身你的私人音乐库

如何用3个简单方法让小爱音箱变身你的私人音乐库

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

想要让小爱音箱播放本地音乐或在线歌曲吗？XiaoMusic开源项目可以帮你实现这个梦想！这个小爱音箱音乐播放工具通过简单的配置，就能让你的小爱音箱变身私人音乐库，支持本地音乐播放和在线歌曲下载，保留完整的语音交互功能。今天我将分享3个实用方法，帮助新手快速上手XiaoMusic，享受语音控制的音乐体验。

为什么需要XiaoMusic？小爱音箱的音乐播放痛点

许多小爱音箱用户都有一个共同的困扰：音箱自带的音乐服务曲库有限，无法播放本地存储的歌曲，也无法自由选择想听的音乐。XiaoMusic解决了这个痛点，它通过以下方式扩展了小爱音箱的音乐能力：

1. 本地音乐播放：播放存储在NAS或电脑上的音乐文件
2. 在线歌曲下载：使用yt-dlp下载网络音乐并播放
3. 语音控制保留：完全保留小爱同学的语音交互功能
4. 多设备支持：兼容20+款小爱音箱型号

3种安装方法对比：选择最适合你的方案

根据你的使用场景和技术水平，可以选择以下三种安装方式：

方法一：Docker Compose安装（最推荐）

这是最简单快捷的方式，特别适合在NAS上部署：

services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf

💡小贴士：国内用户可以使用镜像docker.hanxi.cc/hanxi/xiaomusic加速下载。

方法二：Pip安装（适合技术用户）

如果你熟悉Python环境，可以使用pip直接安装：

# 安装XiaoMusic pip install -U xiaomusic # 查看帮助信息 xiaomusic --help # 启动服务（默认端口8090） xiaomusic

方法三：源码运行（适合开发者）

想要参与开发或深度定制？可以这样操作：

# 1. 克隆项目 git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic # 2. 安装依赖 ./install_dependencies.sh pdm install # 3. 启动服务 pdm run xiaomusic.py

核心配置详解：让XiaoMusic真正工作起来

安装完成后，配置是关键步骤。XiaoMusic支持多种配置方式，但最核心的是设备DID（设备唯一标识符）的设置。

配置文件的秘密

XiaoMusic的配置文件模板位于config-example.json，你需要复制并修改它：

# 复制配置文件模板 cp config-example.json config.json # 编辑配置文件 nano config.json

必须配置的3个关键参数

1. 小米账号和密码：用于连接小爱音箱
2. 设备DID：小爱音箱的唯一标识符
3. 音乐存储路径：本地音乐文件的存放位置

💡重要提示：设备DID可以在小米音箱App的"设备信息"中查看，这是连接小爱音箱的关键！

网页控制台配置（新手友好）

如果你不想手动编辑配置文件，可以使用更简单的方法：

1. 启动XiaoMusic服务
2. 浏览器访问http://localhost:8090
3. 进入"设置"页面
4. 填入小米账号和密码
5. 系统会自动获取设备列表
6. 选择你的小爱音箱完成绑定

语音控制秘籍：让小爱同学听懂你的音乐需求

配置完成后，你就可以通过语音控制播放音乐了。XiaoMusic支持丰富的语音指令：

基础播放控制

• "小爱同学，播放歌曲" - 播放本地音乐
• "小爱同学，播放歌曲周杰伦晴天" - 播放特定歌曲
• "小爱同学，上一首/下一首" - 切换歌曲
• "小爱同学，关机/停止播放" - 停止播放

播放模式切换

• "小爱同学，单曲循环" - 重复播放当前歌曲
• "小爱同学，全部循环" - 循环播放所有歌曲
• "小爱同学，随机播放" - 随机顺序播放

歌单管理

• "小爱同学，播放歌单其他" - 播放指定歌单
• "小爱同学，播放歌单收藏" - 播放收藏歌单
• "小爱同学，加入收藏" - 收藏当前歌曲

🎵隐藏技巧：对小爱同学说"播放歌曲小猪佩奇的故事"，XiaoMusic会自动下载并播放，非常适合给孩子播放故事！

常见问题解决：遇到问题怎么办？

问题1：服务启动失败

症状：端口被占用或配置文件错误解决方法：

• 检查8090端口是否被占用：netstat -tlnp | grep 8090
• 修改配置文件中的端口号
• 确保配置文件路径正确

问题2：小爱音箱无法连接

症状：设备列表为空或连接失败解决方法：

1. 确认小爱音箱和运行XiaoMusic的设备在同一局域网
2. 检查小米账号密码是否正确
3. 尝试重启小爱音箱
4. 查看日志文件定位问题

问题3：音乐无法播放

症状：能连接但播放无声解决方法：

• 检查音乐文件格式是否支持（mp3、flac、wav等）
• 查看小爱音箱型号是否兼容
• 尝试开启"转换为MP3"选项

进阶技巧：发挥XiaoMusic的全部潜力

自定义语音指令

你可以在配置文件中添加自定义语音指令：

"user_key_word_dict": { "播放我的最爱": "play_music_list_index 1", "晚安音乐": "play_music_list_index 2" }

网络歌单功能

XiaoMusic支持网络歌单，你可以：

1. 配置在线歌单URL
2. 导入M3U格式的电台列表
3. 分享歌单给其他用户

定时任务设置

通过Crontab配置，可以实现自动化播放：

• 每天早上7点播放晨间音乐
• 晚上10点自动停止播放
• 周末播放特定歌单

安全提醒：保护你的隐私和数据

⚠️重要安全提示：

1. 如果配置了公网访问，请务必开启密码登录
2. 不要在公共WiFi环境下使用XiaoMusic
3. 避免将小爱音箱绑定摄像头等敏感设备
4. 定期更新XiaoMusic到最新版本

开始你的音乐之旅吧！

现在你已经掌握了XiaoMusic的完整使用指南。无论你是想在NAS上搭建私人音乐服务器，还是想扩展小爱音箱的音乐播放能力，XiaoMusic都是一个完美的选择。

下一步行动：

1. 选择适合你的安装方式
2. 完成基础配置
3. 尝试第一个语音指令
4. 探索更多高级功能

记住，音乐应该是轻松愉快的体验。XiaoMusic让技术变得简单，让你专注于享受音乐。现在就去试试看，让你的小爱音箱焕发新生吧！🎶

官方文档：docs/index.md 配置示例：config-example.json 工具脚本：check_plugins.py

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