(ฅ^•⩊•^ฅ) ♪♫ continuous soundcloud vibes for your desktop ♫♪
A full desktop port of KittyTune Android for Linux, Windows, and macOS.
SoundCloud-first music streaming with full account & likes sync, YouTube fallback, zero ads, sync lyrics, crossfade, MPRIS, Discord RPC & end4 dotfiles integration.
/\_/\
( o.o ) kittytune desktop
> ^ < lightweight JVM music player for soundcloud + youtube
KittyTune Desktop is a complete, native desktop port of the KittyTune Android music app. Built from scratch with Kotlin 2.4.0, Compose Multiplatform (Skiko), and Material 3 Expressive, it brings the mobile experience straight to Linux, Windows, and macOS.
No heavy web wrappers or Electron bloat here. Just a fast, lightweight JVM client that streams high-quality audio directly from SoundCloud (with full account sync for likes, reposts, and playlists), falls back to YouTube when needed, renders live karaoke lyrics, shuffles full playlists without web lazy-load traps, and syncs seamlessly with your system colors.
~ audio streaming & soundcloud sync
- full soundcloud account sync: link your account to sync liked tracks, playlists, reposts, and history in real time.
- soundcloud-first audio engine: native SoundCloud playback with seamless YouTube audio fallback whenever a track is missing.
- audio crossfade: smooth transitions between songs with customizable crossfade duration (in seconds).
- high-fidelity playback: FFmpeg & JavaFX Media pipelines with buffer optimization and gapless audio support.
- true full-playlist shuffle: shuffles your entire library or playlist at once — no lazy-load limits or repeated tracks.
- search & discovery: instant search across tracks, artists, albums, and playlists with instant filters.
- history & stats: local playback history, play counts, and listening statistics persistence.
> synchronized lyrics & visualizer
- real-time synchronized lyrics: word-by-word and line-by-line karaoke tracking via LrcLib and KuGou scrapers.
- variable font tuning: customize font weight, width, slant, roundness, optical size, and grade for lyrics typography.
- immersive artwork colors: dynamic UI theme adaptation matching the current track's album cover art.
+ desktop integration & media controls
- linux MPRIS D-Bus integration: native media controls for Waybar, Quickshell, KDE, GNOME, and Linux desktop panels.
- windows & macOS media keys: system media key controls, overlay popups, and hardware hotkeys.
- discord rich presence (rpc): show off your currently playing music, artist, elapsed time, and album artwork on Discord.
- customizable global shortcuts: control playback, volume, and tracks anywhere on your desktop.
# end4 hyprland & material you system theme
- auto end4 dotfile detection: automatically senses if end4's Hyprland dotfiles are installed on your Linux system.
- exclusive end4 theme: unlocks the dedicated
end4 (Material You)palette under Settings -> Theme. - live matugen reloading: reads color tokens from
~/.local/state/quickshell/user/generated/colors.jsonand updates application colors in real time when wallpaper changes. - pure amoled mode: true
#000000pitch black background toggle for OLED displays.
KittyTune Desktop integrates natively with end4's Hyprland dotfiles.
Since both KittyTune Desktop and end4's illogical-impulse environment share Material 3 (Material You / Monet) design tokens, your music player stays in perfect visual sync with your system wallpaper.
exclusive end4 (Material You) color palette option.
Quickshell MPRIS media control panel integration.
home screen — user library, recommendations, and recent tracks.
synchronized karaoke lyrics with word-by-word tracking.
playlist view — track listings, duration, and batch playback.
| shortcut | action |
|---|---|
Spacebar |
play / pause toggle |
N / Shift + Right |
next track |
P / Shift + Left |
previous track |
L |
toggle like / favorite |
R |
toggle repeat mode |
S |
toggle shuffle mode |
Shift + Up |
increase volume |
Shift + Down |
decrease volume |
M |
mute / unmute audio |
Escape |
back / close modal |
pre-built binaries for linux, windows, and macos are available on the releases page.
sudo pacman -U kitty-tune-1.0.17-1-x86_64.pkg.tar.zstsudo apt install ./kitty-tune_1.0.17_amd64.debsudo dnf install ./kitty-tune-1.0.17-1.x86_64.rpmchmod +x KittyTune-1.0.17-x86_64.AppImage
./KittyTune-1.0.17-x86_64.AppImagegrab the windows installer (.msi), portable archive (.zip), or macos disk image (.dmg).
- JDK 21 or higher
- Git
# clone repo & navigate
git clone https://github.com/alan7383/KittyTuneDesktop.git
cd KittyTuneDesktop
# run application
./gradlew run
# package binary for your OS
./gradlew packageDistributionForCurrentOSmost desktop music clients are heavy electron apps that gobble up gigabytes of RAM. KittyTune Desktop was created as a native, lightweight alternative that runs smoothly with low CPU and memory footprint, while providing features the official web player misses out on:
| feature | official soundcloud web | kittytune desktop |
|---|---|---|
| true full-playlist shuffle | no (limited by lazy loading) | yes (instant full shuffle) |
| offline music downloads | no (requires Go+ sub) | yes (free offline cache & local files) |
| ad-free experience | no (audio/video ads) | yes (100% ad-free) |
| synchronized karaoke lyrics | no | yes (LrcLib & KuGou word/line sync) |
| audio crossfade | no | yes (customizable transition duration) |
| youtube audio fallback | no (stream fails if unavailable) | yes (automatic fallback routing) |
| system-wide theme sync | no (fixed web UI) | yes (end-4 Hyprland / matugen live sync) |
| native linux MPRIS D-Bus | no | yes (full panel & waybar controls) |
| discord rich presence (rpc) | no (needs 3rd party extension) | yes (native discord status & cover art) |
- based on KittyTune for Android.
- material colors powered by end-4/dots-hyprland and
matugen. - built with Compose Multiplatform & MaterialKolor.
licensed under the MIT License.
made with ( ˘▽˘)っ♨ and a bit of chaos by alan7383 (´･ω･`)