https://github.com/teamauramusic/auramusic
YouTube Music client for Android
https://github.com/teamauramusic/auramusic
android foss gms innertube jetpack-compose kotlin kotlin-android material-design material-ui material3 music music-player-foss newpipe newpipe-extractor streamingapp youtube youtube-music-client ytmusic
Last synced: about 2 months ago
JSON representation
YouTube Music client for Android
- Host: GitHub
- URL: https://github.com/teamauramusic/auramusic
- Owner: TeamAuraMusic
- License: gpl-3.0
- Created: 2026-03-05T09:37:03.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-21T21:31:15.000Z (3 months ago)
- Last Synced: 2026-04-21T21:41:50.890Z (3 months ago)
- Topics: android, foss, gms, innertube, jetpack-compose, kotlin, kotlin-android, material-design, material-ui, material3, music, music-player-foss, newpipe, newpipe-extractor, streamingapp, youtube, youtube-music-client, ytmusic
- Language: Kotlin
- Homepage: https://www.auramusic.site/
- Size: 3.91 MB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
AuraMusic
A modern Android music player with YouTube Music integration, powerful audio features, Google Cast support, voice control, and a beautiful Material 3 interface. Works seamlessly on **Android phones, Android TV, and Google TV**.
Screenshots
Release numbers
[](https://github.com/TeamAuraMusic/AuraMusic/releases)
[](https://github.com/TeamAuraMusic/AuraMusic/blob/main/LICENSE)
[](https://github.com/TeamAuraMusic/AuraMusic/releases)
[](https://hosted.weblate.org/engage/auramusic/)
We use Weblate to translate AuraMusic. Help us bring AuraMusic to more people!
Thank you for helping translate AuraMusic!
Join our community
Download Now
Table of Contents
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Requirements](#requirements)
- [Quick Start](#quick-start)
- [Build Variants](#build-variants)
- [Support Me](#support-me)
- [Special Thanks](#special-thanks)
Features
### Playback & Streaming
- Play any song or video from YouTube Music
- Background playback
- Download and cache songs for offline playback
- Search for songs, albums, artists, videos and playlists
- YouTube Music account login support
- Syncing of songs, artists, albums and playlists from and to your account
### Audio Features
- Equalizer with custom presets
- Audio normalization
- Skip silence
- Adjust tempo/pitch
- Sleep timer
- VOSK wake word detection for hands-free voice control
### Voice Control
- Hands-free voice commands (say "Hey Aura" to activate)
- AEC and noise suppression for accurate detection
- Voice feedback with TTS
- Control playback, volume, and search with your voice
### Casting & Sharing
- **Google Cast support** (Chromecast to TV, speakers, Android TV)
- **Native Android TV / Google TV** app with D-pad navigation
- Listen together with friends in real-time
- Discord Rich Presence
### Lyrics
- Live synchronized lyrics
- Multiple sources: Kugou, LRCLib, RushLyrics, BetterLyrics
- Word-by-word highlighting
### Library & Organization
- Personalized quick picks
- Library management
- Local playlist management
- Import playlists
- Reorder songs in playlist or queue
### UI & Themes
- Material 3 design
- Light - Dark - Black - Dynamic theme
- Home screen widget with playback controls
### Integration
- Shazam music recognition
- Last.fm scrobbling
Tech Stack
- **Language:** Kotlin
- **UI:** Jetpack Compose + Material 3
- **Audio:** Media3 ExoPlayer
- **Voice:** VOSK offline speech recognition
- **DI:** Hilt
- **Database:** Room
- **Networking:** Ktor
- **Image Loading:** Coil
- **Casting:** Google Cast Framework
Requirements
- Android 8.0+ (API 26) for phone
- Android 9.0+ (API 28) for Android TV / Google TV
- Android Studio Ladybug
- JDK 21
Quick Start
```bash
# Clone the repository
git clone https://github.com/TeamAuraMusic/AuraMusic.git
cd AuraMusic
# Setup API keys (optional)
cp local.properties.example local.properties
# Build for phone
git checkout main
./gradlew assembleDebug
# Build for TV (Android TV / Google TV)
./gradlew assembleFossTvDebug
```
Build Variants
| Variant | Description |
|---------|-------------|
| `foss` | F-Droid compatible, no Google Play Services |
| `gms` | With Google Cast support, voice features |
**ABI Variants:** universal, arm64, armeabi, x86, x86_64
**TV Build:** The `tv` flavor provides a native Android TV / Google TV experience with D-pad optimized navigation.
**Example commands:**
```bash
# Phone universal builds
./gradlew assembleFossUniversalRelease
./gradlew assembleGmsUniversalRelease
# TV universal builds
./gradlew assembleFossTvUniversalRelease
./gradlew assembleGmsTvUniversalRelease
```
Support Me
If you'd like to support my work, you can donate via PayPal or Liberapay:
Special Thanks
**InnerTune**
[Zion Huang](https://github.com/z-huang) • [Malopieds](https://github.com/Malopieds)
**OuterTune**
[Davide Garberi](https://github.com/DD3Boh) • [Michael Zh](https://github.com/mikooomich)
**Metrolist**
[MetrolistGroup](https://github.com/MetrolistGroup/Metrolist) – Original project this is based on
**Contributors**
**Credits:**
- [**Kizzy**](https://github.com/dead8309/Kizzy) – Discord Rich Presence implementation
- [**RushLyrics**](https://github.com/shub39/Rush) – Additional lyrics data
- [**Better Lyrics**](https://better-lyrics.boidu.dev) – Time-synced lyrics with word-by-word highlighting
- [**SimpMusic Lyrics**](https://github.com/maxrave-dev/SimpMusic) – Lyrics data via SimpMusic API
- [**AuraMusicServer**](https://github.com/TeamAuraMusic/AuraMusicServer) – Listen together implementation
- [**MusicRecognizer**](https://github.com/aleksey-saenko/MusicRecognizer) – Music recognition and Shazam API
- [**Flow**](https://github.com/A-EDev/Flow) - Extract videos from YouTube
- [**Vosk**](https://github.com/alphacep/vosk-api) - Offline wake word recognition
- [**Monochrome**](https://github.com/monochrome-music/monochrome) - Monochrome-inspired animated background and lyrics style
The open-source community for tools, libraries, and APIs that make this project possible.
Thank you to all the amazing developers who made this project possible!
License
GNU General Public License v3.0 (GPL-3.0) - see [LICENSE](LICENSE) file
Disclaimer
This project and its contents are not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC or any of its affiliates and subsidiaries.
Any trademark, service mark, trade name, or other intellectual property rights used in this project are owned by the respective owners.
**Made with ❤️ by [chila254](https://github.com/chila254)**
