Home
Softono

VxMusic

Open source Kotlin
Website GitHub
17
Stars
0
Forks
3
Issues
1
Watchers
3 months
Last Commit
Mobile Development Music Streaming

 About VxMusic

Discover endless music with VxMusic! Personalized playlists, offline listening, high-quality audio & exclusive content. Download now! 🎶

Platforms

Web Self-hosted Android

Languages

Kotlin

Links

Website Source Code

Need Help Installing VxMusic?

We provide expert installation service for this software. Our team will install, configure, and secure VxMusic on your server. plans start at just $30.

Hire an Expert
Published by
abcgop
Visit View Profile

VxMusic

View on GitHub

VxMusic

A FOSS YouTube Music client for Android and Desktop with many features from Spotify, SponsorBlock, ReturnYouTubeDislike using Compose Multiplatform.

Android Kotlin Min SDK

About

VxMusic is a feature-rich music streaming application for Android and Desktop that provides seamless access to YouTube Music content. Built with Compose Multiplatform, it offers a beautiful Material 3 interface and powerful features for music lovers.

Based on SimpMusic by maxrave-dev.

Features

  • Play music from YouTube Music or YouTube for free, without ads and in the background
  • High quality up-to 256kbps stream for YouTube Music Premium users
  • Browsing Home, Charts, Podcast, Moods & Genre with YouTube Music data at high speed
  • Search everything on YouTube
  • Analyze your playing data, create custom playlists, and sync with YouTube Music
  • Spotify Canvas supported
  • Play 1080p video option with subtitle
  • AI song suggestions
  • Customize your playlist, synced with YouTube Music
  • Notifications from followed artists
  • Caching and offline playback support
  • Crossfade with DJ-style like Apple Music
  • Synced lyrics from multiple providers, LRCLIB, Spotify and YouTube Transcript - AI lyrics translation (BETA)
  • Personalize data and multi-YouTube-account support
  • Local "scrobble" like Last.fm
  • Supports SponsorBlock and Return YouTube Dislike
  • Sleep Timer
  • Android Auto with online content
  • Discord Rich Presence support
  • Desktop support (Windows, macOS, Linux)
  • And many more!

Tech Stack

  • Language: Kotlin
  • UI Framework: Compose Multiplatform (Jetpack Compose)
  • Architecture: Clean Architecture + MVVM
  • Dependency Injection: Koin
  • Networking: Ktor Client
  • Media Playback: Media3 (ExoPlayer) for Android, VLCJ for Desktop
  • Database: Room
  • Async: Coroutines & Flow
  • Build System: Gradle (Kotlin DSL)

Module Structure

  • androidApp/: Android-specific entry point
  • composeApp/: Shared Compose Multiplatform module (Android, Desktop, iOS)
  • core/: Core modules (common, data, domain, media, service)
  • crashlytics/: Crash reporting (Full version with Sentry)
  • crashlytics-empty/: FOSS version without tracking

Build Variants

Android

  • Full: With Sentry crash reporting
  • FOSS: No tracking, no proprietary dependencies

Desktop

  • Windows: .msi installer
  • macOS: .dmg (ARM and x86-64)
  • Linux: .AppImage

Building from Source

Prerequisites

  • Android Studio or IntelliJ IDEA
  • JDK 21
  • Android SDK 37

Build

# Clone the repository
git clone https://github.com/ABCGop/VxMusic.git
cd VxMusic

# Debug build (Android)
./gradlew assembleFullDebug

# Release build (Android)
./gradlew assembleFullRelease

# FOSS build (Android)
./gradlew assembleFossRelease

# Desktop
./gradlew :composeApp:run

Requirements

  • Minimum SDK: Android 8.0 (API 26)
  • Target SDK: Android 15 (API 36)
  • Compile SDK: Android 16 (API 37)

Acknowledgments

VxMusic is built upon the excellent SimpMusic project by maxrave-dev. We are grateful for their outstanding open-source contribution.

Other Credits

  • Media3 (ExoPlayer) - Media playback by Google
  • Jetpack Compose - Modern UI toolkit by Google
  • VLCJ - Desktop audio playback
  • Ktor - HTTP client
  • Koin - Dependency injection
  • SponsorBlock - Skip sponsors
  • ReturnYouTubeDislike - Vote information
  • LRCLIB - Lyrics provider

License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.