AviaxMusic
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.
Install / Use
/learn @CyberPixelPro/AviaxMusicREADME
🛠 Fix for YouTube Blocking VPS IPs
YouTube blocks many VPS IPs. We now provide two ways to keep playback smooth:
-
API (Recommended):
Stream audio & video via our API with built-in vPlay support. No cookie hassle. -
Custom Cookies (Fallback / No-API mode):
Generate cookies on your local machine and place them in thecookies/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):
🛠️ Steps to Get Started
- Sign up at console.nexgenbots.xyz and create an account.
- Generate Key: After logging in, click “Generate Key” on the dashboard to activate the Free Plan.
- 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
🔧 Quick Setup
-
Upgrade & Update:
sudo apt-get update && sudo apt-get upgrade -y -
Install Required Packages:
sudo apt-get install python3-pip ffmpeg -y -
Setting up PIP
sudo pip3 install -U pip -
Clone the Repository
git clone https://github.com/CyberPixelPro/AviaxMusic && cd AviaxMusic -
Install Requirements
pip3 install -U -r requirements.txt -
Create .env with sample.env
cp sample.env .env- Edit .env with your vars
-
Editing Vars:
vi .env- Edit .env with your values.
- Press
Ibutton on keyboard to start editing. - Press
Ctrl + Conce you are done with editing vars and type:wqto save .env or:qato exit editing.
-
Installing tmux
sudo apt install tmux -y && tmux -
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:
<p align="center"> <a href="https://telegram.me/NexGenBotsIndia"> <img src="https://img.shields.io/badge/Join-Support%20Group-blue?style=for-the-badge&logo=telegram"> </a> <a href="https://telegram.me/NexGenBots"> <img src="https://img.shields.io/badge/Join-Update%20Channel-blue?style=for-the-badge&logo=telegram"> </a> </p>🤝 Contributing
We welcome contributions to the Aviax Music Bot project. If you'd like to contribute, please follow these steps:
- Fork the repository.
- Create a new branch with a meaningful name.
- Make your changes and commit them with a descriptive commit message.
- Open a pull request against our
masterbranch. - 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!
Related Skills
node-connect
343.3kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
92.1kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
343.3kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
343.3kQQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。