Skip to content
alan7383Public

Repository files navigation

KittyTune - click to download

Android | Kotlin | Material Design | Jetpack Compose

Download KittyTune

[!] 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.


~ 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 recognition, audio effects, Discord Rich Presence, widgets, listening stats, achievements, and Android Auto support.

Home Screen Player Screen Synced Lyrics


* features

$ 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.

Music Import & Transfer Preview

~ 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.

Welcome & Guest Mode    Home Feed & Stations    Shazam Track Recognition

> 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.

Expressive Player    Synced Lyrics    Lyrics 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.

Audio Effects & Normalization

% 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.

Profile & Conversations

@ 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.

Pure Black AMOLED Theme    App Icon Selector    App Settings

$ 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
Loading

> install

Download the latest APK from the download page or 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 & C++ (NDK)
  • Jetpack Compose
  • Media3 / ExoPlayer
  • Room
  • NewPipe Extractor
  • InnerTune / Innertube
  • LrcLib
  • Kizzy
  • ShazamKit

☕ support

If you enjoy using KittyTune and want to support its ongoing development, consider buying me a coffee!

Buy Me a Coffee at ko-fi.com


^ contributors

thanks to everyone who helps make KittyTune better:

Contributors


~ credits & license

Big thanks to the open-source projects that help power KittyTune:

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


★ star history

Star History Chart


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

Releases

Packages

Contributors

Languages