A cross-platform extensible open-source music streaming platform.
Bring your own music metadata/playlist/audio-source with plugins created by community or by
yourself. A small step towards the decentralized music streaming era!
****
🌃 Features
- 🧩 Plugin powered, supports any platform or custom music service through plugins.
- 🗺️ Community driven plugins for popular platforms or create your own.
- ⬇️ Freely downloadable tracks with tagged metadata.
- 🖥️ 📱 Cross-platform support.
- 🪶 Small size & less data usage.
- 🕒 Time synced lyrics regardless of the plugin support.
- ✋ No telemetry, diagnostics or user data collection.
- 🚀 Native performance.
- 📖 Open source/libre software.
- 🔉 Playback control is done locally, not on the server.
⬇️ Download
Download Spotube from the Official Website: https://spotube.cc
🔄 Nightly Builds
Grab the latest nightly builds of
Spotube from the Offical Website.
Spotube is a Compose Multiplatform app.
1. Prerequisites
-
JDK 21 to run Gradle (the Gradle daemon JDK and GraalVM are provisioned automatically).
-
Rust (rustup + cargo), for the composeApp library built
through Gobley.
-
Android SDK, only for Android builds.
-
ComposeNativeWebview, which isn't on
Maven Central yet. Clone it at the commit pinned as COMPOSE_WEBVIEW_COMMIT in
spotube-release-binary.yml and run
./gradlew publishToMavenLocal in it.
-
Linux only: runtime libraries, including VLC. Needed to run the app, including
:composeApp:run:
| Distro | Command |
|---|
| Debian/Ubuntu | sudo apt-get install libvlc5 vlc-plugin-base libwebkit2gtk-4.1-0 libgtk-3-0 libasound2 libgl1 libxtst6 libxi6 libxrender1 |
| Fedora | sudo dnf install vlc-libs webkit2gtk4.1 gtk3 alsa-lib mesa-libGL libXtst libXi libXrender (vlc-libs needs RPM Fusion) |
| Arch / CachyOS / Manjaro | sudo pacman -S vlc webkit2gtk-4.1 gtk3 alsa-lib libglvnd libxtst libxi libxrender |
| openSUSE | sudo zypper install libvlc5 libwebkit2gtk-4_1-0 libgtk-3-0 libasound2 Mesa-libGL1 libXtst6 libXi6 libXrender1 |
On Ubuntu 24.04+/Debian 13, libgtk-3-0 and libasound2 are libgtk-3-0t64 and libasound2t64;
apt resolves this itself.
2. Run in development
Desktop (JVM), fastest edit/run loop
./gradlew :composeApp:run
Android debug APK
./gradlew :composeApp:assembleStableDebug
Use ./gradlew :composeApp:assembleNightlyDebug for the nightly channel.
Development builds stay fast: the release-only optimizations below are skipped.
3. Build the desktop app
A native build takes about 10 minutes, uses every CPU core and peaks at ~15 GB of RAM.
It only happens for the tasks below, never for run.
Native toolchain (Nucleus downloads GraalVM CE on the first build; set GRAALVM_HOME to use
your own):
| OS | Requirements |
|---|
| Linux | gcc, zlib headers, patchelf; rpm for .rpm, fuse + zstd for .AppImage. Debian/Ubuntu: sudo apt-get install build-essential zlib1g-dev patchelf rpm fuse zstd. Fedora: sudo dnf install gcc zlib-devel patchelf rpm-build fuse zstd |
| macOS | Xcode Command Line Tools (xcode-select --install) |
| Windows | Visual Studio Build Tools with "Desktop development with C++" (use an "x64 Native Tools" prompt if native-image can't find MSVC) |
Build and run the app folder:
./gradlew :composeApp:createGraalvmNativeDistributable
Output folder: composeApp/build/compose/binaries/main/graalvm-app/
Build and launch in one step
./gradlew :composeApp:runGraalvmNativeDistributable
Keep the spotube binary next to the libraries it was built with; it loads them from its own
folder.
Installers (each OS builds only its own):
This is the beginning of the README. Read the rest at the original. Read the full README ↗
