BeatWave

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

---

Overview

BeatWave 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
• Screenshots
• Features
• Installation & Setup
• Translations
• Community & Support
• Support the Project
• Contributors
• Special Thanks

---

Screenshots

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

---

Features

What's New

• Lossless Music Hub — Stream and contribute 16-bit/24-bit FLAC files directly to the BeatWave 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 & BeatWave Find

• BeatWave Find — Identify songs playing around you using advanced audio recognition.
• Ai Hub — An intelligent, on-device engine that analyzes your listening momentum and auto-injects perfectly aligned tracks into your queue.
• 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.

Building from Source

1. Clone the Repository

   git clone https://github.com/beatlabs790/beatwave.git
   cd beatwave

2. Configure Android SDK Create a local.properties file:

   beatwave "sdk.dir=/path/to/your/android/sdk" > local.properties

   (For detailed paths on Windows/macOS/Linux, refer to SETUP.md)

3. Firebase Configuration (Optional) Firebase is required for analytics and crash reporting. See the instructions in SETUP.md for adding your google-services.json.

4. Build the Application beatwave Music has two build variants: FOSS (without Google Play Services / Cast) and GMS (with Cast support).

   • To build the FOSS Universal Debug variant:

     ./gradlew assembleUniversalFossDebug

   • To build the GMS Universal Debug variant:

     ./gradlew assembleUniversalGmsDebug

   (For optimized ARM64 builds, release builds, or other options, refer to SETUP.md)

---

Community & Support

Join the community for updates, discussions, and help.

---

Support the Project

If BeatWave has been useful to you, consider supporting its development.

---

Special Thanks

BeatWave stands on the shoulders of several excellent open-source projects. Sincere thanks to:

Project	Description
Metrolist & Vivi Music	Foundational inspiration and architecture reference
ArchiveTune	Material You UI inspiration
Better Lyrics	Lyrics enhancement and synchronization
SimpMusic	Lyrics implementation reference
Music Recognizer	Audio recognition (BeatWave Find)
Flow	AI queue generation engine (Ai Hub)
zemer-cipher	YouTube cipher deobfuscation and PoToken generation

---

Licensed under GPL-3.0