麻瓜音乐

这是一个运行在 Android TV / 电视盒子上的开源音乐客户端，仓库地址 https://github.com/Muggles001/muggles-music ，当前最新版本 v2.0.3（2026 年 9 月 2 日 release）。它是 "boluofan/music-tv" 的一个独立维护分支，原作者 boluofan 仍是重要代码基础，但两者没有官方隶属关系 。

它是什么定位

简单说：电视端的"洛雪音乐"客户端。本体不内置任何曲库，需要通过以下两种方式之一提供音源 ：

- 直连 LX 音源：导入符合 LX Music "globalThis.lx" 2.0.0 契约的 JavaScript 音源地址 - 连接 LXserver：填写服务端地址（例如 "http://192.168.1.100:9527"），支持账号登录、Token 鉴权

⚠️ 直连模式只接受 LX 兼容的 JS 音源，不支持 M3U、单曲直链或任意 REST API 地址；应用本身不内置也不分发第三方音源，需要你自己配置 。 主要功能

- 遥控器适配：针对 Android TV 的 D-Pad 遥控器做了完整适配，大字体、清晰焦点提示 - 搜索 / 排行榜 / 歌单 / 收藏 / 播放队列 / 同步歌词 全套能力 - 跨平台歌单导入：可通过链接或手机扫码导入主流音乐平台歌单；重复导入同一歌单会刷新内容并保留本地歌单名 - 歌词增强：支持标准 LRC、毫秒逐字歌词和中文翻译，提供共享平面空间排版与自然换行，每首歌曲可独立时间校准 - 沉浸式播放界面：基于专辑封面的动态背景 - 双模式数据隔离：直连模式下，收藏与歌单仅保存在电视本机；连接 LXserver 后则由服务端统一管理

安装与使用

1. 从仓库的 Releases 页面下载 APK，支持 Android 5.0（API 21）及以上的电视/盒子 2. 安装后首次启动，选择"直接使用音源"或"连接 LXserver"，两种方式都支持手机扫码配置 3. 若选 LXserver，填入同局域网下可达的服务地址（默认端口通常是 9527）

💡 已安装 v1.0.2 及以上版本的用户可直接覆盖更新；v1.0.2 启用了新的发布证书 。 自行构建

git clone https://github.com/Muggles001/muggles-music.git cd muggles-music bash gradlew :app:assembleDebug

需要 JDK 17+ 和对应的 Android SDK，产物在 "app/build/outputs/apk/debug/app-universal-debug.apk" 。

项目背景与许可

- 上游链路： "boluofan/music-tv" → 再往上追溯基于 "GanHuaLin/rouroumusic-tv"（RouRouMusic）；后端服务使用 "XCQ0607/lxserver" - 代码主要由 OpenAI Codex 纯 AI 生成，由维护者 Pengbo Zhang 实机验证 - 沿用 Apache License 2.0，再发布时需保留许可证、版权与来源说明 - 目前仓库 4 Star、0 Fork，属于个人维护阶段的小型项目 这是 muggles-music 仓库的 v2.0.3 发布页，发布于 2026 年 9 月 2 日，是截至目前的最新版本 。下面把这一版的关键信息拆给你。

📦 安装包与校验信息

- 文件名： "Muggles-Music-v2.0.3-universal-Android5-plus.apk" - 体积：9.84 MB - SHA-256： "8f1ffcf91ea1203bf79a0bdc796532ff9c76e3838477847a0d51aef795abc24d" - 最低系统：Android 5.0（API 21）及以上

💡 下载后建议核对 SHA-256，确保 APK 未被篡改。 🎯 v2.0.3 核心更新

这一版重点是歌单导入能力的大幅扩展和遥控器体验打磨：

新增五大平台歌单导入

支持网易云音乐、QQ 音乐、酷狗音乐、酷我音乐、咪咕音乐的歌单导入，可通过链接、分享文本、歌单 ID、手机扫码四种方式输入 。重复导入同一来源歌单时会刷新内容并保留本地歌单名；播放时优先匹配原平台音源，缺失则自动回退到其他可用来源 。

扫码服务统一

扫码服务统一到 8088 端口，并按功能分路径处理，同时修复了手机端成功页的返回时机 。

遥控器交互修复

修复了导入输入框、搜索结果、榜单、歌单网格以及播放操作菜单中的方向键和返回键行为，完善了全部歌单、我的收藏与歌单管理的遥控器焦点路径 。

UI 统一

统一了导入页按钮、图标、色调与选中状态 。

📥 获取方式

发布页提供了三个资产 ：

1. APK 安装包（直接下载安装到电视/盒子） 2. Source code (zip) —— 源码压缩包 3. Source code (tar.gz) —— 源码压缩包

电视端用户直接下载 APK 传到设备上安装即可；想自己编译或审计代码的拉源码。

⚠️ 应用本身需要你自行配置音源或 LXserver 服务才能正常播歌，安装后首次启动会要求选择"直接使用音源"还是"连接 LXserver"。