3分钟配置小爱音箱本地音乐播放系统终极免费解决方案【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic你是否厌倦了音乐平台的版权限制和广告干扰想要让小爱音箱播放自己收藏的本地音乐XiaoMusic就是为你量身定制的开源解决方案这个免费工具能将你的小爱音箱变成个人音乐服务器支持播放本地音乐库、在线下载歌曲还能通过语音控制播放让你完全掌控自己的音乐体验。XiaoMusic是一个专为小爱音箱设计的本地音乐播放系统支持MP3、FLAC、WAV等多种音频格式通过简单的配置就能让小爱音箱播放存储在NAS或本地电脑中的音乐文件。无论你是音乐爱好者还是技术新手都能轻松搭建属于自己的音乐播放系统。 快速开始3步完成部署第一步获取项目源码首先从GitCode仓库克隆项目git clone https://gitcode.com/GitHub_Trending/xia/xiaomusic cd xiaomusic第二步Docker一键部署推荐使用Docker Compose快速启动服务services: xiaomusic: image: hanxi/xiaomusic container_name: xiaomusic restart: always ports: - 58090:8090 volumes: - /xiaomusic_music:/app/music - /xiaomusic_conf:/app/conf运行命令docker-compose up -d第三步Web界面配置访问http://你的IP:58090进入Web设置页面输入小米账号密码获取设备列表配置音乐文件存储路径保存配置并重启服务重要提示配置IP地址时请只填写数字和点号不要包含端口号确保音箱能正确访问服务。 核心功能演示智能音乐库管理XiaoMusic会自动扫描指定目录下的音乐文件按艺术家、专辑自动分类支持MP3、FLAC、WAV、APE等多种格式。系统会自动提取歌曲元数据让你的音乐库井井有条。从上图可以看到音乐库界面清晰展示了歌曲列表顶部有搜索框和设备切换选项支持快速查找和筛选歌曲。你可以通过分类标签全部、所有歌曲、收藏、下载轻松管理音乐。语音控制功能XiaoMusic深度集成小爱音箱的语音控制支持丰富的语音指令播放歌曲周杰伦晴天- 播放指定歌曲下一首/上一首- 切换歌曲单曲循环- 重复播放当前歌曲全部循环- 循环播放所有歌曲随机播放- 随机顺序播放加入收藏- 将当前歌曲加入收藏分钟后关机- 定时停止播放你还可以在配置文件中自定义语音指令满足个性化需求。播放列表系统支持创建和管理多个播放列表包括收藏、下载等默认列表。你可以通过简单的操作添加或删除歌曲也可以创建个性化的播放列表。动态演示展示了播放列表的展开和折叠功能左侧为小爱音箱控制面板右侧是可展开的播放列表操作直观便捷。️ 详细配置指南配置文件详解配置文件位于config-example.json主要配置项包括{ account: 你的小米账号, password: 你的密码, music_path: /path/to/your/music, hostname: http://192.168.1.100, port: 8090, key_word_dict: { 播放歌曲: play, 下一首: play_next, 关机: stop } }存储路径设置建议将音乐目录、下载目录和缓存目录分开设置{ music_path: /data/music/library, download_path: /data/music/download, cache_dir: /data/music/cache }插件系统扩展XiaoMusic提供了丰富的插件支持可以扩展更多功能AI功能插件plugins/ai/网络请求插件plugins/httpget.py自定义插件支持JavaScript插件扩展通过插件系统你可以添加歌词显示、音乐推荐、电台收听等额外功能。 设备兼容性已测试支持的设备XiaoMusic支持多种小爱音箱型号型号设备名称L06A小爱音箱L07ARedmi小爱音箱 PlayLX05小爱音箱Play2019款L05C小米小爱音箱Play 增强版LX06小爱音箱ProL16AXiaomi Sound注意部分型号如L05B、L05C、LX06、L16A不支持FLAC格式如遇到播放问题可在设置中开启转换为MP3选项。 高级功能网络歌单支持可以配置JSON格式的网络歌单支持电台和歌曲播放。系统还提供了M3U文件格式转换工具方便将M3U电台文件转换为网络歌单格式。详细用法见官方文档docs/issues/78.md定时任务与自动化通过crontab配置可以实现自动化的音乐播放任务定时播放特定播放列表每日音乐推荐自动下载新歌音乐库定期更新多设备管理支持同时管理多个小爱音箱设备每个设备可以独立设置播放列表和音量实现多房间音乐同步播放。 用户界面展示这张图展示了完整的操作界面包含左侧导航栏设备控制、播放列表、账号设置等功能顶部功能区搜索、设备切换、分类筛选中间歌曲列表显示所有可播放的音乐底部控制区播放控制、进度条、音量调节右侧扩展区播放模式切换、歌词显示等高级功能⚠️ 常见问题速查播放列表正常但无声音这是最常见的问题通常由以下原因导致IP地址配置错误检查是否在IP地址中误加了端口号网络连通性问题验证音箱是否能正常访问音乐服务文件权限问题确保音乐文件的读取权限设置正确防火墙设置检查并配置正确的防火墙规则语音控制无法触发播放如果手动播放正常但语音控制无效检查语音指令是否正确配置验证语音识别功能是否正常确认音箱固件版本是否支持本地播放功能检查关键词映射配置是否正确音乐文件无法识别当音乐文件无法被系统识别时检查文件格式是否支持支持MP3、FLAC、WAV等常见格式确认文件元数据是否完整尝试重新扫描音乐库检查文件编码格式 安全提醒重要安全提示如果配置了公网访问XiaoMusic请一定要开启密码登录并设置复杂的密码不要在公共场所的WiFi环境下使用否则可能造成小米账号密码泄露强烈不建议将小爱音箱的小米账号绑定摄像头避免隐私泄露风险 下一步行动建议初学者建议从最简单的Docker部署开始熟悉基本功能先配置少量音乐文件进行测试逐步添加自定义语音指令尝试创建个性化的播放列表进阶用户探索研究插件系统添加自定义功能配置网络歌单丰富音乐来源设置定时任务实现自动化播放探索多设备同步播放功能开发者参与查看AI功能源码plugins/ai/阅读官方文档docs/issues/参与社区讨论分享使用经验贡献代码或文档帮助项目成长 小贴士与最佳实践使用静态IP为NAS设备分配固定IP避免DHCP变化文件格式标准化统一使用MP3格式兼容性最好定期备份重要音乐文件定期备份到安全位置目录结构优化按艺术家/专辑分类存储便于管理XiaoMusic让你的小爱音箱焕发新生从此告别音乐平台的限制享受完全自由的音乐体验无论是家庭聚会、个人放松还是背景音乐都能轻松应对。现在就开始搭建属于你自己的音乐播放系统吧温馨提示项目已停止维护推荐使用社区接力项目 songloft-org/songloft但XiaoMusic仍然是一个功能完整、稳定可用的选择。【免费下载链接】xiaomusic使用小爱音箱播放音乐音乐使用 yt-dlp 下载。项目地址: https://gitcode.com/GitHub_Trending/xia/xiaomusic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考