explaingit

android/uamp

13,192KotlinAudience · developerComplexity · 2/5Setup · easy

TLDR

A deprecated Google sample Android music player app in Kotlin showing how to build audio playback that works across phones, tablets, Android Auto, Wear OS, TV, and Cast from one codebase.

Mindmap

mindmap
  root((uamp))
    What it is
      Sample music app
      Google reference
      Deprecated project
    Device support
      Phones and tablets
      Android Auto
      Wear OS TV Cast
    Tech
      Kotlin Gradle
      Android Studio
      Media session API
    Audience
      Android developers
      Learning audio apps
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Study how a Google-authored Android app structured audio playback to support phones, cars, watches, and TV simultaneously.

USE CASE 2

Reference the UAMP codebase to understand Android media session and media browser service patterns.

USE CASE 3

Examine how Android Auto and Wear OS integration was wired into a single shared codebase.

Tech stack

KotlinAndroidGradleAndroid Studio

Getting it running

Difficulty · easy Time to first run · 30min

Project is deprecated and no longer maintained, treat it as a historical reference and check Google's developer samples page for current alternatives.

In plain English

UAMP stands for Universal Android Music Player, and it is a sample project published by Google to demonstrate how to build an audio app for Android. The project is now deprecated and no longer maintained, but its code remains available as a reference for developers learning how audio apps were structured on Android. The app was designed to work across many different types of Android devices at once: phones, tablets, Android Auto (the car interface), Android Wear (smartwatches), Android TV, and Google Cast devices. It also supported voice control through the Google Assistant. The idea was to show a single codebase that provides a consistent music playback experience no matter what screen or device the user is on. To build and run the project, you need Android Studio version 3 or later. The project uses Gradle, which is the standard build tool for Android apps. You can build it by running a single command or by opening the project directly in Android Studio. The sample includes real audio tracks for testing, sourced from the Free Music Archive and the Ambisonic Sound Library. These are royalty-free recordings used to give the app something to actually play during development and testing. Because it is deprecated, this project is best treated as a historical reference rather than a starting point for new work. Google's developer samples page lists newer, actively maintained examples for anyone looking to build an audio app today.

Copy-paste prompts

Prompt 1
Show me how UAMP handles audio focus and media session callbacks so playback pauses correctly when a phone call arrives.
Prompt 2
I am building an Android music app that needs to work on both phones and Android Auto. Which patterns from UAMP should I follow?
Prompt 3
Explain the Gradle module structure of UAMP and how it separates shared playback code from device-specific UI.
Prompt 4
UAMP is deprecated. What is Google's current recommended approach for building an Android audio app that works on Android Auto?
Open on GitHub → Explain another repo

← android on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.