Echo Music

A modern Android music app with ad-free streaming, synced lyrics, offline playback, and an intuitive user experience.

[![GitHub Release](https://img.shields.io/github/v/release/iad1tya/Echo-Music?style=for-the-badge&color=6f42c1)](https://github.com/iad1tya/Echo-Music/releases) [![GitHub Stars](https://img.shields.io/github/stars/iad1tya/Echo-Music?style=for-the-badge&color=e3b341)](https://github.com/iad1tya/Echo-Music/stargazers) [![License](https://img.shields.io/github/license/iad1tya/Echo-Music?style=for-the-badge&color=28a745)](LICENSE) [![Telegram](https://img.shields.io/badge/Telegram-Join-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/EchoMusicApp) [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/EcfV3AxH5c) [![Weblate](https://img.shields.io/weblate/progress/echo-music?server=https%3A%2F%2Fhosted.weblate.org&style=for-the-badge)](https://hosted.weblate.org/projects/echo-music/)

Download

Get it on Obtainium

--- ## Overview Echo Music delivers a seamless, premium listening experience by leveraging YouTube Music's vast library — without the ads. It adds powerful extras including offline downloads, real-time synchronized lyrics, and environment-aware music recognition. --- ## Table of Contents - [Overview](#overview) - [Screenshots](#screenshots) - [Features](#features) - [What's New](#whats-new) - [Streaming & Playback](#streaming--playback) - [Discovery & Echo Find](#discovery--echo-find) - [Lyrics](#lyrics) - [Integrations](#integrations) - [Smart Playback](#smart-playback) - [Customization](#customization) - [Installation & Setup](#installation--setup) - [Android Installation](#android-installation) - [Building from Source](#building-from-source) - [Translations](#translations) - [Community & Support](#community--support) - [Support the Project](#support-the-project) - [Cryptocurrency](#cryptocurrency) - [Special Thanks](#special-thanks) - [Star History](#star-history) --- ## Screenshots

Home Screen	Music Player	Synchronized Lyrics
Search & Explore	Music Library	Echo Find (Recognition)

--- ## Features ### What's New - **Redesigned UI** — Cleaner, faster, and more intuitive interface from the ground up. - **Import from Spotify** — Bring your playlists and tracks over with ease. - **Listen Together** — Sync music in real time, similar to Spotify Jam. - **Podcast Support** — Listen to podcasts alongside your music library. - **Local Media Support** — Play music files stored directly on your device. - **Dynamic Island Support** — Enhanced playback notifications on supported Android devices. ### Streaming & Playback - **Ad-Free** — Stream without any interruptions. - **Seamless Playback** — Switch effortlessly between audio-only and video modes. - **Background Playback** — Listen while using other apps or with the screen off. - **Offline Mode** — Download tracks, albums, and playlists via a dedicated download manager. - **Crossfade** — Smooth transitions between tracks. - **Canvas Animations** — Visual animations while playing music. ### Discovery & Echo Find - **Echo Find** — Identify songs playing around you using advanced audio recognition. - **Echo Brain** — An intelligent, on-device engine that analyzes your listening momentum and auto-injects perfectly aligned tracks into your queue. Read more in the [Echo Brain Documentation](ECHO_BRAIN_DOCS.md). - **Smart Recommendations** — Personalized suggestions based on your listening history. - **Comprehensive Browsing** — Explore Charts, Podcasts, Moods, and Genres. ### Lyrics - **Multiple Lyric Animations** — Choose from various lyric display styles. - **Word-by-Word Lyrics** — Precise per-word synchronization. - **Lyrics+** — New lyrics provider for improved accuracy and coverage. - **AI Translation** — Built-in Google Translate integration for lyrics in any language. ### Integrations - **Music Sharing via Odesli** — Share songs as Song.link for cross-platform listening. - **Set as Ringtone** — Directly set any song as your device ringtone. ### Smart Playback - **Pause on Mute** — Auto-pause when your device is muted. - **Resume on Bluetooth** — Playback resumes when headphones or earbuds reconnect. ### Customization - **UI Density Scale** — Adjust interface spacing to your preference. - **High Refresh Rate Support** — Smoother UI and animations on supported displays. - **Hide Player Thumbnail** — Keep the player minimal without album art. - **Crop Album Art** — Adjust album art display to fit your style. - **Hide Video Songs** — Filter out video content from your feed. - **Hide YouTube Shorts** — Keep Shorts out of your music browsing. --- ## Installation & Setup ### Android Installation Download the latest pre-compiled APK from the [Releases Page](https://github.com/iad1tya/Echo-Music/releases/latest). ### Building from Source 1. **Clone the Repository** ```bash git clone https://github.com/iad1tya/Echo-Music.git cd Echo-Music ``` 2. **Configure Android SDK** Create a `local.properties` file: ```bash echo "sdk.dir=/path/to/your/android/sdk" > local.properties ``` *(For detailed paths on Windows/macOS/Linux, refer to [SETUP.md](SETUP.md))* 3. **Firebase Configuration (Optional)** Firebase is required for analytics and crash reporting. See the instructions in [SETUP.md](SETUP.md#3-configure-firebase-optional) for adding your `google-services.json`. 4. **Build the Application** Echo Music has two build variants: **FOSS** (without Google Play Services / Cast) and **GMS** (with Cast support). To build the FOSS Universal Debug variant: ```bash ./gradlew assembleUniversalFossDebug ``` To build the GMS Universal Debug variant: ```bash ./gradlew assembleUniversalGmsDebug ``` *(For optimized ARM64 builds, release builds, or other options, refer to [SETUP.md](SETUP.md))* --- ## Translations

We use Weblate to translate Echo Music. Help us bring Echo Music to more people!

Translation status

--- ## Community & Support Join the community for updates, discussions, and help.

--- ## Support the Project If Echo Music has been useful to you, consider supporting its development.

### Cryptocurrency | Network | Address | | :--- | :--- | | Bitcoin | `bc1qcvyr7eekha8uytmffcvgzf4h7xy7shqzke35fy` | | Ethereum | `0x51bc91022E2dCef9974D5db2A0e22d57B360e700` | | Solana | `9wjca3EQnEiqzqgy7N5iqS1JGXJiknMQv6zHgL96t94S` | --- ## Special Thanks Echo Music stands on the shoulders of several excellent open-source projects. Sincere thanks to: | Project | Description | | :--- | :--- | | [Metrolist](https://github.com/MetrolistGroup/Metrolist) & [Vivi Music](https://github.com/vivizzz007/vivi-music) | Foundational inspiration and architecture reference | | [ArchiveTune](https://github.com/koiverse/ArchiveTune) | Material You UI inspiration | | [Better Lyrics](https://better-lyrics.boidu.dev/) | Lyrics enhancement and synchronization | | [SimpMusic](https://github.com/maxrave-dev/SimpMusic) | Lyrics implementation reference | | [Music Recognizer](https://github.com/aleksey-saenko/MusicRecognizer) | Audio recognition (Echo Find) | | [Flow](https://github.com/a-edev/Flow) | AI queue generation engine (Echo Brain) | | [zemer-cipher](hhttps://github.com/ZemerTeam/zemer-cipher) | YouTube cipher deobfuscation and PoToken generation | --- ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=EchoMusicApp/Echo-Music&type=timeline&legend=top-left)](https://www.star-history.com/#EchoMusicApp/Echo-Music&type=timeline&legend=top-left) ---

Licensed under GPL-3.0