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 is distributed as a sideloadable APK rather than through the Google Play Store, which means you install it directly from a file rather than through a storefront. This page walks through both the standard one-tap install method and the adb install route for power users who prefer to verify the package before it touches their device.

Before You Begin

The pre-built release APK has the following requirements. If your device does not meet them, see Building from Source to compile a compatible binary yourself.
RequirementValue
Android version8.0 (API 26) or higher
Architecturearm64-v8a (all modern Android phones)
APK version0.1.0
Package namecom.tamed.music
Not sure about your device’s architecture? Go to Settings → About Phone → Processor (label varies by manufacturer). Any flagship or mid-range phone released after 2017 uses arm64-v8a.

Option 1: Direct APK Download

1

Download the APK

Open your Android browser and navigate to the release URL, or tap the link below:
https://github.com/calmerism/Tamed/releases/download/0.1.0/Tamed.apk
Your browser will prompt you to confirm the download. Tap Download and wait for the file to land in your Downloads folder.
2

Enable installation from unknown sources

Android blocks APK installs from outside the Play Store by default. You need to grant your browser (or file manager) permission to install apps.
  1. Go to Settings → Apps & notifications → Special app access → Install unknown apps.
  2. Tap your browser (e.g. Chrome).
  3. Toggle Allow from this source on.
Remember to turn this permission back off after installation if you want to prevent other apps from silently sideloading software in the future.
3

Open and install the APK

From your notification shade or the Downloads folder, tap Tamed.apk. Review the permissions summary Android presents, then tap Install. The process takes a few seconds.
4

Launch Tamed

Tap Open on the install confirmation screen, or find Tamed in your app drawer. On first launch, Android will ask for storage permissions — grant them so Tamed can scan your local music library.

Option 2: ADB Install (Command Line)

If you prefer to install over USB from a desktop machine, adb install gives you a direct, browser-free path that also works well for automation and device fleets.
1

Enable USB debugging on your phone

Go to Settings → About Phone and tap Build number seven times to unlock Developer Options. Then navigate to Settings → Developer options and enable USB debugging.
2

Connect your device and verify ADB sees it

Plug your phone into your computer with a USB data cable, accept the Allow USB debugging dialog on the phone, then run:
adb devices
You should see your device’s serial number with the status device. If it shows unauthorized, re-accept the dialog on your phone.
3

Download the APK to your computer

curl -L -o Tamed.apk \
  https://github.com/calmerism/Tamed/releases/download/0.1.0/Tamed.apk
4

Install via ADB

adb install Tamed.apk
A successful install prints Performing Streamed Install followed by Success. If you are upgrading a previous build, add the -r flag to replace the existing installation:
adb install -r Tamed.apk

First-Launch Permissions

When Tamed opens for the first time it will request the following permissions to function correctly:
PermissionPurpose
Read Media Audio (Android 13+) / Read External Storage (Android 8–12)Scanning local folders for music files
Post NotificationsBackground playback controls in the notification shade
Foreground Service / Media PlaybackKeeping the audio engine running with the screen off
If you accidentally deny storage access, go to Settings → Apps → Tamed → Permissions and grant storage manually. Tamed will not display your local library until this permission is active.

Architecture Note

The release APK at the link above is compiled exclusively for arm64-v8a. This matches virtually all modern Android smartphones and tablets, but it will not run on:
  • 32-bit armeabi-v7a devices (older phones)
  • x86 and x86_64 Android emulators
For those targets, the universal product flavor built from source bundles native libraries for armeabi-v7a, arm64-v8a, x86, and x86_64 in a single APK. See Building from Source for the exact Gradle command.

Build docs developers (and LLMs) love