PixelPlayer: Void-Iconic Edition 🎵

The definitive high-fidelity, AI-augmented local music platform for Android.
Merging audiophile-grade DSP precision with Gemini-powered intelligent automation.

---

🏛️ Project Vision & Leadership

Lead Architect & Project Visionary: VoidX3D

The Void-Iconic Edition represents a complete technical and visual overhaul of PixelPlayer, transforming it from a modern open-source player into an elite Android audio platform.

---

🧱 Technical Architecture: The Three Pillars

1. Titan High-Fidelity Audio Engine (Module I)

The core of Void-Iconic is the Titan Engine, designed for absolute sonic transparency and precision.

• 32-Band Parametric EQ: Total control over frequency, gain, and Q-factor.
• 32-bit Internal Processing: Minimal quantization error and maximum headroom.
• ReplayGain & Pre-Amp: Integrated Track/Album mode with ±30dB Pre-Amp stage.
• Peak Limiter: Prevents digital clipping at the final DSP stage.
• Per-Device DSP Profiles: Automatic preset switching based on connection ID.

2. Void-Intelligence (Module II)

Advanced AI integration powered by Gemini 2.0 that moves beyond simple playback into autonomous curation.

• AI Magic Wand Interface: Natural language processing for complex queue and playlist operations.
• Autonomous Metadata Engine: Background workers for 4K album art and synchronized lyrics.
• Smart Search (FTS4/5): Lightning-fast indexing across lyrics, bitrate, and sample rate.
• Pixel Wrapped: On-device analytics engine with listening heatmaps.

3. Iconic Visual Identity (Module III)

A signature aesthetic that matches the technical excellence of the engine.

• Void-Neon Theme: True AMOLED blacks with high-contrast neon accents (Cyan, Magenta, Lime).
• Glassmorphism Engine: GPU-optimized real-time blur for an immersive "Now Playing" experience.
• Reactive Waveform Scrubber: Neon-reactive visual seeking powered by Amplituda.
• Audio Fidelity Indicator: Real-time "Hi-Res" and "Lossless" badges.

---

✨ Feature Comparison

Feature	Standard Edition	Void-Iconic Edition
Audio Processing	10-Band EQ	32-Band Parametric EQ
Bit Depth	16/24-bit	32-bit Float Pipeline
Peak Limiter	No	Yes (Safe Gain Stage)
AI Integration	Basic Daily Mix	Gemini 2.0 Magic Wand
Metadata	Manual/Auto	Autonomous Background Engine
Search	Basic Title/Artist	FTS4/5 (Lyrics/Bitrate/Tags)
Visuals	Material You	Glassmorphism + Neon

---

🛠️ Roadmap: The Evolution

Phase I: Identity Foundation (Complete)

• VoidX3D Vision Integration
• About Screen & Documentation Overhaul
• Void-Iconic Branding Establishment

Phase II: Titan Engine (Complete)

• 32-Band Parametric EQ Core
• 32-bit Internal Audio Pipeline
• ReplayGain & ±30dB Pre-Amp Logic
• Safe Peak Limiter Stage

Phase III: Intelligence Layer (Complete)

• Gemini 2.0 Magic Wand Connector
• Autonomous Metadata AI Workers
• Smart Search (FTS4/5 Indexing)
• Pixel Wrapped Analytics Core

Phase IV: Visual & Experience Layer (In Progress)

• GPU-Optimized Glassmorphism Engine
• Reactive Waveform Scrubber (Amplituda)
• Audio Fidelity Badge (Hi-Res/Lossless)
• Lyric Interface Lock
• Spring-Loaded Reactive EQ Visualizer

---

🛠️ Tech Stack

Category	Technology
Language	Kotlin 100%
UI Framework	Jetpack Compose
Audio Engine	Titan (Media3 ExoPlayer + FFmpeg)
AI Engine	Void-Intelligence (Gemini 2.0)
Architecture	MVVM + Clean Architecture
DI	Hilt
Database	Room (FTS5)
Image Loading	Coil

---

🚀 Getting Started

Prerequisites

• Android Studio Ladybug | 2024.2.1+
• Android SDK 30+
• JDK 17+

Installation

1. Clone the repository: git clone https://github.com/theovilardo/PixelPlayer.git
2. Open in Android Studio.
3. Sync Gradle and build the :app module.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Lead Architect & Project Visionary: VoidX3D
Built upon the foundation by theovilardo