Tamed is an open-source Android music player that treats audio fidelity and visual design as equals. Where most players compromise one for the other, Tamed delivers Apple Music-inspired animated ambient backdrops driven by real-time palette extraction, word-by-word synced lyrics, and native lossless playback of formats like FLAC, DSD, and ALAC — all inside a Jetpack Compose interface that follows Material 3 guidelines throughout.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/calmerism/Tamed/llms.txt
Use this file to discover all available pages before exploring further.
Key Features
Ambient Visuals
Automatically extracts color profiles from album art and renders smooth, fluid radial gradient animations behind player controls. Every album gets a unique, dynamic backdrop.
Time-Synced Lyrics
Line-by-line and word-by-word scrolling lyrics using LRC and TTML formats. Plain lyrics are displayed clearly for tracks without timing metadata.
Audio Fidelity
Native lossless playback for FLAC, AIFF, WAV, ALAC, APE, WavPack, and DSD. Automatic parsing of embedded ID3, Vorbis, and MP4 tags from local files.
Standard Format Support
Full compatibility with M4A, AAC, MP3, OGG, OPUS, WMA, MKV, and AMR through AndroidX Media3 (ExoPlayer).
Dynamic Interface
Modern declarative UI built with Jetpack Compose and Material 3 guidelines, featuring smooth transitions, custom loading shimmers, and responsive layouts.
Tag Metadata
Automatic parsing of embedded ID3, Vorbis, and MP4 tags from local files, with color processing driven by the Android Palette library.
Supported Audio Formats
Tamed handles both lossless and standard compressed formats through AndroidX Media3 (ExoPlayer).| Category | Formats |
|---|---|
| Lossless | FLAC, AIFF, WAV, ALAC, APE, WavPack, DSD |
| Standard | M4A, AAC, MP3, OGG, OPUS, WMA, MKV, AMR |
Tech Stack
Tamed is built entirely with modern, first-party Android libraries and a clean architecture layered across UI, Domain, Data, and Service tiers.| Layer | Technology |
|---|---|
| UI | Jetpack Compose, Material 3 |
| Audio | AndroidX Media3 (ExoPlayer) with MediaSession |
| Dependency Injection | Hilt / Dagger |
| Image Loading | Coil 3 |
| Database | Room |
| Network | Ktor / OkHttp |
| Color Processing | Android Palette library |
System Requirements
Minimum Android Version
Android 8.0 (API Level 26) or higher. This covers virtually all Android devices from 2017 onwards.
Pre-Built APK Architecture
The pre-built release APK targets arm64-v8a — the architecture used by all modern Android phones. A universal build covering all ABIs is available from source.
If you are on an older 32-bit device (armeabi-v7a) or running an x86/x86_64 emulator, build the
universal flavor from source to get a compatible APK. See Building from Source for instructions.License
Tamed is free and open-source software released under the GNU General Public License v3.0 (GPL-3.0). You are free to use, study, modify, and distribute the software, provided that any derivative work is also released under the GPL-3.0. See theLICENSE file in the repository for the full license text.