Convx

cosmictaserdev-creatorGPL-3.0活跃维护

一款免费开源的 Android 音乐播放器,可播放 YouTube Music,带 iOS 风格液态玻璃界面、同步歌词、自动混音和一起听功能。

A free, open-source Android music player for YouTube Music with an iOS-style Liquid Glass interface, synced lyrics, Automix and Listen Together.

2.0.4-nightly发布于 2026-10-19 07:08 UTC1,349star +54 / 7 天80fork同步于 2026-11-10 11:48 UTC

怎么上手

由 README 提炼,执行前请确认
./gradlew :app:assembleUniversalFossDebug
硬件要求按 README 说明

README 未说明;仅要求 Android 8.0(API 26)及以上设备,纯 32 位手机需下载 arm32 APK

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

开源 Android 音乐播放器,通过 InnerTube 播放 YouTube Music,带液态玻璃界面

一款免费开源的 Android 音乐播放器,可播放 YouTube Music,带 iOS 风格液态玻璃界面、同步歌词、自动混音和一起听功能。

核心能力

  • 通过 InnerTube 客户端浏览并流式播放音乐
  • 支持离线保存、本地曲库、队列与播放列表
  • 逐词高亮的同步歌词,多歌词源可选
  • 支持 SMB 与 WebDAV 网络共享曲库
  • Automix、交叉淡入淡出与 DJ 式过渡

容易踩的坑

