Skip to main content

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.

Tamed gives you granular control over every pixel of its interface. From dynamic album-art theming and AMOLED black to seven distinct player layouts and eleven background styles, all visual settings are persisted in Android DataStore using typed preference keys. This page documents each key, its type, and what it controls.

​
Theme

Preference KeyDataStore KeyTypeDefaultDescription
DynamicThemeKeydynamicThemeBooleantrueDerives the app accent color from the currently playing track’s album art.
CustomThemeColorKeycustomThemeColorString—Hex color string used as the app accent when dynamic theme is disabled.
RandomThemeOnStartupKeyrandomThemeOnStartupBooleanfalsePicks a new random accent color each time the app launches.
DarkModeKeydarkModeString (DarkMode enum)AUTOControls dark/light mode. Valid values: ON, OFF, AUTO (follows system).
PureBlackKeypureBlackBooleanfalseForces true #000000 backgrounds — ideal for AMOLED displays to save battery.
Preference KeyDataStore KeyTypeDefaultDescription
UseSystemFontKeyuseSystemFontBooleanfalseUses the system-wide font instead of any in-app font selection.
SelectedFontKeyselected_fontString (AppFont enum value)systemSelects the typeface used throughout the app.
AppFont enum values
Enum ConstantDataStore Value
SYSTEMsystem
GOOGLE_SANSgoogle_sans
SANS_FLEXsans_flex
OUTFIToutfit
PLUS_JAKARTA_SANSplus_jakarta_sans
UseSystemFontKey takes precedence over SelectedFontKey. When system font is enabled, the SelectedFontKey value is ignored.

​
Player Design

Preference KeyDataStore KeyTypeDefaultDescription
PlayerDesignStyleKeyplayerDesignStyleString (PlayerDesignStyle enum)V1Selects the overall player screen layout.
PlayerButtonsStyleKeyplayer_buttons_styleString (PlayerButtonsStyle enum)DEFAULTControls the visual style of playback control buttons.
PlayerDesignStyle values
ValueNotes
V1Default layout
V2Alternate layout
V3Third layout variant
V4⚠️ Falls back to V3 at runtime
V5Fifth layout variant
V6Sixth layout variant
V7⚠️ Falls back to V3 at runtime
V4 and V7 are not fully supported. The app automatically replaces them with V3 via asSupportedPlayerDesignStyle(). The settings UI only exposes V1, V2, V3, and V6.
PlayerButtonsStyle values
ValueDescription
DEFAULTStandard button appearance
SECONDARYButtons rendered in the secondary color scheme
Preference KeyDataStore KeyTypeDefaultDescription
HidePlayerThumbnailKeyhidePlayerThumbnailBooleanfalseHides the album art thumbnail in the full player.
ThumbnailCornerRadiusKeythumbnailCornerRadiusFloat (dp)8.0Corner radius of the album art thumbnail in dp.
CropThumbnailToSquareKeycropThumbnailToSquareBooleanfalseCrops non-square album art to a 1:1 square before display.
Preference KeyDataStore KeyTypeDefaultDescription
SliderStyleKeysliderStyleString (SliderStyle enum)StandardVisual style of the seek/progress bar in the player.
SeekExtraSecondsseekExtraSecondsBooleanfalseShows additional ±10 s seek buttons alongside the main seek controls.
SliderStyle values: Standard, Wavy, Thick, Circular, Simple
Preference KeyDataStore KeyTypeDefaultDescription
SwipeToSongKeySwipeToSongBooleanfalseEnables horizontal swipe on the player to jump to the previous or next track.
SwipeThumbnailKeyswipeThumbnailBooleantrueEnables swipe gestures on the mini player thumbnail.
SwipeSensitivityKeyswipeSensitivityFloat (0–1)0.73How easily a swipe gesture is triggered; higher values require a larger drag distance.

​
Background Customization

