lx-music-mobile

lyswhutApache-2.0活跃维护 有专家点评

用 React Native 写的跨平台音乐播放器,支持搜索、播放和歌单管理,适合在手机上听歌。

一个基于 React native 开发的音乐软件

v1.9.2发布于 2026-10-30 15:12 UTC19,267star +61 / 7 天2,232fork同步于 2026-11-11 05:23 UTC

专家点评

上手难度:进阶更新于 2026-11-11

安卓端自建曲库的播放器外壳,音频链路完全交给用户配置的自定义源

适用场景

  • 已有自建或第三方音源服务、想要一个现成安卓客户端:它只负责 UI、播放列表和同步,音源由你提供,省掉自己写播放器壳的工作
  • 需要多端私人同步播放列表:可以自部署数据同步服务,桌面版另有仓库,移动端和桌面端共用一套同步后端
  • 想研究 React Native 写媒体播放器:Redux 状态管理、播放列表机制、在线数据聚合筛选都有现成实现可读
  • 不接受 iOS/HarmonyOS 的纯安卓场景:它明确只做 Android 5+,不用为跨平台抽象付代价

踩坑

  • 装完直接打开是放不出声的:README 明说软件不提供音频数据,必须在设置里配自定义源,否则整个播放链路是空的;issue 里「自己收集的几个可用音源」拿到最高反应数,说明这是所有人进门第一道坎
  • 默认设置和 UI 不以新手友好为目标:README 自己提示要先浏览调整设置并读播放列表机制文档,不读文档直接上手会在播放列表行为上困惑
  • 发布渠道只有 GitHub Releases:从其他渠道拿到的包是第三方转载,版本和完整性都不受控,升级路径也会断
  • iOS 适配只出现在 issue 里(有人提交了适配版本),README 明确无计划支持,别把它当成跨平台方案评估

同类对比

如果只是想要开箱即用的安卓本地/在线播放器,用现成商业播放器更省事;如果要的是可自建音源+多端同步的完整方案,桌面版仓库和自部署同步服务是同一体系内的延伸,而不是替代品。

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/lyswhut/lx-music-mobile.git
参照官方文档《源码使用方法》配置开发环境后,在 dev 分支开发
硬件要求按 README 说明

README 未说明硬件要求,仅说明运行平台为 Android 5 及以上;不支持 iOS 和 HarmonyOS NEXT。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

基于 React Native 的安卓音乐播放器,需自备自定义源才能播放音频

用 React Native 写的跨平台音乐播放器,支持搜索、播放和歌单管理,适合在手机上听歌。

核心能力

  • 用 React Native + Redux 构建,仅支持 Android 5 及以上
  • 在线数据从酷我、酷狗、咪咕等公开服务器拉取并筛选合并
  • 音频播放依赖设置里的自定义源返回在线链接
  • 可部署独立数据同步服务实现多端私人同步
  • 项目开源免费,桌面版另有独立仓库

容易踩的坑

