# listen1_mobile_plus

**Repository Path**: du1in9/listen1_mobile_plus

## Basic Information

- **Project Name**: listen1_mobile_plus
- **Description**: 基于 Listen1 Mobile 的 Android 增强版。支持多平台音乐搜索、歌单浏览、在线播放、歌词、悬浮歌词、本地下载等功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Listen1 Mobile Plus

[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)

基于 [Listen1 Mobile](https://github.com/listen1/listen1_mobile) 的 Android 增强版。支持多平台音乐搜索、歌单浏览、在线播放、歌词、悬浮歌词、本地下载等功能。

**仅支持 Android**

## 截图

| 平台歌单 | 搜索 |
|:---:|:---:|
| ![平台歌单](docs/screenshots/platform-playlist.jpg) | ![搜索](docs/screenshots/search.jpg) |

| 歌单列表 | 我的歌单 |
|:---:|:---:|
| ![歌单列表](docs/screenshots/playlist-list.jpg) | ![我的歌单](docs/screenshots/my-playlist.jpg) |

| 播放器 | 封面歌词 |
|:---:|:---:|
| ![播放器](docs/screenshots/modal-player.jpg) | ![封面歌词](docs/screenshots/cover-lyric.jpg) |

| 播放器（歌词） | 收藏与下载 |
|:---:|:---:|
| ![播放器2](docs/screenshots/modal-player-2.jpg) | ![收藏下载](docs/screenshots/favorites-download.jpg) |

## 特性

- 多平台聚合：网易云、QQ 音乐、酷我、咪咕、B 站等
- 关键词搜索（网易 + 咪咕聚合）
- 歌单浏览、筛选与缓存，加载进度显示
- 在线播放、歌词、悬浮歌词
- 歌曲下载到本地、收藏歌单
- 夜间模式，数据本地存储，无第三方统计 SDK

## 支持平台

| 平台 | 歌单 | 搜索 | 播放 |
|------|:----:|:----:|:----:|
| 网易云 | ✓ | ✓ | ✓ |
| QQ 音乐 | ✓ | — | ✓ |
| 酷我 | ✓ | — | ✓ |
| 咪咕 | ✓ | ✓ | ✓ |
| B 站 | ✓ | — | ✓ |

## 环境要求

- **JDK 11**（Gradle 5.4.1 推荐，勿用 JDK 17+）
- **Node.js 16+**（需支持 `--openssl-legacy-provider`）
- **Android SDK 28**
- **Yarn**

## 快速开始

```bash
git clone https://gitee.com/du1in9/listen1_mobile_plus.git
cd listen1_mobile_plus
yarn install
npx react-native link
yarn start:android
```

Windows 可使用 `scripts/setup-dev.ps1` 初始化开发环境（国内镜像）。

## 打包 APK

1. 复制 `android/gradle.properties.example` 为 `android/gradle.properties`，填入本地 JDK 路径与签名信息（可选）
2. 执行：

```bash
yarn build:apk
```

产物位于 `dist/Listen1-0.8.1-release.apk`。

## 项目结构

```
src/api/          各音乐平台 API
src/views/        页面组件
src/redux/        状态管理
src/modules/      歌词、下载、缓存等工具
android/          Android 原生工程（含悬浮歌词）
docs/screenshots/ 产品截图
```

## 隐私说明

- 不集成广告、统计、崩溃上报等第三方 SDK
- 歌单与播放数据保存在本机
- 网络请求仅用于搜索与播放音乐，详见 `android/app/src/main/res/xml/network_security_config.xml`

## 开源协议

[MIT](LICENSE)

本项目仅供学习交流。请支持正版音乐，尊重版权。

## 致谢

- [listen1/listen1_mobile](https://github.com/listen1/listen1_mobile)
- [listen1/listen1](https://github.com/listen1/listen1)