news 2026/4/16 12:04:11

小爱音箱如何变身私人音乐库？XiaoMusic给你答案

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
小爱音箱如何变身私人音乐库？XiaoMusic给你答案

小爱音箱如何变身私人音乐库？XiaoMusic给你答案

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

你是否曾经为小爱音箱的音乐资源有限而感到困扰？想要播放自己喜欢的歌曲，却发现平台版权限制太多？XiaoMusic正是为解决这一痛点而生的开源工具，它能让你的小爱音箱变身为功能强大的私人音乐库，支持yt-dlp下载功能，让你随心所欲地播放任何想听的音乐。

核心价值：解放你的音乐自由

XiaoMusic的核心价值在于打破平台限制，让你重新获得对音乐播放的完全控制权。通过简单的部署，你可以：

  • 🎵无限音乐资源：利用yt-dlp从网络获取各种音乐
  • 📱智能语音控制：通过小爱同学语音指令播放音乐
  • 🗂️本地音乐管理：整理和播放本地存储的音乐文件
  • 🎚️完全自定义：创建个性化播放列表和自定义语音指令

XiaoMusic提供直观的操作界面，左侧功能菜单、中间播放控制、右侧设备管理，一应俱全

特色功能详解

智能语音控制功能

XiaoMusic支持丰富的语音指令，让你完全解放双手：

基础播放控制

  • "播放歌曲周杰伦晴天" - 直接播放指定歌曲
  • "上一首"/"下一首" - 切换歌曲
  • "关机"/"停止播放" - 停止播放

播放模式切换

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

歌单管理

  • "播放歌单其他" - 播放指定歌单
  • "播放歌单收藏" - 播放收藏歌单
  • "加入收藏"/"取消收藏" - 管理个人收藏

💡小贴士：对小爱同学说"播放歌曲小猪佩奇的故事"，会先下载小猪佩奇的故事，然后再播放，这是XiaoMusic的隐藏玩法！

多设备兼容性

XiaoMusic已经测试支持多种小爱音箱型号：

设备型号设备名称支持状态
L06A小爱音箱✅ 已支持
LX06小爱音箱Pro✅ 已支持
LX01小爱音箱mini✅ 已支持
L05B小爱音箱Play✅ 已支持
L16AXiaomi Sound✅ 已支持
L17AXiaomi Sound Pro✅ 已支持
LX5A小爱音箱万能遥控版✅ 已支持

⚠️注意：L05B、L05C、LX06、L16A等部分型号不支持flac格式，如遇到播放问题，可在设置中开启"转换为MP3"和"型号兼容模式"选项。

音乐格式全面支持

XiaoMusic支持多种音频格式：

  • ✅mp3- 标准音频格式
  • ✅flac- 无损音频格式（部分设备需转换）
  • ✅wav- 无损音频格式
  • ✅ape- 无损音频格式
  • ✅ogg- 开源音频格式
  • ✅m4a- AAC音频格式

快速安装与配置指南

Docker部署（推荐方式）

这是最简单的安装方式，适合大多数用户：

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

国内用户可以使用镜像加速：

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

配置说明：

  • /xiaomusic_music：音乐文件存储目录
  • /xiaomusic_conf：配置文件存储目录
  • 58090：NAS本地访问端口
  • 8090：容器内部端口（不要修改）

📝重要提示：首次启动后，访问http://你的NAS_IP:58090，在Web设置页面配置小米账号和密码，带有*号的配置项必须填写。

Pip安装方式（适合开发者）

如果你更喜欢Python环境：

# 安装XiaoMusic pip install -U xiaomusic # 查看帮助信息 xiaomusic --help # 使用配置文件启动 xiaomusic --config config.json # 使用默认端口启动 xiaomusic

配置文件模板位于config-example.json，包含所有可配置选项。

简洁的歌曲列表界面，支持分类浏览和快速搜索，让你轻松管理音乐库

进阶使用技巧

自定义语音指令

XiaoMusic支持完全自定义语音指令，在配置文件config-example.json中可以找到key_word_dict配置项：

"key_word_dict": { "播放歌曲": "play", "放歌曲": "play", "下一首": "play_next", "上一首": "play_prev", "单曲循环": "set_play_type_one", "全部循环": "set_play_type_all", "随机播放": "set_play_type_rnd" }

你可以根据自己的习惯添加或修改指令，比如将"播放歌曲"改为"播放音乐"。

网络歌单功能

XiaoMusic支持网络歌单功能，可以配置JSON格式的歌单，支持电台和歌曲。还配备了m3u文件格式转换工具，可以方便地将m3u电台文件转换成网络歌单格式的JSON文件。

配置示例：

"music_list_url": "https://example.com/playlist.json", "music_list_json": "/path/to/local/playlist.json"

插件系统

XiaoMusic内置了插件系统，支持自定义功能扩展。插件目录位于xiaomusic/plugins/，你可以：

  1. 查看现有插件示例：plugins/code1.py
  2. 创建自己的插件
  3. 通过配置调用插件功能

动态折叠式控制面板，支持设备切换和播放列表管理，交互体验流畅自然

安全配置建议

公网访问安全

如果你需要在公网访问XiaoMusic，请务必：

  1. 开启密码登录：在Web设置中设置复杂密码
  2. 避免公共WiFi：不要在公共场所的WiFi环境下使用
  3. 分离账号：建议使用专门的小米账号，不要绑定摄像头等敏感设备

配置文件安全

配置文件config.json包含敏感信息，建议：

  • 设置合适的文件权限
  • 定期备份配置文件
  • 不要将配置文件上传到公开仓库

