Skip to content

KIRU-OP/VIP-MUSIC

Repository files navigation

🎵 VIP MUSIC BOT

A powerful, feature‑rich Telegram Music Bot for voice chats with support for YouTube, Spotify, Resso, Apple Music, and SoundCloud, built for performance, scalability, and easy deployment.


🚀 Overview

VIP MUSIC BOT lets you play high‑quality music in Telegram group & channel voice chats with advanced controls, analytics, and multi‑platform support. It is written in Python using Pyrogram and Py‑TgCalls, and supports both Heroku and VPS deployments.


🎯 Features

  • 🎬 YouTube, Spotify, Resso, Apple Music & SoundCloud support
  • 🐍 Written in Python (Pyrogram v2 + Py‑TgCalls)
  • ☁️ Heroku & 🖥 VPS deployment support
  • 📢 Channel & group voice chat playback
  • 🔎 Inline search support
  • 🖼 YouTube thumbnail search
  • ♾ Unlimited queue system
  • 📣 Broadcast messaging
  • 📊 Detailed stats & user analytics
  • 🚫 Block / Unblock user management
  • 🌐 Multi‑language support
  • 🎶 Playlist management

⚡️ Quick Setup

☁️ Heroku Deployment

**Deploy on Heroku**


🖥 VPS Deployment

# Clone the repository
git clone https://github.com/KIRU-OP/VIP-MUSIC && cd VIP-MUSIC

# Run setup script
bash setup
# Configure environment variables
nano .env
# Save with CTRL + X → Y → Enter
# Install tmux
sudo apt update && sudo apt install tmux -y

# Start tmux session
tmux

# Run the bot
bash start

🔹 Exit tmux session (bot keeps running): Ctrl + B → D


⚙️ Configuration Variables

🔴 Required Variables

  • API_ID – Telegram API ID (from my.telegram.org)
  • API_HASH – Telegram API Hash
  • BOT_TOKEN – Bot token from @BotFather
  • MONGO_DB_URI – MongoDB database URL
  • LOG_GROUP_ID – Telegram group ID for logs
  • OWNER_ID – Your Telegram user ID
  • STRING_SESSION – Pyrogram v2 string session

🟢 Optional Variables

  • SPOTIFY_CLIENT_ID – Spotify developer client ID
  • SPOTIFY_CLIENT_SECRET – Spotify developer client secret
  • HEROKU_API_KEY – Heroku API key
  • HEROKU_APP_NAME – Heroku app name

📘 Full variable list


⚠️ Make sure the API is enabled for your project, otherwise YouTube search will not work.


🤝 Support & Community


📃 License

This project is licensed under the MIT License


🙋‍♂️ Credits

  • 👑 ** KIRU ** – Project Owner & Developer

🙏 Special Thanks

A heartfelt thanks to VIP MUSIC ❤️

This project is inspired by YukkiMusicBot and customized with additional features, optimizations, and Google Cloud YouTube API integration.


Made with ❤️ for Telegram Music Lovers

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages