[!] KittyTune is in active beta - some features may be incomplete. Found a bug? Feel free to open an issue!
[>] Looking for desktop? KittyTune is also available for Windows, Linux, and macOS on KittyTuneDesktop.
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 recognition, audio effects, Discord Rich Presence, widgets, listening stats, achievements, and Android Auto support.
$ music import & transfer
- Import your music & playlists from 7 major platforms (Spotify, Apple Music, YouTube Music, Deezer, Tidal, Amazon Music, BoomPlay) straight into your SoundCloud account.
- Powered by the native SoundCloud mobile GraphQL API, analyzed and integrated directly for account sync and progress tracking.
~ 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.
- Verified search filter compares title, artist, cover art, and duration with Deezer, Tidal, Qobuz, and Spotify so re-uploads and mislabelled copies stay out of the way.
- Track recognition built right in via ShazamKit to identify songs playing around you and find them instantly.
- 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.
- Live lyrics translation to quickly understand songs in your native language.
- 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.
- True loudness normalization (EBU R128) processed natively in C++ for perfectly matched volume across all your tracks.
- 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 utilizing the latest Material 3 Expressive shapes.
- 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, German, Hungarian, Russian, and Vietnamese.
- Built-in GitHub release update checker.
- Redesigned about screen with Ko-fi support card to easily tip if you like the app.
$ deep dive: volume normalization
I wanted to make sure you don't get your ears blasted when an aggressively mastered rap track plays right after a quiet acoustic one. So I fully implemented EBU R128 loudness normalization right into the audio pipeline.
Instead of just checking the "peak" volume of a song (which honestly doesn't mean much for how loud a song feels to human ears), the EBU R128 standard measures the perceived loudness in LUFS (Loudness Units relative to Full Scale). KittyTune measures this and targets a standard loudness level, smoothly applying gain so every song feels consistently loud.
why c++?
Audio DSP (Digital Signal Processing) requires manipulating tens of thousands of audio samples per second in real-time. If we did this in Kotlin/Java, it would create way too much garbage collection (GC) overhead and CPU usage, which drains your battery faster and can cause audio stuttering.
By writing this core processor in C++ using the Android NDK, we get direct memory access and blazing fast performance. We grab the raw PCM audio buffers from ExoPlayer via JNI, normalize them instantly, and hand them back with virtually zero overhead.
flowchart TD
A[ExoPlayer Decoder] -->|16-bit PCM Audio| B(JNI Bridge)
subgraph C++ Native Audio Processor
B -->|Convert to float| C[EBU R128 Analyzer]
C -->|Short-Term LUFS & True Peak| D{Calculate Gain}
D -->|Target: -14 LUFS<br/>Check Peak Headroom| E[Smooth Linear Gain]
E --> F(Apply Gain to Sample)
F --> G[Look-ahead Peak Limiter]
G -->|Clamp & Convert to short| H(JNI Return)
end
H -->|Normalized 16-bit PCM| I[Android AudioTrack]
style C++ Native Audio Processor fill:#2d2d2d,stroke:#f5a623,stroke-width:2px,color:#fff
Download the latest APK from the download page or the releases page.
KittyTune targets Android 8.0+ (API 26+).
git clone https://github.com/alan7383/kittytune.git
cd kittytune
./gradlew assembleDebug- Kotlin & C++ (NDK)
- Jetpack Compose
- Media3 / ExoPlayer
- Room
- NewPipe Extractor
- InnerTune / Innertube
- LrcLib
- Kizzy
- ShazamKit
If you enjoy using KittyTune and want to support its ongoing development, consider buying me a coffee!
thanks to everyone who helps make KittyTune better:
Big thanks to the open-source projects that help power KittyTune:
-
Streaming & Playback:
- NewPipe Extractor - YouTube stream extraction and audio fallback
- InnerTune & ViMusic - Innertube client architecture & player components
- Metrolist & OuterTune - Multi-source playback & UI inspirations
-
Scrapers & Metadata:
- SpotifyScraper - Spotify entity parsing, URL normalization & scraping
- Spotify Canvas API - Spotify Canvas & metadata
-
Lyrics:
- LRCLIB - Synced lyrics provider
- Better Lyrics - Synced & translated lyrics service
- SimpMusic - Lyrics providers & integrations
-
Audio Recognition & DSP:
- SongRec / MusicRecognizer - Shazam audio fingerprinting & recognition
- libebur128 - EBU R128 loudness normalization
-
Integrations & UI:
- Kizzy RPC - Discord Rich Presence on Android
- smooth-corner-rect - Continuous smooth rounded corners for Compose
- AboutLibraries - In-app open-source license management
KittyTune is licensed under GNU GPL v3.0. See the LICENSE file for details.
made with (=`ω´=) and too many ideas by alan7383











