CONVX

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

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

📸 Screenshots

☕ Support: Ko-fi  •  💸 UPI: cosmictaser@okicici  •  🌐 Website: cosmictaser.de5.net

🎵 About Convx

Convx 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.

Convx started as a fork of vivi-music; see Credits below.

✨ Features

🏗️ 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 Convx 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 Convx, 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.

Convx 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