• Few fixes to the Lyrics View (Again)

• Initial Readme, more details will be added in the future

Author: grimmthejow

README.md

@@ -0,0 +1,159 @@
+
+# 🎵 XMusic
+
+##### A Material 3 Expressive Music player for Android built with pure Java
+
+![License](https://img.shields.io/badge/License-GNU%20v3.0-blue.svg)  ![Status](https://img.shields.io/badge/Status-Maintained-success.svg) ![Platform](https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white) ![Java](https://img.shields.io/badge/Language-Java-ED8B00?logo=openjdk&logoColor=white)
+
+
+![Banner](https://i.postimg.cc/qMWJMDKc/304ab7d2-92e8-4df3-83bd-c07e7464cd61.png)
+
+---
+
+## ✨ Features (Detailed)
+---
+### Core Playback
+
+- Media3 ExoPlayer based playback    
+- Background playback with notification controls  
+- MediaSession integration (lockscreen, headset, system controls)  
+
+### Now Playing UI
+
+- Dynamic Now Playing UI tinted by album artwork colors  
+- Smooth track transitions and animated player states  
+- Fullscreen Now Playing with expandable bottom sheet  
+- Predictive back support with custom framework animations  
+
+### UI & Animations
+
+- MotionLayout-driven bottom sheet player  
+- Gesture-based interactions  
+- UI state restoration across configuration changes  
+- Predictive back animations everywhere 
+
+### Library & Browsing
+
+- Local audio scanning with fast indexing  
+- Song, album, and artist browsing  
+- Instant queue building and reordering  
+- Fully offline, on-device playback  
+
+### Lyrics & Visuals
+
+- Built-in lyrics support with animated transitions  
+- Romaji/translation lyrics support
+
+### Performance & Architecture
+- Lightweight playback service 
+- Works fine with low-end devices  
+
+### Privacy
+
+- No ads  
+- No tracking  
+- No “sign in to listen to your own files” clown behavior
+- No cloud dependency  
+
+### Customization
+
+- Dynamic theming support  
+- Album art–driven UI colors  
+
+---
+
+## To-Do List
+- [ ] Finish settings screen
+- [ ] Add more features to the now Playing UI
+- [ ] Add a contextual menu for songs
+- [ ] Make a functional search fragment 
+- [ ] Idk
+---
+
+##  Showcase
+---
+![Screenshot 1](images/ss1.jpg)
+![Screenshot 2](images/ss2.jpg)
+![Screenshot 3](images/ss3.jpg)
+
+---
+
+## ⬇️ Download the app
+- You can get Latest XMusic build via [GitHub Actions](https://github.com/Yamenher/XMusic/actions) or via the [dedicated topic](https://t.me/XMusicCommunity/4) in our telegram community.
+
+---
+
+## 📱 Minimum Requirements
+
+- Android 8.0 (API 26) or higher
+- Local audio files stored on device
+- A brain (for reporting bugs)
+---
+
+## ⚠️ Important Notice
+- The app is still WIP (Work In Progress) and is far away from a stable release, that's why you might notice a lot of bugs, missing features, and some instability problems, but **Don't worry,** everything will worked on in the near future.
+---
+
+## 🐛 Report bugs
+If you run into bugs, crashes, or weird behavior that clearly wasn’t supposed to happen (looking at you, OEMs) :
+
+- **GitHub Issues**  
+  Report bugs, crashes, and feature requests [here](https://github.com/Yamenher/XMusic/issues)
+
+- **Community & Discussion**  
+  Join our telegram community for updates, feedback, and general discussion:  
+  https://t.me/xmusiccommunity
+
+Before opening an issue, make sure you’re on the latest nightly version, specify **The exact version you're using** via its commit hash from the APK file name and include logs, device info, and reproduction steps.
+DO NOT JUST SAY "I'm using latest version"
+Note : “App broken” is not a bug report.
+
+---
+
+## Q&A
+
+**Q: Is XMusic free?**  
+A: Yes. Completely free. No ads, no subscriptions, no hidden nonsense.
+
+**Q: Does XMusic require an account or internet connection?**  
+A: No. Everything works fully offline and stays on your device.
+
+**Q: Where does XMusic get my music from?**  
+A: It scans local audio files stored on your device. Nothing is uploaded anywhere.
+
+**Q: Why doesn’t XMusic show my songs?**  
+A: Make sure storage permissions are granted and your audio files are in supported formats.
+
+**Q: Does XMusic collect any personal data?**  
+A: No. There is no tracking, analytics abuse, or data harvesting.
+
+**Q: Why did playback stop in the background?** 
+A: Your system’s battery optimization or OEM “power saving” probably killed it. Disable optimizations for XMusic.
+
+**Q: Can I request features or report bugs?**  
+A: Yes. Use GitHub Issues for bugs and feature requests, or join the Telegram community for discussion.
+
+**Q: Why is feature X not available?**
+A: If you think this feature will be useful for a lot of people, feel free to suggest it via reaching to our [Telegram Community](https://t.me/xmusiccommunity)
+
+**Q: Is XMusic open source?**  
+A: You can tell.
+
+---
+## 🤝 Credits & Special Thanks
+* [Nick](https://github.com/nift4) For the precious advices and help he provided for me when I needed help.
+* **Oto music, PixelPlayer and Gramophone Devs** - For the UI inspiration and feedback.
+* **All Testers, Especially [MACİT ELCİBİN](https://t.me/Macitelc)** for testing new builds, trying out buggy features, and reporting every single bug and helping me *break* the app to improve it :P
+* **All Contributors** - For helping make XMusic better for everyone.
+
+---
+
+## 📜 License
+Distributed under the **GNU General Public License v3.0**. See [LICENSE](https://github.com/Yamenher/XMusic/blob/main/LICENSE) for more information.
+
+---
+
+## ✉️ Contact
+
+For inquiries or support, reach out at:  
+hermassiyamen@gmail.com

app/src/main/java/com/xapps/media/xmusic/activity/MainActivity.java

@@ -1021,7 +1021,6 @@ public void updateColors() {
             tmpColor = XUtils.interpolateColor(bottomSheetColor, playerSurface, currentSlideOffset);
             background.setColor(tmpColor);
             binding.lyricsContainer.setBackgroundColor(playerSurface);
-            binding.lyricTopScrim.setScrimColor(playerSurface);
 
             gd.setColor(isc);
 

app/src/main/java/com/xapps/media/xmusic/widget/AppleMeshGradientView.java

@@ -51,17 +51,17 @@ protected void onDraw(Canvas canvas) {
         drawBlob(canvas, 
             w * 0.5f + (float) Math.sin(time * 0.3f) * (w * 0.1f), 
             h * 0.5f + (float) Math.cos(time * 0.3f) * (h * 0.1f), 
-            w * 1.8f, dominantColor, 140);
+            w * 2.5f, dominantColor, 180);
 
         drawBlob(canvas, 
             w * 0.2f + (float) Math.cos(time * 0.8f) * (w * 0.4f), 
             h * 0.8f + (float) Math.sin(time * 0.6f) * (h * 0.3f), 
-            w * 1.2f, accentColor1, 160);
+            w * 1.1f, accentColor1, 100);
 
         drawBlob(canvas, 
             w * 0.8f + (float) Math.sin(time * 0.5f) * (w * 0.3f), 
             h * 0.2f + (float) Math.cos(time * 0.9f) * (h * 0.4f), 
-            w * 1.1f, accentColor2, 160);
+            w * 1.0f, accentColor2, 80);
 
         postInvalidateOnAnimation();
     }

app/src/main/res/layout/activity_main.xml

@@ -307,11 +307,6 @@
                             app:layout_constraintEnd_toEndOf="parent"
                             android:clipChildren="false"
                             android:clipToPadding="false" />
-                        <com.xapps.media.xmusic.widget.StatusBarScrimView
-                            android:id="@+id/lyric_top_scrim"
-                            android:layout_width="match_parent"
-                            android:layout_height="56dp"
-                            app:layout_constraintTop_toTopOf="parent" />
                     </androidx.constraintlayout.widget.ConstraintLayout>
                     <androidx.coordinatorlayout.widget.CoordinatorLayout
                         android:id="@+id/second_coordinator"