Skip to content

Duy-Thanh/kittytune

 
 

Repository files navigation

KittyTune Logo

KittyTune (=^・ω・^=)

License Release Stars Android Badge

A SoundCloud-first Android player with guest mode, YouTube fallback, local files, offline downloads, lyrics, widgets, and a lot of real extras.


~ what is this

KittyTune is an open-source Android music player built around SoundCloud, with optional login, a real guest mode, and a YouTube search / stream fallback for tracks that are restricted, missing, or annoying to access normally.

It also pulls in the things a lot of music apps either skip or hide behind rough UX: offline downloads, local folder scanning, lyrics, audio effects, Discord Rich Presence, widgets, listening stats, achievements, and Android Auto support.


* features

~ discovery & sources
  • SoundCloud-first discovery with home feed, stream, charts, moods, genres, tags, albums, and radio/station flows.
  • Search tracks, artists, playlists, and albums from SoundCloud.
  • Switch search source to YouTube when you want direct video/audio results instead.
  • Paste SoundCloud or YouTube links directly into search and jump to the right track, playlist, profile, or station.
  • Guest mode works without connecting a SoundCloud account.
> library & offline
  • Keep liked tracks, liked playlists, saved artists, local playlists, and downloads in one library.
  • Download single tracks or full playlists for offline playback.
  • Choose a custom download location and keep tagged files with embedded artwork when possible.
  • Import local music folders and scan subfolders recursively.
  • Supports local audio formats including MP3, FLAC, WAV, M4A, AAC, OGG, WMA, OPUS, AMR, and MP4 audio.
  • Backup and restore playlists, favorites, history, stats, achievements, and app settings.
+ player & lyrics
  • Background playback with notification controls, media buttons, and persistent queue restore.
  • Autoplay radio, shuffle / repeat, stream quality selection, and precise speed control.
  • Sleep timer with custom duration, end-of-track mode, and optional progressive fade-out.
  • Synced or plain lyrics with fullscreen view, inline player mode, manual search, and copy support.
  • Local lyrics support for files that already contain embedded lyrics.
  • YouTube fallback for restricted SoundCloud tracks when enabled in settings.
# audio & widgets
  • Built-in audio effects: bass boost, 8D audio, muffled filter, reverb, rain overlay, and pitch/speed control.
  • Effects are processed directly in the playback pipeline with Media3 / ExoPlayer.
  • Configurable home widget with playback controls, like toggle, speed shortcuts, and effect toggles.
  • Mini player widget for quick controls.
  • Search widget to jump straight into app search.
% account, social & extras
  • When signed in, KittyTune can handle likes sync, reposts, comments, notifications, conversations, and profile access.
  • Edit your SoundCloud profile, including avatar and banner, from inside the app.
  • Discord Rich Presence integration with configurable status display.
  • Listening stats for top tracks, top artists, play history, and total listening time.
  • 47 achievements with XP, streak tracking, and optional popup notifications.
  • Android Auto media support.
@ ui & customization
  • Jetpack Compose + Material 3 interface.
  • Dynamic color / Material You, light mode, dark mode, and pure black mode.
  • Custom color palette controls and multiple player background styles.
  • Variable font controls for weight, width, slant, roundness, and more.
  • Translated resources for many locales, with explicit in-app language switching for French, English, and Hungarian.
  • Built-in GitHub release update checker.

> install

Download APK

Download the latest APK from the releases page.

KittyTune targets Android 8.0+ (API 26+).


+ build

git clone https://github.com/alan7383/kittytune.git
cd kittytune
./gradlew assembleDebug

* under the hood

  • Kotlin
  • Jetpack Compose
  • Media3 / ExoPlayer
  • Room
  • NewPipe Extractor
  • InnerTune / Innertube
  • LrcLib
  • Kizzy

~ credits & license

Big thanks to the projects that help power KittyTune:

KittyTune is licensed under GNU GPL v3.0. See the LICENSE file for details.


made with (=`ω´=) and too many ideas by alan7383

About

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Kotlin 86.2%
  • CSS 6.6%
  • Astro 3.6%
  • TypeScript 3.6%