AirBeats

🚀 Advanced YouTube Music Client with Material Design 3

Experience Music Like Never Before on Android

---

💻 AirBeats Desktop

AirBeats isn't just for Android! You can enjoy the exact same seamless YouTube Music integration on Mac, Linux, and Windows.

Head over to our official desktop repository to get the desktop client: 👉 d0x-dev/airbeats-desktop

🐧 Linux Users

AirBeats Desktop is officially available on the Snap Store!

sudo snap install airbeats

---

✨ Features

• 🎵 Seamless YouTube Music Integration - Full access to your favorite tracks
• 🎨 Material Design 3 - Modern, elegant, and intuitive UI/UX
• 🎯 Advanced Playback Controls - Fine-tune your music experience
• 🔐 Secure & Privacy-Focused - Your data stays yours
• ⚡ Lightning Fast - Optimized performance and smooth animations
• 🌙 Dark Mode Support - Easy on the eyes, anytime
• 📱 Android 6.0+ - Works on a wide range of devices

---

🌐 Get Started

Link	Purpose
🌍 Official Website	Learn more about AirBeats
📥 Download APK	Get the latest version
🏪 Official Store	Alternative download source

---

👥 Meet the Talented Team

💻 Lead Developer & Founder

• 

Darkboy - Full-Stack Android Developer

• 🔗 GitHub
• 🌐 Website
• 📱 Telegram
• 📸 Instagram

🎨 UI/UX Specialist & Designer

• 

Venom - Creative Design Visionary

• 🔗 GitHub
• 🌐 Website
• 🎨 Portfolio

---

🛠️ Build from Source

Ready to build AirBeats yourself? Follow our comprehensive guide below.

Prerequisites

Requirement	Version
Java Development Kit (JDK)	21
Android Studio	Ladybug or newer
Git	Latest

🔑 Essential Configuration (Firebase & Google API)

Important

⚠️ The Firebase configuration file (google-services.json) and Google API Key are not included in the repository for security reasons. You must configure these manually to build the project successfully.

Step 1️⃣: Firebase Configuration (google-services.json)

1. Visit Firebase Console
2. Click Create a new project (or use existing)
3. Once created, click the Android icon
4. Register your app with these details:
   • Package name: com.darkxvenom.airbeats
   • App nickname: AirBeats
5. Click Register app
6. Download the google-services.json file
7. Move it to AirBeats/app/google-services.json

Step 2️⃣: Google API Key (local.properties)

1. Open local.properties in the project root
2. Add your Google API Key:

   google.api.key=YOUR_GOOGLE_API_KEY_HERE

🚀 Build Steps

# 1. Clone the repository
git clone https://github.com/d0x-dev/AirBeats.git

# 2. Navigate into the project
cd AirBeats

# 3. Clean build files
./gradlew clean

# 4. Build the Debug APK
./gradlew assembleDebug

# 5. Find your APK at:
# app/build/outputs/apk/debug/app-debug.apk

---

📦 Build Variants

# Build Release APK (requires signing key)
./gradlew assembleRelease

# Build and run on connected device
./gradlew installDebug

# Run tests
./gradlew test

---

📜 License

Copyright © 2025 Darkboy & Venom

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License.

---

🤝 Contributing

We'd love your contributions! Here's how:

🌍 Translate AirBeats

Help us translate AirBeats into your language! You don't need any coding experience to help. We use Crowdin to manage our translations.

1. Go to our Crowdin Project Page.
2. Create a free account.
3. Select your native language and start translating! All translations will be automatically synced to our GitHub repository.

💻 Code Contributions

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

💬 Support & Community

• 📧 Have questions? Open an Issue
• 🐛 Found a bug? Report it here
• 💡 Have a suggestion? We'd love to hear it!

---

Made with ❤️ by the AirBeats Team

⭐ If you love AirBeats, please consider giving us a star on GitHub! ⭐

⬆ Back to Top