XiaoMusic完整使用指南:如何让小爱音箱变身全能音乐播放器
2026-02-07 05:35:24作者:宗隆裙
XiaoMusic是一个创新的开源项目,它能够将你的小爱音箱变成功能强大的本地音乐播放器。通过集成yt-dlp下载工具,XiaoMusic不仅支持播放本地音乐文件,还能自动下载网络音乐资源,为你的智能家居生活增添更多音乐乐趣。
项目核心功能概述
XiaoMusic的核心价值在于它完美结合了小爱音箱的语音控制优势与本地音乐播放的灵活性。无论你是音乐爱好者还是智能家居用户,这个项目都能为你带来全新的音乐体验。
主要特色功能
- 语音口令控制:通过简单口令即可播放音乐、切换歌曲、调节音量
- 自动音乐下载:使用yt-dlp从网络获取音乐资源
- 多设备支持:兼容各种型号的小爱音箱设备
- 多种音乐格式:支持mp3、flac、wav、ape、ogg、m4a等主流格式
- 网络歌单功能:支持JSON格式歌单和M3U文件转换
快速部署指南
Docker部署方式
对于大多数用户来说,Docker是最简单快捷的部署方式。以下是推荐的配置:
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用于存放配置文件 - 访问地址:http://你的NAS_IP:58090
语音口令功能详解
XiaoMusic支持丰富的语音口令,让你的音乐播放体验更加自然流畅:
基础播放控制
- "播放歌曲" - 播放本地歌曲
- "播放歌曲+歌名" - 如"播放歌曲周杰伦晴天"
- "上一首"、"下一首" - 歌曲切换
- "单曲循环"、"全部循环"、"随机播放" - 播放模式切换
高级功能口令
- "刷新列表" - 更新音乐库
- "加入收藏" - 收藏当前歌曲
- "搜索播放+关键词" - 智能搜索并播放
设备兼容性说明
XiaoMusic已经测试支持多种小爱音箱型号,包括:
| 型号 | 设备名称 |
|---|---|
| L06A | 小爱音箱 |
| L07A | Redmi小爱音箱 Play |
| S12/S12A | 小米AI音箱 |
| LX5A | 小爱音箱万能遥控版 |
常见问题解决方案
配置问题处理
在升级版本后如果遇到UI无法访问的问题,可以尝试以下操作:
- 删除旧的
setting.json配置文件 - 重新启动XiaoMusic服务
- 系统会自动生成新的配置文件
音乐格式兼容性
- 大部分设备支持mp3、wav、ogg、m4a格式
- 部分设备如L05B、L05C、LX06、L16A不支持flac格式
- 遇到格式不兼容时可开启"转换为MP3"选项
安全使用建议
为了确保你的账号安全,请遵循以下建议:
- 公网访问必设密码:如果配置公网访问,务必开启密码登录并设置复杂密码
- 避免公共WiFi:不要在公共场所的WiFi环境下使用
- 账号分离:不建议将绑定摄像头的小米账号用于XiaoMusic
进阶功能探索
自定义口令功能
通过项目的高级配置,你可以自定义专属的语音口令,让音乐控制更加个性化。
网络歌单配置
XiaoMusic支持网络歌单功能,你可以:
- 配置JSON格式的歌单
- 使用M3U文件转换工具
- 分享和使用他人制作的歌单
技术架构解析
XiaoMusic采用了现代化的技术栈:
- 后端:Python语言,FastAPI框架
- 前端:多种主题可选(jQuery、Pure、Tailwind等)
- 容器化:Docker部署,支持NAS环境
使用场景示例
家庭音乐中心
将XiaoMusic部署在家庭NAS上,配合多个小爱音箱设备,打造全屋音乐系统。
个人音乐库管理
利用自动下载功能,构建个性化的音乐收藏库。
维护与更新
项目持续更新,建议定期检查新版本以获取最新功能。更新前请备份重要配置,避免数据丢失。
通过本指南,相信你已经对XiaoMusic有了全面的了解。这个项目不仅功能强大,而且部署简单,是提升小爱音箱使用体验的理想选择。
登录后查看全文
热门项目推荐
相关项目推荐
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00- QQwen3-Coder-Next2026年2月4日,正式发布的Qwen3-Coder-Next,一款专为编码智能体和本地开发场景设计的开源语言模型。Python00
xw-cli实现国产算力大模型零门槛部署,一键跑通 Qwen、GLM-4.7、Minimax-2.1、DeepSeek-OCR 等模型Go06
PaddleOCR-VL-1.5PaddleOCR-VL-1.5 是 PaddleOCR-VL 的新一代进阶模型,在 OmniDocBench v1.5 上实现了 94.5% 的全新 state-of-the-art 准确率。 为了严格评估模型在真实物理畸变下的鲁棒性——包括扫描伪影、倾斜、扭曲、屏幕拍摄和光照变化——我们提出了 Real5-OmniDocBench 基准测试集。实验结果表明,该增强模型在新构建的基准测试集上达到了 SOTA 性能。此外,我们通过整合印章识别和文本检测识别(text spotting)任务扩展了模型的能力,同时保持 0.9B 的超紧凑 VLM 规模,具备高效率特性。Python00
KuiklyUI基于KMP技术的高性能、全平台开发框架,具备统一代码库、极致易用性和动态灵活性。 Provide a high-performance, full-platform development framework with unified codebase, ultimate ease of use, and dynamic flexibility. 注意:本仓库为Github仓库镜像,PR或Issue请移步至Github发起,感谢支持!Kotlin08
VLOOKVLOOK™ 是优雅好用的 Typora/Markdown 主题包和增强插件。 VLOOK™ is an elegant and practical THEME PACKAGE × ENHANCEMENT PLUGIN for Typora/Markdown.Less00
热门内容推荐
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
532
3.75 K
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
336
178
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
886
596
Ascend Extension for PyTorch
Python
340
405
暂无简介
Dart
772
191
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
12
1
openJiuwen agent-studio提供零码、低码可视化开发和工作流编排,模型、知识库、插件等各资源管理能力
TSX
986
247
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
416
4.21 K
React Native鸿蒙化仓库
JavaScript
303
355