Preference KeyDataStore KeyTypeDefaultDescription
PlayerBackgroundStyleKeyplayerBackgroundStyleString (PlayerBackgroundStyle enum)BACKDROPVisual treatment applied to the player background.
PlayerBackgroundStyle values
ValueUI NameDescription
DEFAULTFollow ThemeUses the Material You surface color
GRADIENTGradientSoft gradient derived from album art
CUSTOMCustomUser-supplied background image
BLURBlurBlurred album art (requires Android 12+)
COLORINGColoringAlbum-art color wash
BLUR_GRADIENTBlur + GradientCombination blur and gradient
GLOWGlowGlowing halo effect
GLOW_ANIMATEDGlow (Animated)Animated glowing halo
APPLE_MUSICCinematicCinematic full-bleed style
LIVE_MESHMeshAnimated mesh gradient
BACKDROPBackdropSemi-transparent backdrop image
BLUR is only available on Android 12 (API 31) and above. On earlier devices it will not appear in the UI.
These keys are active when PlayerBackgroundStyleKey is set to CUSTOM.
Preference KeyDataStore KeyTypeDefaultDescription
PlayerCustomImageUriKeyplayerCustomImageUriString (URI)—Content URI of the user-selected background image.
PlayerCustomBlurKeyplayerCustomBlurFloat—Blur intensity applied to the custom background image.
PlayerCustomContrastKeyplayerCustomContrastFloat—Contrast adjustment for the custom background image.
PlayerCustomBrightnessKeyplayerCustomBrightnessFloat—Brightness adjustment for the custom background image.
Preference KeyDataStore KeyTypeDefaultDescription
TamedCanvasKeytamedCanvasBooleanfalseEnables the animated Tamed Canvas backdrop — a generative animated visual layer behind the player.
DisableBlurKeydisableBlurBooleanfalseGlobally disables blur rendering to reduce GPU load on lower-end devices.
BlurRadiusKeyblurRadiusFloat (0–48)36.0Radius of the background blur effect in the player. Disabled when DisableBlurKey is true.

​
Home & Artist Screens

Preference KeyDataStore KeyTypeDefaultDescription
HomeBackgroundStyleKeyhomeBackgroundStyleString (HomeBackgroundStyle enum)BACKDROPBackground treatment for the Home screen.
ArtistBackgroundStyleKeyartistBackgroundStyleString (HomeBackgroundStyle enum)BACKDROPBackground treatment for Artist detail screens.
HomeBackgroundStyle values: DEFAULT, BACKDROP, LIVE_MESH
Preference KeyDataStore KeyTypeDefaultDescription
ShowArtistSubscriberCountKeyshowArtistSubscriberCountBoolean—Shows the artist’s YouTube subscriber count on their profile page.
ShowMonthlyListenersKeyshowMonthlyListenersBoolean—Shows monthly listener statistics on the artist page.
ShowArtistDescriptionKeyshowArtistDescriptionBoolean—Shows the artist biography text on their profile page.
ShowArtistBackgroundVideoKeyshowArtistBackgroundVideoBoolean—Plays the artist’s background video on their profile page when available.

​
Library Display

Preference KeyDataStore KeyTypeDefaultDescription
ShowHomeCategoryChipsKeyshowHomeCategoryChipsBooleantrueShows filter chips (e.g. “Songs”, “Artists”) at the top of the Home feed.
ShowTagsInLibraryKeyshowTagsInLibraryBooleantrueShows playlist tag chips in the Library view for quick filtering.
Preference KeyDataStore KeyTypeDefaultDescription
ShowLikedPlaylistKeyshow_liked_playlistBooleantrueDisplays the auto-generated “Liked Songs” playlist in the Library.
ShowDownloadedPlaylistKeyshow_downloaded_playlistBooleantrueDisplays the auto-generated “Downloaded” playlist in the Library.
ShowTopPlaylistKeyshow_top_playlistBooleantrueDisplays the auto-generated “My Top” playlist in the Library.
ShowCachedPlaylistKeyshow_cached_playlistBooleantrueDisplays the auto-generated “Cached” playlist in the Library.
All appearance preferences are stored in Android DataStore and take effect immediately without restarting the app.

Build docs developers (and LLMs) love

Get started for freeTalk to us