Skip to content

CyberPixelPro/AviaxMusic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

162 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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 500 25 β‚Ή0
Basic 3,000 150 β‚Ή150
Starter 5,000 250 β‚Ή250
Standard 15,000 750 β‚Ή450
Pro 25,000 1,250 β‚Ή900
Business 50,000 2,500 β‚Ή1700
Enterprise 100,000 5,000 β‚Ή3200
Ultra 150,000 7,500 β‚Ή4500

πŸ“Œ 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

βœ”οΈ Prerequisites

  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. Install Deno:

    apt-get install unzip && curl -fsSL https://deno.land/install.sh | sh
  4. Setting up PIP

    sudo pip3 install -U pip
  5. Clone the Repository

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

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

    cp sample.env .env
    • Edit .env with your vars
  8. 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.
  9. Installing tmux

    sudo apt install tmux -y && tmux
  10. 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!

  • 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

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages