当前位置：首页 > news >正文

5分钟解锁小爱音箱无限音乐自由：Xiaomusic开源项目完全指南

news 2026/6/20 1:47:55

5分钟解锁小爱音箱无限音乐自由：Xiaomusic开源项目完全指南

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

还在为小爱音箱的曲库限制烦恼吗？想用语音指令播放任意网络音乐吗？Xiaomusic开源项目正是你需要的解决方案！这个基于Python开发的智能音乐播放器，通过小爱音箱实现语音控制播放，利用yt-dlp技术从网络下载音乐，让智能音箱秒变全能音乐中心。🎵

🚀 为什么选择Xiaomusic？

在音乐流媒体平台会员费日益上涨的今天，Xiaomusic为你提供了一个完全免费的替代方案。这个开源项目不仅支持本地音乐库管理，还能通过语音指令实现播放控制、歌单切换、定时关机等高级功能，让你的小爱音箱焕发新生！

📦 一键部署：三种安装方式任选

Docker容器部署（推荐）

对于大多数用户来说，Docker部署是最简单的方式。只需几行代码，就能在NAS或服务器上快速搭建：

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

Pip直接安装

如果你是Python开发者，可以直接通过pip安装：

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

源码编译运行

想要深度定制？直接从GitHub克隆仓库：

git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic ./install_dependencies.sh pdm install pdm run xiaomusic.py

🎤 智能语音控制：解放双手的魔力

Xiaomusic最吸引人的功能就是完整的语音控制体系。通过智能识别语音指令，你可以轻松实现各种操作：

基础播放控制

"播放歌曲周杰伦晴天"- 自动下载并播放指定歌曲
"下一首" / "上一首"- 无缝切换曲目
"停止播放"- 立即暂停音乐

播放模式切换

"单曲循环"- 重复播放当前歌曲
"全部循环"- 循环播放整个歌单
"随机播放"- 享受惊喜音乐体验

高级功能指令

"加入收藏"- 将当前歌曲加入收藏列表
"分钟后关机"- 设置定时关机功能
"刷新列表"- 更新音乐库

🔧 核心功能深度解析

音乐格式全面兼容

Xiaomusic支持多种音频格式，确保最佳兼容性：

MP3- 最广泛的音频格式
FLAC- 无损音质体验
WAV/APE/OGG/M4A- 专业音频格式支持

设备广泛适配

项目已经测试支持数十款小米音箱设备，包括：

小爱音箱Play系列（L05B/L05C/L06A）
小米AI音箱（S12/S12A）
触屏版音箱（LX04/X08A系列）
Xiaomi Sound Pro（L17A）

网络歌单功能

通过配置JSON格式的网络歌单，你可以轻松分享和同步音乐列表。还配备了M3U文件转换工具，方便将现有电台文件转换为Xiaomusic兼容格式。

🎨 个性化定制：打造专属音乐体验

插件系统扩展

Xiaomusic拥有强大的插件架构，位于 xiaomusic/plugin.py。开发者可以轻松编写自定义插件，实现：

自定义语音指令响应
特殊音频处理功能
第三方服务集成

界面主题切换

项目内置多种界面主题，满足不同审美需求：

Pure主题- 简洁现代设计
Tailwind主题- 响应式布局
SoundScape主题- 沉浸式体验

配置文件详解

核心配置文件 xiaomusic/config.py 提供了丰富的定制选项：

# 音乐存储路径配置 music_path = "music" temp_path = "music/tmp" download_path = "music/download" # 语音口令自定义 key_word_dict = { "下一首": "play_next", "上一首": "play_prev", "单曲循环": "set_play_type_one" }