✨ Highlights

• 🎵 Stream music in Telegram group voice chats.
• 🎬 Audio and video playback controls.
• 🎛️ Queue, pause, resume, skip, stop and loop controls.
• 👥 Assistant account support for voice-chat streaming.
• 🛡️ Admin and authorized-user controls.
• 🌐 Language strings and customizable bot settings.
• 🚀 Heroku, Docker and VPS deployment files included.

Features and commands can vary with the branch and configuration you deploy.

🧰 Tech Stack

| Component | Technology | |:--|:--| | Language | Python | | Telegram client | Pyrogram | | Voice chat | PyTgCalls | | Database | MongoDB | | Media processing | FFmpeg | | Deployment | Heroku / Docker / Linux VPS |

🚀 Deploy on Heroku

The repository includes app.json, Procfile, heroku.yml and Dockerfile for deployment. Review the configuration before deploying.

sudo apt-get update
sudo apt-get install -y git python3 python3-pip python3-venv ffmpeg

git clone https://github.com/WCGKING/BrandrdXMusic.git
cd BrandrdXMusic
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt

cp sample.env .env
nano .env

| Variable | Purpose | |:--|:--| | API_ID / API_HASH | Telegram API credentials from my.telegram.org | | BOT_TOKEN | Token from @BotFather | | MONGO_DB_URI | MongoDB connection URI | | LOGGER_ID | Logging chat ID | | STRING1 | Assistant session string |

Additional variables may be required by the current code and your selected streaming setup.

4. Start the bot

bash start

🎮 Basic Commands

| Command | Action | |:--|:--| | /play | Play a track | | /vplay | Play video | | /pause | Pause the stream | | /resume | Resume the stream | | /skip | Move to the next track | | /stop | Stop playback | | /queue | View queued tracks | | /loop | Configure repeat playback | | /reload | Refresh admin cache |

Command availability depends on the version you run and chat permissions.

📁 Project Layout

BrandrdXMusic/
├── BrandrdXMusic/      # Bot application and modules
├── strings/            # Language strings
├── config.py           # Configuration
├── sample.env          # Environment template
├── requirements.txt    # Python dependencies
├── Dockerfile          # Container build
├── app.json             # Heroku app template
├── Procfile             # Process definition
└── start                # Startup script

🤝 Contributing

Found a bug or have an improvement? Open an issue or submit a pull request. Please keep credentials and session strings out of commits and logs.

📜 License

Distributed under the GNU General Public License v3.0. Retain the license and required notices when redistributing modified versions.