🎵 AirBeats 亗

🚀 Advanced YouTube Music Client with Material Design 3

Experience Music Like Never Before on Android

---

✨ 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:

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