base on null # PixelPlayer šŸŽµ <p align="center"> <img src="assets/icon.png" alt="App Icon" width="128"/> </p> <p align="center"> <strong>A beautiful, feature-rich music player for Android</strong><br> Built with Jetpack Compose and Material Design 3 </p> <p align="center"> <img src="assets/screenshot1.jpg" alt="Screenshot 1" width="200" style="border-radius:26px;"/> <img src="assets/screenshot2.jpg" alt="Screenshot 2" width="200" style="border-radius:26px;"/> <img src="assets/screenshot3.jpg" alt="Screenshot 3" width="200" style="border-radius:26px;"/> <img src="assets/screenshot4.jpg" alt="Screenshot 4" width="200" style="border-radius:26px;"/> </p> <p align="center"> <a href="https://github.com/theovilardo/PixelPlayer/releases/latest"> <img src="https://img.shields.io/github/v/release/theovilardo/PixelPlayer?include_prereleases&logo=github&style=for-the-badge&label=Latest%20Release" alt="Latest Release"> </a> <a href="https://github.com/theovilardo/PixelPlayer/releases"> <img src="https://img.shields.io/github/downloads/theovilardo/PixelPlayer/total?logo=github&style=for-the-badge" alt="Total Downloads"> </a> <img src="https://img.shields.io/badge/Android-10%2B-green?style=for-the-badge&logo=android" alt="Android 10+"> <img src="https://img.shields.io/badge/Kotlin-100%25-purple?style=for-the-badge&logo=kotlin" alt="Kotlin"> </p> --- ## ✨ Features ### šŸŽØ Modern UI/UX - **Material You** - Dynamic color theming that adapts to your wallpaper - **Smooth Animations** - Fluid transitions and micro-interactions - **Customizable UI** - Adjustable corner radius and navigation bar settings - **Dark/Light Theme** - Automatic or manual theme switching - **Album Art Colors** - Dynamic color extraction from album artwork ### šŸŽµ Powerful Playback - **Media3 ExoPlayer** - Industry-leading audio engine with FFmpeg support - **Background Playback** - Full media session integration - **Queue Management** - Drag-and-drop reordering - **Shuffle & Repeat** - All playback modes supported - **Gapless Playback** - Seamless transitions between tracks - **Custom Transitions** - Configure crossfades between songs ### šŸ“š Library Management - **Multi-format Support** - MP3, FLAC, AAC, OGG, WAV, and more - **Browse By** - Songs, Albums, Artists, Genres, Folders - **Smart Artist Parsing** - Configurable delimiters for multi-artist tracks - **Album Artist Grouping** - Proper album organization - **Folder Filtering** - Choose which directories to scan ### šŸ” Discovery & Organization - **Full-text Search** - Search across your entire library - **Daily Mix** - AI-powered personalized playlist based on listening habits - **Playlists** - Create and manage custom playlists - **Statistics** - Track your listening history and habits ### šŸŽ¤ Lyrics - **Synchronized Lyrics** - LRC format via LRCLIB API - **Lyrics Editing** - Modify or add lyrics to your tracks - **Scrolling Display** - Follow along as you listen ### šŸ–¼ļø Artist Artwork - **Deezer Integration** - Automatic artist images from Deezer API - **Smart Caching** - Memory (LRU) + database caching for offline access - **Fallback Icons** - Beautiful placeholders when images unavailable ### šŸ“² Connectivity - **Chromecast** - Stream to your TV or smart speakers - **Android Auto** - Full Android Auto support for in-car playback - **Widgets** - Home screen control with Glance widgets ### āš™ļø Advanced Features - **Tag Editor** - Edit metadata with TagLib (MP3, FLAC, M4A support) - **AI Playlists** - Generate playlists with Gemini AI - **Audio Waveforms** - Visual representation with Amplituda --- ## šŸ› ļø Tech Stack | Category | Technology | |----------|------------| | **Language** | [Kotlin](https://kotlinlang.org/) 100% | | **UI Framework** | [Jetpack Compose](https://developer.android.com/jetpack/compose) | | **Design System** | [Material Design 3](https://m3.material.io/) | | **Audio Engine** | [Media3 ExoPlayer](https://developer.android.com/guide/topics/media/media3) + FFmpeg | | **Architecture** | MVVM with StateFlow/SharedFlow | | **DI** | [Hilt](https://dagger.dev/hilt/) | | **Database** | [Room](https://developer.android.com/training/data-storage/room) | | **Networking** | [Retrofit](https://square.github.io/retrofit/) + OkHttp | | **Image Loading** | [Coil](https://coil-kt.github.io/coil/) | | **Async** | Kotlin Coroutines & Flow | | **Background Tasks** | WorkManager | | **Metadata** | [TagLib](https://github.com/nicholaus/taglib-android) | | **Widgets** | [Glance](https://developer.android.com/jetpack/compose/glance) | --- ## šŸ“± Requirements - **Android 10** (API 29) or higher - **4GB RAM** recommended for smooth performance --- ## šŸš€ Getting Started ### Prerequisites - Android Studio Ladybug | 2024.2.1 or newer - Android SDK 29+ - JDK 11+ ### Installation 1. **Clone the repository** ```sh git clone https://github.com/theovilardo/PixelPlayer.git ``` 2. **Open in Android Studio** - Open Android Studio - Select "Open an Existing Project" - Navigate to the cloned directory 3. **Sync and Build** - Wait for Gradle to sync dependencies - Build the project (Build → Make Project) 4. **Run** - Connect a device or start an emulator - Click Run (ā–¶ļø) --- ## ā¬‡ļø Download <p align="center"> <a href="https://github.com/theovilardo/PixelPlayer/releases/latest"> <img src="https://raw.githubusercontent.com/Kunzisoft/Github-badge/main/get-it-on-github.png" alt="Get it on GitHub" height="60"> </a> </p> <p align="center"> <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22com.theveloper.pixelplay%22%2C%22url%22%3A%22https%3A%2F%2Fgithub.com%2Ftheovilardo%2FPixelPlayer%22%2C%22author%22%3A%22theovilardo%22%2C%22name%22%3A%22PixelPlayer%22%2C%22supportFixedAPKURL%22%3Afalse%7D"> <img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" alt="Get it on Obtainium" height="50"> </a> </p> --- ## šŸ“‚ Project Structure ``` app/src/main/java/com/theveloper/pixelplay/ ā”œā”€ā”€ data/ │ ā”œā”€ā”€ database/ # Room entities, DAOs, migrations │ ā”œā”€ā”€ model/ # Domain models (Song, Album, Artist, etc.) │ ā”œā”€ā”€ network/ # API services (LRCLIB, Deezer) │ ā”œā”€ā”€ preferences/ # DataStore preferences │ ā”œā”€ā”€ repository/ # Data repositories │ ā”œā”€ā”€ service/ # MusicService, HTTP server │ └── worker/ # WorkManager sync workers ā”œā”€ā”€ di/ # Hilt dependency injection modules ā”œā”€ā”€ presentation/ │ ā”œā”€ā”€ components/ # Reusable Compose components │ ā”œā”€ā”€ navigation/ # Navigation graph │ ā”œā”€ā”€ screens/ # Screen composables │ └── viewmodel/ # ViewModels ā”œā”€ā”€ ui/ │ ā”œā”€ā”€ glancewidget/ # Home screen widgets │ └── theme/ # Colors, typography, theming └── utils/ # Extensions and utilities ``` --- ## šŸ¤ Contributing Contributions are welcome! Please feel free to submit a Pull Request. 1. Fork the Project 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the Branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request --- ## šŸ“„ License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. --- <p align="center"> Made with ā¤ļø by <a href="https://github.com/theovilardo">theovilardo</a> </p> ", Assign "at most 3 tags" to the expected json: {"id":"15551","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"