Plugd is a powerful, cross-platform music player designed with a premium, aesthetic glassmorphism UI. Built with modern web technologies and packaged via Capacitor, Plugd offers a true native experience with perfectly gapless background playback.
- 🎧 Native Background Playback: Driven by Android's powerful
Media3 ExoPlayerfor robust, perfectly gapless playback and system notification controls. - lyrics Synchronized Lyrics: Real-time, synced lyrics provided seamlessly through LRCLIB, featuring beautiful scale-and-glow animations.
- 🎨 Glassmorphism UI: A breathtaking, fluid React interface with dynamic color extraction from album art.
- ⚡ Zero-Delay Queues: Pre-caching and seamless native queue transitions ensure the music never skips a beat.
- 🔒 Secure & Private: Full codebase obfuscation via Vite plugins and Android ProGuard.
- 🚀 Automated CI/CD: Ready-to-use GitHub Actions pipeline for instant APK builds.
- Frontend Core: React 18 + Vite
- Native Wrapper: Capacitor
- Styling: Vanilla CSS with dynamic CSS Variables
- Audio Engine (Android):
androidx.media3.exoplayer - Audio Engine (Web): HTML5
<audio>
- Node.js (v18+)
- Android Studio (for Android deployment)
-
Clone the repository:
git clone https://github.com/Pikazu/Plugd.git cd Plugd -
Install dependencies:
npm install
-
Run the development server:
npm run dev
-
Sync with Android:
npm run build npx cap sync android
-
Open in Android Studio:
npx cap open android
Plugd is designed to be tamper-resistant:
- The React frontend is obfuscated using
rollup-plugin-obfuscator. - The Android binary is shrunk and obfuscated using ProGuard/R8. (Debugging in production is intentionally restricted to protect proprietary algorithms).
This repository includes a fully configured .github/workflows/release.yml file.
Simply push a tag starting with v (e.g., git tag v1.0.0 && git push --tags) and GitHub Actions will automatically compile and release an unsigned APK.
This project is licensed under the MIT License - see the LICENSE file for details.