故障排除与支持

常见问题解决

  1. 设备无法连接

    • 检查小爱音箱和小米账号是否在同一网络
    • 确认小米账号密码正确
    • 查看日志文件中的错误信息

  2. 音乐无法播放

    • 检查音乐文件格式是否支持
    • 尝试开启"转换为MP3"选项
    • 确认设备型号兼容性

  3. 下载功能失效

    • 检查网络连接
    • 确认yt-dlp依赖正常安装
    • 查看临时目录权限

获取帮助

遇到问题时，可以：

  • 查看Web设置页面底部的【下载日志文件】
  • 搜索日志内容（注意删除敏感信息）
  • 在GitHub Issues中提交问题

项目架构与扩展

技术架构

XiaoMusic采用现代化的技术栈：

  • 后端：Python + FastAPI框架
  • 前端：jQuery + 多主题支持
  • 容器化：Docker一键部署
  • 包管理：PDM管理Python依赖

主题定制

项目支持多种前端主题：

  • pure主题：简洁现代风格
  • Tailwind主题：响应式设计
  • SoundScape主题：沉浸式体验
  • 第三方主题：社区贡献的多种风格

配套应用

丰富的生态系统支持：

  • 微信小程序：卯卯音乐
  • 手机APP：风花雪乐、HMusic
  • 安卓TV：肉肉音乐TV
  • 在线播放插件：JS在线播放插件

未来展望与建议

给新用户的建议

如果你是第一次使用XiaoMusic，建议：

  1. 从Docker开始：这是最简单的部署方式
  2. 先测试基础功能：确保基本播放功能正常
  3. 逐步探索高级功能：如自定义指令、网络歌单等
  4. 加入社区：与其他用户交流经验

开发方向

XiaoMusic仍在积极开发中，未来可能的方向包括：

  • 🎨更美观的前端界面：欢迎前端开发者贡献代码
  • 🔌更多插件支持：扩展更多实用功能
  • 📱移动端优化：更好的手机使用体验
  • 🔗更多设备支持：兼容更多智能音箱型号

社区参与

XiaoMusic是一个开源项目，欢迎各种形式的贡献：

  • 🐛报告Bug：在Issues中提交问题
  • 💡功能建议：分享你的想法
  • 📝改进文档：帮助完善教程
  • 🎨前端美化：优化Web界面
  • 🔧代码贡献：提交Pull Request

结语：重新定义智能音箱的音乐体验

XiaoMusic不仅仅是一个工具，更是对智能音箱音乐体验的重新定义。它打破了平台限制，让你真正拥有音乐的自由选择权。无论是想听经典老歌、最新流行曲，还是小众独立音乐，XiaoMusic都能满足你的需求。

通过简单的部署和配置，你的小爱音箱就能变身为功能强大的私人音乐库。智能语音控制、多设备兼容、丰富的格式支持，让音乐播放变得更加简单和自由。

现在就开始你的XiaoMusic之旅吧！克隆项目仓库，按照指南部署，体验前所未有的智能音箱音乐体验：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic

让音乐回归本质，让智能音箱真正为你服务。XiaoMusic，开启你的私人音乐时代！

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/16 12:04:11

从业务语义到数据存储：领域模型与数据模型的协同设计之道

1. 领域模型与数据模型的本质区别 第一次接触领域模型和数据模型时，我也曾陷入深深的困惑。记得当时在设计一个订单系统时，我画出了精美的类图，每个业务实体都严格遵循了面向对象的原则。但当真正落地到数据库设计时，问题来了——…

作者头像 李华
网站建设 2026/4/16 12:02:11

Windows 11系统优化终极指南：使用Win11Debloat工具快速提升性能

Windows 11系统优化终极指南：使用Win11Debloat工具快速提升性能 【免费下载链接】Win11Debloat A simple, lightweight PowerShell script that allows you to remove pre-installed apps, disable telemetry, as well as perform various other changes to declutt…

作者头像 李华
网站建设 2026/4/16 11:59:56

第三篇：一眼看穿相似度：余弦相似度原理详解

一眼看穿相似度：余弦相似度原理详解 前言 在上一篇《手把手实现文本向量数据库》中，我们用余弦相似度来判断两段文字是否相似。但有一个关键问题没讲清楚： 为什么用一个数学公式就能判断"语义是否相似"？ 这篇文章&…

作者头像 李华
网站建设 2026/4/16 11:59:15

田间小气候监测站 十要素农业气象站

农田生态气象站，作为高标准农田标配的气象监测设备，聚焦“四情”监测中的气象刚需，可实时采集农田周边核心气象要素，为“四情”监测提供基础数据支撑，实现“气象数据四情监测”联动，助力农业工作人员精准掌…

作者头像 李华
网站建设 2026/4/16 11:55:21

新手避坑指南：C++原子操作中compare_exchange_weak的5个常见误用场景

C原子操作实战：避开compare_exchange_weak的五大深坑 第一次接触C原子操作时，compare_exchange_weak就像个神秘的黑盒子——看似简单，却总在关键时刻给你"惊喜"。记得我刚用这个函数实现自旋锁时，程序偶尔会莫名其妙地卡…

作者头像 李华
网站建设 2026/4/16 11:54:54

华为OD Python面试通关指南：从高频考点到实战解析

1. 高频考点深度解析 1.1 Python执行效率优化实战 在华为OD的Python面试中，性能优化是必考题。我当年面试时就遇到过这样的场景：面试官给出一段存在明显性能问题的代码，要求现场优化。这里分享几个真正有效的优化手段： 算法层面的…

作者头像 李华