Skip to content

A scalable Telegram music bot built with Py-TgCalls v2.x and modern Python, focused on reliability, performance, and clean architecture. Powered by NexGenBots API.

Notifications You must be signed in to change notification settings

CyberPixelPro/AviaxMusic

Repository files navigation

🎵 Aviax Music Bot 🎵

Aviax Music Logo

GitHub stars GitHub forks GitHub issues GitHub license

Delivering Superior Music Experience to Telegram


🛠 Fix for YouTube Blocking VPS IPs

YouTube blocks many VPS IPs. We now provide two ways to keep playback smooth:

  1. API (Recommended):
    Stream audio & video via our API with built-in vPlay support. No cookie hassle.

  2. Custom Cookies (Fallback / No-API mode):
    Generate cookies on your local machine and place them in the cookies/ folder to bypass YouTube restrictions.


🎵 Using the API for Audio & Video (vPlay)

The API now supports both audio and video.
Use API for reliability; switch to custom cookies if you prefer not to rely on the API.


🔑 Get an API Key

Manage keys from our official dashboard (no Telegram DMs needed):

API Dashboard
API Community
Contact Rahul


🛠️ Steps to Get Started

  1. Sign up at console.nexgenbots.xyz and create an account.
  2. Generate Key: After logging in, click “Generate Key” on the dashboard to activate the Free Plan.
  3. Upgrade anytime via the dashboard for higher limits.

📦 Plans & Pricing (₹/month)

Plan Daily API Requests Daily Video Requests Price
Free 5,000 250 ₹0
Starter 10,000 500 ₹01
Standard 15,000 750 ₹02
Pro 25,000 1,000 ₹03
Business 50,000 2,000 ₹04
Enterprise 100,000 4,000 ₹05
Ultra 150,000 5,000 ₹06

📌 Important Notes About API Usage

  • 🔄 Daily Reset: All limits reset at midnight (IST).
  • 🎧🎬 Audio + Video: Fully supported via API (vPlay).
  • 🍪 Fallback: Add local custom cookies if you prefer not to use the API (works for both audio & video).
  • 💬 Support: Join the API Community Group.

⚙️ Integration

Add your API key to .env:

API_KEY=your-api-key-here


🌟 Features

  • 🎵 Multiple Sources: Play music from various platforms.
  • 📃 Queue System: Line up your favorite songs.
  • 🔀 Advanced Controls: Shuffle, repeat, and more.
  • 🎛 Customizable Settings: From equalizer to normalization.
  • 📢 Crystal Clear Audio: High-quality playback.
  • 🎚 Volume Mastery: Adjust to your preferred loudness.

🚀 Deploy on Heroku

Deploy


🔧 Quick Setup

  1. Upgrade & Update:

    sudo apt-get update && sudo apt-get upgrade -y
  2. Install Required Packages:

    sudo apt-get install python3-pip ffmpeg -y
  3. Setting up PIP

    sudo pip3 install -U pip
  4. Clone the Repository

    git clone https://github.com/CyberPixelPro/AviaxMusic && cd AviaxMusic
  5. Install Requirements

    pip3 install -U -r requirements.txt
  6. Create .env with sample.env

    cp sample.env .env
    • Edit .env with your vars
  7. Editing Vars:

    vi .env
    • Edit .env with your values.
    • Press I button on keyboard to start editing.
    • Press Ctrl + C once you are done with editing vars and type :wq to save .env or :qa to exit editing.
  8. Installing tmux

    sudo apt install tmux -y && tmux
  9. Run the Bot

    bash start

🛠 Commands & Usage

The Aviax Music Bot offers a range of commands to enhance your music listening experience on Telegram:

Command Description
/play <song name> Play the requested song.
/pause Pause the currently playing song.
/resume Resume the paused song.
/skip Move to the next song in the queue.
/stop Stop the bot and clear the queue.
/queue Display the list of songs in the queue.

For a full list of commands, use /help in telegram.


🔄 Updates & Support

Stay updated with the latest features and improvements to Aviax Music Bot:


🤝 Contributing

We welcome contributions to the Aviax Music Bot project. If you'd like to contribute, please follow these steps:

  1. Fork the repository.
  2. Create a new branch with a meaningful name.
  3. Make your changes and commit them with a descriptive commit message.
  4. Open a pull request against our master branch.
  5. Our team will review your changes and provide feedback.

For more details, reach out us on telegram.


📜 License

This project is licensed under the MIT License. For more details, see the LICENSE file.


🙏 Acknowledgements

Thanks to all the contributors, supporters, and users of the Aviax Music Bot. Your feedback and support keep us going!

  • Yukki Music & AnonX Music – Base inspiration
  • All contributors & community members

⭐ If you like this project, don’t forget to star the repo!

About

A scalable Telegram music bot built with Py-TgCalls v2.x and modern Python, focused on reliability, performance, and clean architecture. Powered by NexGenBots API.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages