BEATWAVE

BeatWave is an open-source, Liquid Glass music player for Android

⬇️ DOWNLOAD Latest Build. — Latest release. Works on Android 8.0+.

💸 UPI: akshanshsinha67@axl  •  🌐 Website: support-akshansh.vercel.app

---

🎵 About BeatWave

BeatWave is a free, open-source music player for Android that streams from YouTube Music, built with Jetpack Compose on a Media3 ExoPlayer core. The UI is a custom Liquid Glass design system — frosted, refractive surfaces, iOS-style bouncy scrolling, and progressive blur chrome — instead of stock Material widgets.

BeatWave started as a fork of CONVX; see Credits below.

---

✨ Features

🧊 Liquid Glass UI Real backdrop blur: frosted glass chrome (nav bar, floating buttons, sheets) that actually samples and refracts the content behind it, not a flat translucent color. iOS-style motion: bouncy rubber-band overscroll, blurred page transitions, springy nav puck. Material You: adaptive colors pulled from the currently playing artwork.	🎵 Streaming Full YT Music catalog: ad-free streaming and background playback with full notification/lock-screen controls. Offline downloads: cache tracks locally with smart storage management. Lossless/high-quality audio and a built-in equalizer.
📝 Lyrics & Social Synced, karaoke-style lyrics with word-by-word highlighting. Discord Rich Presence: show what you're listening to on your profile. Listen Together: sync playback with friends in real time.	🛡️ Privacy & Updates Zero telemetry: no trackers, no analytics, fully local library and preferences. Built-in updater: in-app update checks and changelogs, no third-party store required.

---

🏗️ Architecture

Quick map for contributors — see CONTRIBUTING.md for the full guide.

• UI: Jetpack Compose, MVVM (ui/screens + viewmodels), navigated via ui/screens/NavigationBuilder.kt.
• Liquid Glass: ui/component/GlassEffect.kt exposes Modifier.liquidGlass(...), built on a vendored, source-included copy of Kyant0/backdrop under ui/component/backdrop/. A Backdrop (usually a rememberLayerBackdrop() attached via Modifier.layerBackdrop(...) to some subtree) captures real pixels; any surface holding a reference to that same backdrop can sample, blur, and refract it through drawBackdrop(...). The floating nav bar, circular back/share buttons, and sheets are all just glass surfaces sampling a nearby backdrop this way.
• Playback: Media3 ExoPlayer service in playback/MusicService.kt.
• Data: Room database (db/) for the local library, DataStore for preferences (utils/DataStore.kt, constants/PreferenceKeys.kt).
• YouTube Music access: the innertube module — an unofficial InnerTube API client, kept separate from the app module.
• Updater: vivimusic/updater/ checks GitHub Releases for new versions and handles in-app APK download/install (FOSS/GMS build flavors behave slightly differently — see BuildConfig.CAST_AVAILABLE).

---

🚗 Android Auto Setup

If BeatWave doesn't appear in Android Auto:

1. Open Android Auto on your phone
2. Tap the hamburger menu (three lines) and go to Settings
3. Scroll to the bottom and tap the version number multiple times to enable Developer Settings
4. Tap the three dots menu (⋮) at the top-right
5. Select Developer settings
6. Enable Unknown sources
7. Restart Android Auto and connect to your car

---

🤝 Contributing

Contributions are welcome — bug reports, feature requests, and code. Start with CONTRIBUTING.md for the project layout, build setup, and PR checklist. Short version:

1. Fork the repository
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

---

🛡️ Privacy & Data Collection

At BeatWave, your privacy is our top priority. We believe that your music and data belong exclusively to you.

• Zero Data Collection: we do not collect, store, or share any of your personal information, usage habits, or listening history.
• 100% Local: all your settings, downloaded tracks, and offline caches are stored securely on your device.
• No Tracking: no hidden trackers, analytics, or background services monitoring your activity.

---

📜 Disclaimer

This project and its contents are not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC, or any of their affiliates and subsidiaries.

Any trademark, service mark, trade name, or other intellectual property rights used in this project are owned by their respective owners.

BeatWave is an independent project created for educational and personal use purposes.

---

📄 License

This project is licensed under the terms specified in the LICENSE file (GPL-3.0).

---

💬 Community & Support Connect with other listeners, suggest features, report bugs, and stay updated on releases. 🐞 Report Bugs  •  💬 Discussions  •  🚀 Releases

---

🙏 Credits

BeatWave is developed and maintained by Vortex Apps. See support-akshansh.vercel.app for support.

💡 Built On vivi-music by Vividh P Ashokan — the project BeatWave was forked from. The Apple Music Player V17 full-screen player style (Settings → Player Theme) is ported from vivi-music's Apple Music player UI, GPL-3.0.

🎖️ Foundational Projects Kyant0/backdrop — the real-time backdrop blur/refraction library the Liquid Glass UI is built on. Better Lyrics and SimpMusic — synced lyrics. YouLyPlus — in-app lyrics styling. Monochrome — the animated visualizer canvas.

The open-source community for tools, libraries, and APIs that make this project possible.

---

Made with ❤️ for music lovers everywhere

⭐ Star this repo if you enjoy BeatWave!