uamp README

The project's README from github.com/android/uamp. As one markdown file: README.md.

Warning This sample has been deprecated and is no longer being maintained.

To find other samples that may be of interest, see https://developer.android.com/samples.

Universal Android Music Player Sample

The goal of this sample is to show how to implement an audio media app that works across multiple form factors and provides a consistent user experience on Android phones, tablets, Android Auto, Android Wear, Android TV, Google Cast devices, and with the Google Assistant.

To get started with UAMP please read the full guide.

Screenshot showing UAMP's UI for browsing albums and songs Screenshot showing UAMP's UI for playing a song

Pre-requisites

Getting Started

This sample uses the Gradle build system. To build this project, use the "gradlew build" command or use "Import Project" in Android Studio.

Support

If you've found an error in this sample, please file an issue

Patches are encouraged and may be submitted by forking this project and submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.

Audio

Music provided by the Free Music Archive.

Recordings provided by the Ambisonic Sound Library.

License

Copyright 2025 Google Inc.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

uamp (android/uamp)

Searching Database…

13.2K ·GitHub
archived
What is this?UAMP — the Universal Android Music Player Sample — is Google's sample audio app for Android: a working music player meant to demonstrate how to implement an audio media app.
How do I get it up and running?Open the project in Android Studio via 'Import Project', or run 'gradlew build' from the command line — it uses the Gradle build system.
What do I need installed before I can open it?Android Studio 3.x is the only listed prerequisite; the Gradle build takes care of the rest.
Is it still actively maintained?No — the sample has been deprecated and archived, so treat it as reference material for how audio apps were built, not a starting point for a new player.
Do I need to already know Android development to follow it?Yes — it's written for Android developers. You'll be reading Kotlin source and a companion guide, so basic Android Studio familiarity is assumed.
Which devices and surfaces does it actually run on?Android only, but across form factors: phones, tablets, Android Auto, Android Wear, Android TV, Google Cast devices and the Google Assistant.
Can I reuse this code in my own app?Yes — Apache-2.0, a permissive license: you can reuse and modify the code, including commercially, keeping attribution.
What audio can I play in it out of the box?It ships with music from the Free Music Archive — 'Wake Up' by The Kyoto Connection — plus field recordings from the Ambisonic Sound Library by Watson Wu and Stephan Schutze, so there is content to play immediately.
Why did Google ship a full app instead of just documentation?A complete, buildable app demonstrates the plumbing end to end — playback, UI and the consistent experience across Auto, Wear, TV, Cast and the Assistant — and the README pairs it with a full written guide.
Is the code in Kotlin or Java?Kotlin-first: Kotlin is the repo's primary language, with some Java also present in the codebase.
The project is deprecated — does the README say where to go next?Yes — the warning at the top points to other Google samples that may be of interest, and an FAQs page plus Stack Overflow are listed for support.
Creator
android
Size
9 MB
Stars
13.2K
Age
11y
Commits · 90 Days