PixelPlayer is a privacy-first Android music player designed for users seeking a modern, feature-rich, and customizable offline listening experience. It leverages Jetpack Compose and Material Design 3 for a dynamic, adaptive UI, offering powerful playback capabilities, extensive library management, and intelligent discovery features. The project aims to provide a seamless and aesthetically pleasing music experience on Android devices.

How It Works

The application is built entirely in Kotlin, utilizing Jetpack Compose for its declarative UI framework and Material Design 3 for a modern, adaptive look and feel, including dynamic color theming. Audio playback is handled by the robust Media3 ExoPlayer, enhanced with FFmpeg support. The architecture follows MVVM principles, employing StateFlow/SharedFlow for reactive state management, Hilt for dependency injection, and Room for local data persistence. Asynchronous operations and background tasks are managed efficiently using Kotlin Coroutines, Flow, and WorkManager, respectively.

Quick Start & Requirements

• Primary install/run command: Clone the repository (git clone https://github.com/theovilardo/PixelPlayer.git) and open it in Android Studio. Build and run on a connected device or emulator.
• Non-default prerequisites: Android Studio Ladybug | 2024.2.1 or newer, Android SDK 29+, JDK 11+. 6GB RAM is recommended for smooth performance.
• Links: Project repository: https://github.com/theovilardo/PixelPlayer.git

Highlighted Details

• Privacy-first design with Material You dynamic color theming and customizable UI elements.
• AI-powered personalized playlists (supporting Gemini, Deepseek, OpenAI) and synchronized lyrics via LRCLIB API.
• Chromecast support for streaming to external devices, with Android Auto integration planned.
• Advanced metadata editing using TagLib for MP3, FLAC, and M4A files, alongside multi-format audio support.

Maintenance & Community

Contributions are welcomed via standard Pull Request workflows. The README does not specify community channels (like Discord or Slack) or provide details on notable contributors, sponsorships, or partnerships.

Licensing & Compatibility

This project is licensed under the MIT License, which is permissive and generally compatible with commercial use and closed-source applications.

Limitations & Caveats

The project explicitly states that no forks will receive support; users of forks must seek assistance from the forker. A minimum of Android 11 (API 30) is required. Android Auto support is listed as "Soon".