Convx

An open-source Android music player with a calm, glass-inspired interface.

UPI ID: cosmictaser@okicici
UPI payment link: upi://pay?pa=cosmictaser%40okicici&pn=CosmicTaser&cu=INR

Contributing · Community

Convx brings music discovery, playback, lyrics, and your library together in one Android app. It is built with Kotlin, Jetpack Compose, and Media3, with custom Cupertino-style controls and Liquid Glass surfaces.

• Browse and stream music through Convx's InnerTube client.
• Keep listening in the background with notification, lock-screen, and Android Auto controls.
• Save music for offline listening and manage a local library.
• Build queues and playlists, set a sleep timer, change playback speed, and use the equalizer.
• Use crossfade, Automix, and DJ-style transitions.

• Follow synchronized lyrics with word-level highlighting.
• Explore animated artwork and album-inspired colors.
• Browse lyrics from multiple providers.

• Browse local music and network shares, including SMB and WebDAV.
• Import playlists from Spotify.
• Connect Discord Rich Presence, Last.fm, music recognition, and Listen Together.

• Frosted, refractive glass surfaces for menus, sheets, and floating controls.
• Cupertino-style controls built for Convx's HIG and Android interaction patterns.
• Adaptive themes and layouts for phones and wider screens.

• Stable: The current release is outdated and not working. A refreshed Stable release will be published soon after the remaining issues are fixed.
• Nightly 2.0.4: Download from GitHub Releases. Nightlies are pre-release builds and may be unstable. On a 32-bit-only phone (for example Galaxy A13) that says "app not compatible", download the arm32 APK from the same release.

The project website is being reworked. Use GitHub Releases for downloads for now.

Convx supports Android 8.0 (API 26) and later. Install APKs only from sources you trust. Android may ask you to allow installation from the app you used to download the APK.

Convx is a Gradle multi-module Android project. Keep code in the module that owns the capability, and use its existing public APIs when another module needs it.

The Android app uses Jetpack Compose for UI, Media3 for playback, Room for the local library, and DataStore for preferences. App modules are wired through the existing Hilt setup.

• JDK 21
• Android Studio with Android SDK 37 installed
• Android NDK for native components

Clone the repository, open it in Android Studio, and let Gradle sync. To build a debug APK or run unit tests from a terminal:

./gradlew :app:assembleUniversalFossDebug
./gradlew :app:testUniversalFossDebugUnitTest

On Windows, use gradlew.bat with the same task names. The Foss build omits Google Play services; the Gms build includes Google Cast support.

Bug reports, fixes, and feature contributions are welcome. Start with the Contributing Guide, follow the Code of Conduct, and read the Security Policy before reporting a vulnerability.

AI agents should also follow the Agent Contribution Guide. Its Android, animation, code review, and requirement discovery skills are bundled under contributor/skills/ and work offline.

• Discord community
• Support Convx on Ko-fi
• Project website (being reworked)

Convx is an independent project and is not affiliated with, endorsed by, or connected to YouTube, Google, or their affiliates. Some features use unofficial third-party interfaces that may change or stop working. Users are responsible for following applicable laws and service terms.

Convx is licensed under the GNU General Public License v3.0. See LICENSE and NOTICE for license and third-party attribution details.

Maintained by Aryan (Cosmic Taser).