Telegram Music Bot 🎵

🔥 Ultimate Telegram Voice Chat Music Bot with breathtaking streaming capabilities!
Powered by cutting-edge Pyrogram (Kurigram) and next-gen PyTgCalls for lightning-fast performance. Experience crystal-clear HD audio/video streaming with stunning UI and advanced features that will revolutionize your group voice chats! ⚡✨

✨ Features

• 🎧 Crystal Clear Audio/Video: Stream HD audio and video to Telegram Voice Chats seamlessly.
• ⏭️ Queue Management: Smart queue system, ability to view queue (/queue) and skip tracking.
• ⏯️ Playback Controls: Seek (/seek, /seekback), pause, resume, and skip media directly in the chat.
• ⚡ Lightning Fast: Uses PyTgCalls and Kurigram under the hood for low latency and high stability, taking full advantage of the uvloop magic.
• 🛡️ Advanced Permissions: Robust admin management including owner access, sudoers, authorized users list (/auth, /unauth), and blocklists (/block, /unblock).
• 🔄 Real-time Status: View active voice calls and current playing statuses across all groups (/ac).
• 🎨 Beautiful UI: Auto-generated dynamic images and stylized thumbnails for tracks along with stylish font support.

🚀 Recommended Deployment

Deploy to Heroku

Deploying to Heroku is the easiest way to get your bot running fast. Click the button below to deploy!

Local / VPS Deployment

If you prefer running the bot on your own server or a VPS locally:

1. Requirements

• Python 3.10+ (Recommended Python 3.13)
• ffmpeg installed on the system
• MongoDB (Database)

2. Get your credentials

You will need to fetch your variables and set them in your environment:

• API_ID & API_HASH from my.telegram.org

• BOT_TOKEN from @BotFather

• OWNER_ID: Your Telegram User ID.

• STRING_SESSION: A valid Pyrogram session string to act as the music assistant account.

• MONGODB_URI: Connectstring for MongoDB instance.

3. Clone & Run

git clone https://github.com/nub-coders/nub-music-bot.git
cd nub-music-bot
pip install -r requirements.txt
# Set environment variables from app.json
python3 main.py

🛠️ Stack / Technologies Used

• Language: Python
• Bot Framework: Pyrogram / Kurigram
• Calling Engine: PyTgCalls
• Database: MongoDB (motor, pymongo)
• Media Download/Extraction: yt-dlp, youtube-search-python, imageio, mutagen
• Image Processing: Pillow

Developed and crafted with ❤️ by Nub Coders