xiaomusic完整使用指南

xiaomusic是一款开源音乐工具，能够让你通过小爱同学语音控制播放音乐，并使用yt-dlp自动下载歌曲，轻松打造个人音乐库。无论是在家中还是外出，都能随时享受喜爱的音乐，让音乐生活更智能、更便捷。

什么是xiaomusic？

xiaomusic是一个专为小爱同学设计的音乐增强工具，它通过插件系统扩展了小爱同学的音乐播放能力。核心功能包括：

• 语音控制播放：直接对小爱同学说"播放周杰伦的歌"即可触发
• 自动音乐下载：集成yt-dlp工具，自动获取并保存音乐文件
• 节日主题支持：根据不同节日自动切换音乐氛围
• 多平台兼容：支持Linux系统，可通过Docker快速部署

快速安装步骤

准备环境

确保你的系统已安装Python和Git，然后克隆仓库：

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

安装依赖

运行项目提供的依赖安装脚本：

chmod +x install_dependencies.sh
./install_dependencies.sh

配置文件

复制示例配置文件并修改为你的设置：

cp config-example.json config.json
nano config.json  # 编辑配置文件，设置音乐保存路径等

核心功能使用教程

语音搜索与播放

1. 启动xiaomusic服务：

   python xiaomusic.py
   

2. 对小爱同学说："小爱同学，打开xiaomusic"

3. 直接说出你想听的歌曲或歌手，例如："播放青花瓷"

音乐下载管理

xiaomusic会自动将播放过的音乐保存在本地，你可以通过Web界面查看和管理下载的音乐文件。访问以下地址打开管理界面：

http://localhost:8080

自定义界面主题

项目提供了多种Web界面主题，位于xiaomusic/static/目录下，包括：

• default：默认主题
• pure：简洁风格
• tailwind：现代UI设计
• xplayer：音乐播放器专用界面

高级配置

插件扩展

xiaomusic支持通过插件扩展功能，现有插件位于plugins/目录，包括：

• httpget.py：HTTP请求工具
• setmyvolume.py：音量控制插件

你可以根据docs/目录中的开发文档编写自己的插件。

定时任务

通过crontab配置定时任务，自动更新节日信息：

python xiaomusic/crontab.py

常见问题解决

无法启动服务

检查端口是否被占用：

netstat -tuln | grep 8080

如果端口被占用，可以修改配置文件中的port参数。

音乐下载失败

确保yt-dlp已正确安装：

yt-dlp --version

如果未安装，运行install_dependencies.sh重新安装依赖。

结语

xiaomusic为小爱同学带来了强大的音乐增强功能，让你的智能音箱不仅能控制家居，更能成为你的专属音乐管家。无论是音乐爱好者还是技术探索者，都能通过这个开源项目获得更好的音乐体验。立即尝试，开启你的智能音乐之旅吧！

项目源码完全开放，欢迎参与贡献或提出建议。