PixelPlayer：隐私优先的安卓音乐播放器

项目简介

PixelPlayer 是一款面向 Android 的本地音乐播放器，使用 Kotlin 编写，基于 Jetpack Compose 与 Material Design 3 构建。它主打隐私优先与离线播放：音乐来自设备本地，支持 Material You 动态取色、流畅动画以及可自定义的界面细节（圆角半径、导航栏设置等）。

音频引擎采用 Media3 ExoPlayer 并集成 FFmpeg，架构为 MVVM + StateFlow/SharedFlow，依赖注入使用 Hilt，数据库为 Room。

主要功能

界面与主题

• Material You 动态取色，可随壁纸变化
• 深色/浅色主题，支持自动或手动切换
• 从专辑封面提取颜色，自定义圆角与导航栏

播放能力

• Media3 ExoPlayer + FFmpeg 音频引擎
• 后台播放，完整的媒体会话集成
• 队列拖拽排序、随机与循环、无缝播放
• 可配置的淡入淡出（crossfade）切换

曲库管理

• 支持 MP3、FLAC、AAC、OGG、WAV 等格式
• 按歌曲、专辑、艺术家、流派、文件夹浏览
• 可配置多位艺术家的分隔符，按专辑艺术家正确归类
• 可选择扫描的文件夹

发现与整理

• 全曲库全文搜索
• Daily Mix：基于收听习惯生成的个性化播放列表
• 自定义播放列表与收听统计

歌词与封面

• 通过 LRCLIB API 获取 LRC 同步歌词，支持滚动显示与歌词编辑
• 通过 Deezer API 自动获取艺术家图片，内存（LRU）+ 数据库缓存，离线可用

连接与扩展

• Chromecast 投屏到电视或智能音箱
• Glance 桌面小组件
• 标签编辑器，基于 TagLib 编辑 MP3、FLAC、M4A 元数据
• AI 播放列表生成，支持 Gemini、Deepseek、OpenAI 等服务商
• Android Auto 支持（README 标注为即将推出）

安装与使用

系统要求

• Android 11（API 30）及以上
• 建议 6GB 内存以获得流畅体验

下载安装

• 从 GitHub Releases 下载最新 APK：https://github.com/theovilardo/PixelPlayer/releases/latest
• 也可通过 Obtainium 跟踪更新：https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/{"id"%3A"com.theveloper.pixelplay"%2C"url"%3A"https%3A%2F%2Fgithub.com%2Ftheovilardo%2FPixelPlayer"%2C"author"%3A"theovilardo"%2C"name"%3A"PixelPlayer"%2C"supportFixedAPKURL"%3Afalse}

从源码构建

前置条件：Android Studio Ladybug | 2024.2.1 或更新版本、Android SDK 29+、JDK 11+。

git clone https://github.com/theovilardo/PixelPlayer.git

用 Android Studio 打开克隆下来的目录，等待 Gradle 同步依赖，执行 Build → Make Project 构建，连接设备或启动模拟器后点击 Run。

注意事项

• 项目采用专有许可证（Proprietary License），详见仓库中的 LICENSE 文件；2026-05-12 之前贡献的部分仍以 MIT 许可证提供，见 THIRD_PARTY_NOTICES.md。
• README 明确说明：本项目的 fork 不会获得支持，如果使用 fork，请向 fork 的维护者寻求帮助。
• AI 播放列表等功能依赖第三方 AI 服务商，需要自行配置相关的服务与密钥。
• 歌词、艺术家图片分别依赖 LRCLIB、Deezer 等在线接口，离线时只能使用已缓存的内容。

---

本作品整理自 GitHub 开源项目 PixelPlayerHQ/PixelPlayer，原作者 @PixelPlayerHQ。中文介绍由 AI 根据项目 README 整理，以原仓库为准。