# SelfMusicPlayer

**Repository Path**: shareceo/SelfMusicPlayer

## Basic Information

- **Project Name**: SelfMusicPlayer
- **Description**: 自用音乐播放器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SelfMusicPlayer 🎵

> 一款轻量、无广告打扰、注重本地音乐体验的 Android 音乐播放器。
> 支持歌词显示、录音、剪辑、网络音源、自定义扫描目录等实用功能。

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Android-brightgreen.svg)](https://www.android.com)
[![Version](https://img.shields.io/badge/version-1.16-orange.svg)](#)

---

## ✨ 功能特性

- **本地音乐播放**：扫描本机音乐，支持按文件夹/专辑/艺术家分组
- **歌词显示**：内嵌歌词视图，支持歌词同步滚动
- **录音功能**：支持麦克风录音、内录（Android 14+），可暂停/恢复、编辑文件名
- **音频剪辑**：裁剪音频片段，保存到本地
- **指定目录扫描**：通过 SAF 选择指定文件夹扫描，结果持久化
- **搜索**：在指定目录内快速搜索歌曲（防抖 300ms）
- **播放列表 / 收藏**：创建播放列表、收藏歌曲，支持批量操作
- **音量增强**：0.5x – 2.0x 音量倍增
- **悬浮歌词**：可脱离播放界面显示歌词（设置中开启）
- **网络音源**：内置 Archive.org / Mixkit / 洛雪 / 自定义 URL 等音源搜索
- **广告位系统**：内置可配置广告位（默认关闭，仅在有配置时展示）
- **检查更新**：基于 Gitee Releases 的版本检测

---

## 📥 下载安装

- **稳定版**：前往 [Releases](https://gitee.com/shareceo/SelfMusicPlayer/releases) 下载最新 APK
- **源码构建**：
  ```bash
  git clone https://gitee.com/shareceo/SelfMusicPlayer.git
  cd SelfMusicPlayer
  ./gradlew assembleDebug
  ```
  APK 输出：`app/build/outputs/apk/debug/app-debug.apk`

> 最低支持 Android 8.0（API 26），目标 API 35。

---

## 🚀 快速上手

1. 首次启动会自动扫描本机音乐（约 5 秒），结果缓存到本地，之后秒开。
2. 若要指定目录，进入「设置 → 扫描目录」选择文件夹。
3. 长按歌曲进入多选模式，可批量加入播放列表、收藏或删除。
4. 设置中可开启悬浮歌词、音量增强、广告展示等开关。

---

## 🛠 技术栈

| 分类 | 技术 |
|------|------|
| 语言 | Kotlin |
| UI | Jetpack Compose (BOM 2024.02.02) |
| 依赖注入 | Hilt |
| 数据库 | Room (缓存歌曲) |
| 偏好/配置 | DataStore |
| 媒体播放 | Media3 (ExoPlayer) |
| 图片加载 | Coil |
| 网络 | OkHttp |
| 异步 | Kotlin Coroutines / Flow |

---

## 🤝 参与贡献

欢迎提交 Issue 与 Pull Request！

- Bug 反馈：[Issues](https://gitee.com/shareceo/SelfMusicPlayer/issues)
- 功能建议：同上，标签 `enhancement`

---

## ☕ 支持作者

如果觉得好用，欢迎[捐赠](https://gitee.com/shareceo/SelfMusicPlayer)，以支持项目持续更新。