当前 Stable 版本已失效,需从 GitHub Releases 下载 Nightly 2.0.4;本地构建需 JDK 21、Android SDK 37 和 NDK;Foss 构建不含 Google Play 服务,需要 Cast 请用 Gms 构建

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本2.0.4-nightly
  1. 2.0.4-nightlyConvx 2.0.4 Nightlypre-release最新正式版2026-10-19 · 2026-10-19 07:08 UTC

    Convx 2.0.4 Nightly

    Pre-release build from main. Nightly builds may be unstable. Please report issues in the Convx GitHub issue tracker.

    Which APK?

    • convx-2.0.4-nightly.apk: for almost every phone (64-bit).
    • convx-arm32-2.0.4-nightly.apk: for 32-bit-only phones.

    New in 2.0.4

    • Spotify login fix.
    • Modules fix.
    • Lyrics: the active line has a seekbar-inspired chrome highlight, timed words glow as they animate, and the style is named Convx Lyrics. Custom fonts and lyric sizing are available in settings.
    • Add-ons request the chosen audio quality before using a stream URL attached to search results, so lossless formats can be selected when the provider offers them, with playable fallbacks when it does not.
    • Apple Music import opens in a dialog from Accounts & Services, and settings search includes every settings page and its keywords.
    • Player icon presets can be reused across controls without reopening the file picker.

    Fixes

    • #90: EQ text-profile import. Thanks @turi22.
    • #91: widgets failing to update independently. Thanks @olimpian0-0.
    • #92: cramped player action buttons. Thanks @generalyt86-oss.
    • #110: playlist download button doing nothing. Thanks @Arif-2747.
    • #111: trying alternate audio formats when playback fails. Thanks @taos42855-creator.

    Merged pull requests

    • #113: Spotify networking, lyric timing and library reliability, by @cosmictaserdev-creator.
    • #107: Complete French localization. Thanks @Mickael81.

    Also included from 2.0.3

    • Spotify login no longer identifies the sign-in page as an embedded WebView.
    • Discord login reads the token through an iframe when page storage is unavailable.
    • A 32-bit (arm32) APK is available for phones that cannot install the regular build.

    Also included from 2.0.2 and 2.0.1

    • Fixed a playback crash caused by the playback-stats tracker.
    • Playlist import and library fixes, feed refresh and pagination fixes, and reliability improvements across playback, navigation, lyrics, and appearance settings.
  2. 2.0.3-nightlyConvx 2.0.3 Nightlypre-release2026-10-17 · 2026-10-17 09:35 UTC
    查看更新说明

    Convx 2.0.3 Nightly

    Pre-release build from main. Nightly builds may be unstable. Please report issues in the Convx GitHub issue tracker.

    Which APK?

    • convx-2.0.3-nightly.apk: for almost every phone (64-bit).
    • convx-arm32-2.0.3-nightly.apk: only for 32-bit-only phones such as the Galaxy A13 that say "app not compatible" with the normal APK.

    New in 2.0.3

    • New 32-bit (arm32) APK for phones that could not install 2.0.x.
    • Spotify login: the sign-in page no longer identifies itself as an embedded WebView, which Spotify was rejecting.
    • Discord login: the token is now read through an iframe when Discord removes page storage, fixing logins that hung on the Discord page.

    Also included from 2.0.2 and 2.0.1

    • Fixed a playback crash caused by the playback-stats tracker.
    • Playlist import and library fixes, feed refresh and pagination fixes, and reliability improvements across playback, navigation, lyrics, and appearance settings.
  3. 2.0.2-nightlyConvx 2.0.2 Nightlypre-release2026-10-17 · 2026-10-17 08:15 UTC
    查看更新说明

    Convx 2.0.2 Nightly

    Pre-release build from main. Nightly builds may be unstable. Please report issues in the Convx GitHub issue tracker.

    New in 2.0.2

    • Fixed a crash during playback (IllegalArgumentException from the playback-stats tracker). A bad stats event is now dropped instead of closing the app.

    Also included from 2.0.1

    • Playlist import and library fixes.
    • Feed refresh and pagination fixes.
    • Reliability improvements across playback, navigation, lyrics, and appearance settings.
  4. 2.0.1-nightlyConvx 2.0.1 Nightlypre-release2026-10-17 · 2026-10-17 07:51 UTC
    查看更新说明

    Convx 2.0.1 Nightly

    Pre-release build from main. This nightly includes playlist import and library fixes, feed refresh and pagination fixes, and reliability improvements across playback, navigation, lyrics, and appearance settings.

    Nightly builds may be unstable. Please report issues in the Convx GitHub issue tracker.

  5. 2.0.0-nightlyConvx 2.0.0 Nightlypre-release2026-10-15 · 2026-10-15 16:40 UTC
    查看更新说明

    Convx 2.0.0 (Nightly)

    Pre-release built automatically from main. It is updated on every nightly build and may be unstable. Stable 2.0.0 will follow in a few days.

    Changes since 1.5.2.

    Highlights

    • Major performance pass across startup, Home, the player and scrolling.
    • Listen Together is back.
    • Change album and playlist covers from your own images.
    • Download bundles everything for an item in one step.
    • Rebuilt design language with consistent spacing, type and glass surfaces.
    • Animations refined across screens: nav, player, sheets and settings.
    • Better Automix: smarter track analysis and smoother transitions.
    • Network storage support for shared drives.
    • Import public Apple Music playlists.
    • New screens and a new category tab for navigating the app.
    • Refined local-only mode.
    • YouTube video in the player.
    • Elastic glass components.

    Settings

    • Settings root rebuilt into eight categories: Player & Lyrics, Playback & Audio, Appearance, Library & Content, Accounts & Services, Privacy & Storage, Your listening, Help & About.
    • Each category opens its own page with grouped rows.
    • Search bar docked at the bottom, opaque, and rises above the keyboard.
    • Tablets get a split view: categories on the left, the chosen page on the right.
    • Local only mode is a switch on the root; Listen Together is at the top.
    • Account screen text readable in light and dark mode.
    • Lyrics effects page for glow and blur.

    Player

    • Player design sheet with phone previews: Card, Vinyl, Clover, Apple Music and Apple Music v2 (Square / Full bleed).
    • Lyrics style sheet with a live preview of each animation style.
    • Lyrics effects page: glow, Apple Music blur and standard lyrics blur.
    • Volume bar can be hidden from the player design sheet.
    • YouTube video shown in the player.
    • Landscape classic player controls laid out correctly.
    • Smoother morph from the mini player; persistent mini player accessory.
    • Hero artist pages blur progressively as you scroll.
    • Heart and menu buttons fly up into the queue and lyrics header and back, like the Apple Music v2 player; the heart pops and fades to red when you like a song.
    • Vinyl and clover covers keep one steady rotation when the cover swaps with the header, so the thumbnail no longer glitches.
    • Menus opened from the player use the player's own background; the audio output menu now slides in like the others.
    • Lyrics: duet left/right alignment and singer badge.

    Navigation & glass

    • Album, artist, playlist, search results and the player always use the dark glass palette, in light mode too: nav bar, mini player, menus, buttons and icons.
    • Glass fades between light and dark instead of popping.
    • Elastic glass pills that stretch and spring as you interact.
    • Liquid Glass refinements: two-sided dark rim, muted ambient tints, search control at full bar height.
    • Search back arrow and side icons no longer vanish in light mode.
    • The accent colour now only recolours accents; it no longer tints page backgrounds.
    • Fixed the nav puck turning black while dragging.
    • Fixed a double top-inset gap in the top bar.

    Automix & DJ

    • Native Automix restored, with look-ahead analysis of the next track.
    • AI DJ Set builder and concert mode.
    • Smart automix integration.

    Fixes

    • Adding songs to a new playlist no longer loses them.
    • Fixed a crash when leaving the player settings page.
    • Fixed artist page foot blur rendering.

    Performance

    • Network stack moved to ktor-CIO for leaf providers.
    • Home title collapse and frost effects cheaper to draw.
    • Debug-only StrictMode; adaptive image cache; dead resources and NDK sources removed.
    • Hero background blur baked once instead of per frame.

    Internal

    • Innertube parsing split into per-feature mappers.
    • Review pass fixed SQL sorting, service scope and prefetch, DAO threading and several security findings.
    • Obsolete lyric and canvas provider modules removed.
    • Version now comes from version.properties.

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    [!WARNING] The current Stable release is outdated and not working. Use Nightly 2.0.4 from GitHub while the remaining issues are fixed. A refreshed Stable release will be published soon after they are fixed.

    The project website is being reworked, so download from GitHub Releases for now.

    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.

    Features

    Playback

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

    Lyrics and artwork

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

    Library and integrations

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

    Convx interface

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

    Download

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

    Project structure

    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.

    PathResponsibility
    app/Android application, screens, ViewModels, navigation, playback service, persistence, and app wiring.
    hig/Shared Cupertino-style controls, theme primitives, accessibility helpers, and glass utilities.
    innertube/InnerTube client and related models.
    lyrics/Lyrics providers, parsing, and lyrics support.
    canvas/Animated canvas and catalog features.
    artwork/Artwork loading, caching, and transitions.
    spotify/Spotify authentication and playlist import.
    integrations/Discord, Last.fm, music recognition, and related integrations.
    network-storage/SMB and WebDAV music sources.
    spine/Add-on module hosting and lifecycle.
    listen-together-server/Server component for Listen Together.

    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.

    Build locally

    Requirements

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

    Contributing

    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.

    Support

    Legal

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