base on # PixelPlay Music Player 🎵 <p align="center"> <img src="assets/icon.png" alt="App Icon" width="128"/> </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/PixelPlay/releases/latest"> <img src="https://img.shields.io/github/v/release/theovilardo/PixelPlay?include_prereleases&logo=github&style=for-the-badge&label=Latest%20Release" alt="Latest Release"> </a> <a href="https://github.com/theovilardo/PixelPlay/releases"> <img src="https://img.shields.io/github/downloads/theovilardo/PixelPlay/total?logo=github&style=for-the-badge" alt="Total Downloads"> </a> </p> PixelPlay is a modern, offline-first music player for Android, built with Kotlin and Jetpack Compose. It's designed to provide a beautiful and seamless experience for listening to your local music library. ## ✨ Core Features - **Local Music Playback**: Scans and plays your local audio files (MP3, FLAC, AAC, etc.). - **Background Playback**: Listen to music while the app is in the background, thanks to a foreground service and Media3. - **Modern UI**: A beautiful and responsive UI built with Jetpack Compose and Material 3 Expressive, supporting Dynamic Color and dark/light themes. - **Music Library**: Organize and browse your music by songs, albums, and artists. - **Widget**: Control your music from the home screen with a Glance-based app widget. - **Tag Editor**: Edit song metadata (title, artist, album, etc.) with the built-in tag editor. - **AI-Powered Features**: Explore advanced features powered by Gemini for a unique listening experience. ## 🛠️ Tech Stack & Architecture - **Language**: 100% [Kotlin](https://kotlinlang.org/) - **UI**: [Jetpack Compose](https://developer.android.com/jetpack/compose) for a declarative and modern UI. - **Audio Playback**: [Media3 (ExoPlayer)](https://developer.android.com/guide/topics/media/media3) for robust audio playback. - **Architecture**: MVVM (Model-View-ViewModel) with a reactive approach using StateFlow and SharedFlow. - **Dependency Injection**: [Hilt](https://dagger.dev/hilt/) for managing dependencies. - **Database**: [Room](https://developer.android.com/training/data-storage/room) for local database storage. - **Background Processing**: [WorkManager](https://developer.android.com/topic/libraries/architecture/workmanager) for background tasks like syncing the music library. - **Asynchronous Operations**: [Kotlin Coroutines & Flow](https://kotlinlang.org/docs/coroutines-guide.html) for managing asynchronous operations. - **Networking**: [Retrofit](https://square.github.io/retrofit/) for making HTTP requests. - **Image Loading**: [Coil](https://coil-kt.github.io/coil/) for loading and caching images. - **Metadata**: [JAudioTagger](http://www.jthink.net/jaudiotagger/) for reading and writing audio file metadata. - **Audio Processing**: [Amplituda](https://github.com/lincollincol/Amplituda) for audio processing and waveform generation. ## 🚀 Getting Started To get a local copy up and running, follow these simple steps. ### Prerequisites - Android Studio Iguana | 2023.2.1 or newer. - Android SDK 29 or newer. ### Installation 1. Clone the repo ```sh git clone https://github.com/theovilardo/PixelPlay.git ``` 2. Open the project in Android Studio. 3. Let Gradle sync and download the required dependencies. 4. Run the app on an emulator or a physical device. ## 📂 Project Structure The project follows the standard Android app structure, with a few key directories: ``` app/src/main/java/com/theveloper/pixelplay/ ├── data │ ├── local # Room database, DAOs, and entities. │ ├── remote # Retrofit services for any network calls. │ ├── repository # Repositories that abstract data sources. │ └── service # The MusicService for background playback. ├── di # Hilt dependency injection modules. ├── domain # Use cases and domain models (if any). ├── presentation # UI-related classes. │ ├── components # Reusable Jetpack Compose components. │ ├── navigation # Navigation graph and related utilities. │ ├── screens # Composable screens for different parts of the app. │ └── viewmodel # ViewModels for each screen. ├── ui │ ├── glancewidget # Glance App Widget implementation. │ └── theme # App theme, colors, and typography. └── utils # Utility classes and extension functions. ``` ", Assign "at most 3 tags" to the expected json: {"id":"14869","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"