Echo Music

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

--- ## 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) - [Installation & Setup](#installation--setup) - [Translations](#translations) - [Community & Support](#community--support) - [Support the Project](#support-the-project) - [Contributors](#contributors) - [Special Thanks](#special-thanks) --- ## Screenshots

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

--- ## Features ### What's New > - **Lossless Music Hub** — Stream and contribute 16-bit/24-bit FLAC files directly to the Echo Music ecosystem. > - **Data Saver Mode (Beta)** — Automatically reduces data usage during playback for limited connections. > - **Settings Search Index** — Quickly find and navigate to any settings option instantly. > - **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. - **Lossless Audio** — Support for 16-bit and 24-bit high fidelity FLAC audio. - **Data Saver Mode** — Reduce data consumption when streaming on cellular networks. - **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!

--- ## 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 Options

--- ## Contributors A huge thank you to everyone who has helped improve Echo Music! Whether you've fixed bugs, added new features, or updated translations, your contributions are greatly appreciated.

--- ## 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](https://github.com/ZemerTeam/zemer-cipher)** | YouTube cipher deobfuscation and PoToken generation | ---

Licensed under GPL-3.0