软件本身不提供音频数据,必须在设置里配置自定义源才能播放;默认设置和 UI 不以新手友好为目标,建议先浏览调整设置并阅读播放列表机制文档;仅支持 Android,iOS 与 HarmonyOS NEXT 无计划支持;官方发布渠道只有 GitHub Releases,其他渠道为第三方转载。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.9.2
  1. v1.9.2最新正式版2026-10-30 · 2026-10-30 15:12 UTC

    修复

    • 修复无法打开 kg 歌单的问题
    • 修复打开某些 kg 歌单时歌曲丢失的问题

    变更

    • 默认禁用音频卸载

    File MD5

    275b291a048b895d7fc736ad6e36b4b1  lx-music-mobile-v1.9.2-arm64-v8a.apk
    f5d552da9ddea50bb4e5b154bc86619d  lx-music-mobile-v1.9.2-armeabi-v7a.apk
    44a28ee9fbb2137278de5a1552c97fb7  lx-music-mobile-v1.9.2-universal.apk
    03a6989d7e41016dc8463bb459ccd4a4  lx-music-mobile-v1.9.2-x86.apk
    2c2b2df39a3464b9c989e58a066b8bc9  lx-music-mobile-v1.9.2-x86_64.apk
    

    软件安装包说明

  2. v1.9.12026-09-19 · 2026-09-19 02:04 UTC
    查看更新说明

    优化

    • 优化 tx 推荐歌单列表

    修复

    • 修复打开某些 kg 歌单时歌曲丢失的问题

    File MD5

    acf082837b4340c89509b078af17de0c  lx-music-mobile-v1.9.1-arm64-v8a.apk
    d5bce179c988097f40628e9fb2607a86  lx-music-mobile-v1.9.1-armeabi-v7a.apk
    6e2f249f798f36e1fe41803deab575b1  lx-music-mobile-v1.9.1-universal.apk
    5ec9e4fc4056b027fc95f41a62bf8b61  lx-music-mobile-v1.9.1-x86.apk
    98f5040e8b13ea2870ff4c5d7cf8e2d7  lx-music-mobile-v1.9.1-x86_64.apk
    

    软件安装包说明

  3. v1.9.02026-09-12 · 2026-09-12 04:48 UTC
    查看更新说明

    新增

    • 歌曲菜单新增 “清理缓存” 按钮,可用于清理 URL 缓存,当某首歌获取到了错误的歌曲链接时,可以使用该功能清理与其关联的歌曲URL缓存

    优化

    • 优化自动换源歌曲匹配机制

    修复

    • 修复 kg 搜索结果显示问题
    • 修复某些 tx 歌单打开失败的问题 (@ght-000)
    • 修复 mg 图片、歌词获取
    • 修复 tx 歌单翻页问题 (#1107, @jtcai)
    • 修复 tx 歌曲搜索失败的问题(@ikun0014)

    File MD5

    632b0de28e880a6caaea4c5200ed3f73  lx-music-mobile-v1.9.0-arm64-v8a.apk
    e66c56379f906d6619f8664a1d10ac88  lx-music-mobile-v1.9.0-armeabi-v7a.apk
    c59cec19807f2e4efb31119b93650c5b  lx-music-mobile-v1.9.0-universal.apk
    e4b4b7d2d113a99891f007a4afb60158  lx-music-mobile-v1.9.0-x86.apk
    c12353c7908ba85337bf412c5a509d7c  lx-music-mobile-v1.9.0-x86_64.apk
    

    软件安装包说明

  4. v1.8.42026-05-01 · 2026-05-01 09:36 UTC
    查看更新说明

    我们很高兴地宣布新项目 Any Listen 的桌面版已发布,目前已支持列表跟随本地文件自动更新、加载并播放WebDAV上的歌曲等功能,更多功能仍在积极开发中,桌面版与Web版将同步更新。 对于有播放本地音乐或播放服务器上音乐需求的人可以试试,若遇到任何问题可以发 issue 反馈。

    修复

    • 修复蓝牙歌词显示问题(#1042)

    File MD5

    d942e9cc1498a6825cf2ee5d73694d0e  lx-music-mobile-v1.8.4-arm64-v8a.apk
    cd6afda158d4c4efb59a458ffedb2387  lx-music-mobile-v1.8.4-armeabi-v7a.apk
    402a574f58e3918901e09d01cf0b062b  lx-music-mobile-v1.8.4-universal.apk
    4076e17aef31e27e1ac07d02a709e1fa  lx-music-mobile-v1.8.4-x86.apk
    c9cd00f80f2bc55aa8a5814f03935b7f  lx-music-mobile-v1.8.4-x86_64.apk
    

    软件安装包说明

  5. v1.8.32026-04-30 · 2026-04-30 17:43 UTC
    查看更新说明

    我们很高兴地宣布新项目 Any Listen 的桌面版已发布,目前已支持列表跟随本地文件自动更新、加载并播放WebDAV上的歌曲等功能,更多功能仍在积极开发中,桌面版与Web版将同步更新。 对于有播放本地音乐或播放服务器上音乐需求的人可以试试,若遇到任何问题可以发 issue 反馈。

    新增

    • 添加了一个 显示完整蓝牙歌词 的选项,启用后会将完整歌词设置到媒体信息中,在某些场景中可用于显示完整歌词

    优化

    • 优化歌单内歌曲搜索结果排序

    修复

    • 修复可忽略的错误没有正确处理的问题
    • 修复 tx 搜索结果显示异常的问题

    File MD5

    5cac13b2a86268635bf7f252cbe3abee  lx-music-mobile-v1.8.3-arm64-v8a.apk
    757512e9e585028b8153e027cbda1b12  lx-music-mobile-v1.8.3-armeabi-v7a.apk
    163925d60f800f853675c46ecf888234  lx-music-mobile-v1.8.3-universal.apk
    7b7a6c996c7cca985561d02d2ea32969  lx-music-mobile-v1.8.3-x86.apk
    a043c496b315c3e746f8b01aed4758f9  lx-music-mobile-v1.8.3-x86_64.apk
    

    软件安装包说明

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    说明

    所用技术栈:

    • React Native
    • Redux

    已支持的平台:

    • Android 5 及以上

    注:目前没有计划支持 iOS 和 HarmonyOS NEXT。 桌面版项目地址:https://github.com/lyswhut/lx-music-desktop LX Music 项目发展调整与新项目计划:https://github.com/lyswhut/lx-music-desktop/issues/1912

    软件变化请查看更新日志。

    软件下载请查看 GitHub Releases。

    使用常见问题请参阅移动版常见问题。

    目前本项目的原始发布地址只有 GitHub,其他渠道均为第三方转载发布,与本项目无关!

    为了提高使用门槛,本软件内的默认设置、UI 操作不以新手友好为目标,所以使用前建议先根据你的喜好浏览调整一遍软件设置,阅读一遍音乐播放列表机制。

    数据同步服务

    从 v1.0.0 起,我们发布了一个独立的数据同步服务。如果你有服务器,可以将其部署到服务器上作为私人多端同步服务使用,详情看该项目说明。

    贡献代码

    本项目欢迎 PR,但为了 PR 能顺利合并,需要注意以下几点:

    • 对于添加新功能的 PR,建议在提交 PR 前先创建 Issue 进行说明,以确认该功能是否确实需要;
    • 对于修复 bug 的 PR,请提供修复前后的说明及重现方式;
    • 对于其他类型的 PR,则适当附上说明。

    贡献代码步骤:

    1. 参照源码使用方法设置开发环境;
    2. 克隆本仓库代码并切换至 dev 分支进行开发;
    3. 提交 PR 至 dev 分支。

    项目协议

    本项目基于 Apache License 2.0 许可证发行,以下协议是对于 Apache License 2.0 的补充,如有冲突,以以下协议为准。


    词语约定:本协议中的“本项目”指 LX Music(洛雪音乐)移动版项目;“使用者”指签署本协议的使用者;“官方音乐平台”指对本项目内置的包括酷我、酷狗、咪咕等音乐源的官方平台统称;“版权数据”指包括但不限于图像、音频、名字等在内的他人拥有所属版权的数据。

    一、数据来源

    1.1 本项目的各官方平台在线数据来源原理是从其公开服务器中拉取数据(与未登录状态在官方平台 APP 获取的数据相同),经过对数据简单地筛选与合并后进行展示,因此本项目不对数据的合法性、准确性负责。

    1.2 本项目本身没有获取某个音频数据的能力,本项目使用的在线音频数据来源来自软件设置内“自定义源”设置所选择的“源”返回的在线链接。例如播放某首歌,本项目所做的只是将希望播放的歌曲名、艺术家等信息传递给“源”,若“源”返回了一个链接,则本项目将认为这就是该歌曲的音频数据而进行使用,至于这是不是正确的音频数据本项目无法校验其准确性,所以使用本项目的过程中可能会出现希望播放的音频与实际播放的音频不对应或者无法播放的问题。

    1.3 本项目的非官方平台数据(例如“我的列表”内列表)来自使用者本地系统或者使用者连接的同步服务,本项目不对这些数据的合法性、准确性负责。

    二、版权数据

    2.1 使用本项目的过程中可能会产生版权数据。对于这些版权数据,本项目不拥有它们的所有权。为了避免侵权,使用者务必在 24 小时内 清除使用本项目的过程中所产生的版权数据。

    三、音乐平台别名

    3.1 本项目内的官方音乐平台别名为本项目内对官方音乐平台的一个称呼,不包含恶意。如果官方音乐平台觉得不妥,可联系本项目更改或移除。

    四、资源使用

    4.1 本项目内使用的部分包括但不限于字体、图片等资源来源于互联网。如果出现侵权可联系本项目移除。

    五、免责声明

    5.1 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害(包括但不限于因商誉损失、停工、计算机故障或故障引起的损害赔偿,或任何及所有其他商业损害或损失)由使用者负责。

    六、使用限制

    6.1 本项目完全免费,且开源发布于 GitHub 面向全世界人用作对技术的学习交流。本项目不对项目内的技术可能存在违反当地法律法规的行为作保证。

    6.2 禁止在违反当地法律法规的情况下使用本项目。 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担,本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。

    七、版权保护

    7.1 音乐平台不易,请尊重版权,支持正版。

    八、非商业性质

    8.1 本项目仅用于对技术可行性的探索及研究,不接受任何商业(包括但不限于广告等)合作及捐赠。

    九、接受协议

    9.1 若你使用了本项目,即代表你接受本协议。


    若对此有疑问请 mail to: lyswhut+qq.com (请将 + 替换成 @)