-

+This is a Kotlin Multiplatform project targeting Android, iOS, Desktop (JVM).
-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!
+* [/composeApp](./composeApp/src) is for code that will be shared across your Compose Multiplatform applications.
+ It contains several subfolders:
+ - [commonMain](./composeApp/src/commonMain/kotlin) is for code that’s common for all targets.
+ - Other folders are for Kotlin code that will be compiled for only the platform indicated in the folder name.
+ For example, if you want to use Apple’s CoreCrypto for the iOS part of your Kotlin app,
+ the [iosMain](./composeApp/src/iosMain/kotlin) folder would be the right place for such calls.
+ Similarly, if you want to edit the Desktop (JVM) specific part, the [jvmMain](./composeApp/src/jvmMain/kotlin)
+ folder is the appropriate location.
-Btw it's not just another Electron app 😉
+* [/iosApp](./iosApp/iosApp) contains iOS applications. Even if you’re sharing your UI with Compose Multiplatform,
+ you need this entry point for your iOS app. This is also where you should add SwiftUI code for your project.
-

-

+### Build and Run Android Application
-

-

+To build and run the development version of the Android app, use the run configuration from the run widget
+in your IDE’s toolbar or build it directly from the terminal:
+- on macOS/Linux
+ ```shell
+ ./gradlew :composeApp:assembleDebug
+ ```
+- on Windows
+ ```shell
+ .\gradlew.bat :composeApp:assembleDebug
+ ```
-[](https://news.ycombinator.com/item?id=39066136)
+### Build and Run Desktop (JVM) Application
-

+To build and run the development version of the desktop app, use the run configuration from the run widget
+in your IDE’s toolbar or run it directly from the terminal:
+- on macOS/Linux
+ ```shell
+ ./gradlew :composeApp:run
+ ```
+- on Windows
+ ```shell
+ .\gradlew.bat :composeApp:run
+ ```
+
+### Build and Run iOS Application
+
+To build and run the development version of the iOS app, use the run configuration from the run widget
+in your IDE’s toolbar or open the [/iosApp](./iosApp) directory in Xcode and run it from there.
---
-
-
-
-
-
-
-## 🌃 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.
-
-## 📜 ⬇️ Installation guide
-
-New versions usually release every 3-4 months.
-
- | Platform |
- Package/Installation Method |
-
-
- | Windows |
-
-
-
-
- |
-
- | MacOS |
-
-
-
-
- |
-
-
- | Android |
-
-
-
-
-
-
-
-
- |
-
-
-
- | iOS |
-
-
-
-
-
-
- *iPA file only. Requires sideloading with AltStore or similar tools.
-
- |
-
-
- | Flatpak |
-
- flatpak install com.github.KRTirtho.Spotube
-
-
-
- |
-
-
- | AppImage |
- AppImage's lacking stability led to it's temporary removal. More information at https://github.com/KRTirtho/spotube/issues/1082 |
-
-
- | Debian/Ubuntu |
-
-
-
-
- Then run: sudo apt install ./Spotube-linux-x86_64.deb
- |
-
-
- | Arch/Manjaro |
-
- With pamac: sudo pamac install spotube-bin
- With yay: yay -Sy spotube-bin
- |
-
-
- | Fedora/OpenSuse |
-
-
-
-
- For Fedora: sudo dnf install ./Spotube-linux-x86_64.rpm
- For OpenSuse: sudo zypper in ./Spotube-linux-x86_64.rpm
- |
-
-
- | Linux (tarball) |
-
-
-
-
- |
-
-
- | Macos - Homebrew |
-
-
-brew tap krtirtho/apps
-brew install --cask spotube
-
- |
-
-
- | Windows - Chocolatey |
-
- choco install spotube
- |
-
-
- | Windows - Scoop |
-
- scoop bucket add extras
- scoop install spotube
- |
-
-
- | Windows - WinGet |
-
- winget install --id KRTirtho.Spotube
- |
-
-
-
-### 🔄 Nightly Builds
-
-Grab the latest nightly builds of Spotube [from the GitHub Releases](https://github.com/KRTirtho/spotube/releases/tag/nightly).
-
-## 🕳️ Building from source
-
-