https://github.com/nub-coders/nub-music-bot
A Telegram voice chat music bot with HD audio/video streaming, queue management, and playback controls — built with Pyrogram and PyTgCalls.
https://github.com/nub-coders/nub-music-bot
audio music-bot pyrogram pytgcalls python streaming telegram telegram-bot video voice-chat
Last synced: 5 days ago
JSON representation
A Telegram voice chat music bot with HD audio/video streaming, queue management, and playback controls — built with Pyrogram and PyTgCalls.
- Host: GitHub
- URL: https://github.com/nub-coders/nub-music-bot
- Owner: nub-coders
- License: mit
- Created: 2025-04-30T12:20:57.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-14T17:36:18.000Z (17 days ago)
- Last Synced: 2026-06-14T19:14:26.988Z (17 days ago)
- Topics: audio, music-bot, pyrogram, pytgcalls, python, streaming, telegram, telegram-bot, video, voice-chat
- Language: Python
- Size: 9.76 MB
- Stars: 3
- Watchers: 2
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nub-music-bot
Telegram music/voice-chat bot for streaming audio (and video) into group voice chats.
Summary
-------
Lightweight, extensible Python bot built on `Pyrogram` and `pytgcalls` to stream media into Telegram voice chats. This repo contains the bot code, plugins, and utilities used to download, queue and stream media from YouTube and other sources.
Quick features
--------------
- Queue and playback controls (seek, pause, resume, skip)
- Admin/sudo/owner controls and simple permission management
- Auto-generated thumbnails and status messages
- Support for YouTube downloads via `yt-dlp`
Requirements
------------
- Python 3.10+
- `ffmpeg` installed on the host
- MongoDB (or a compatible MongoDB URI)
Configuration (environment variables)
-------------------------------------
The bot reads configuration from environment variables. Key names used by the project (see `config.py`) are:
- `API_ID` (default in `config.py` shown for convenience)
- `API_HASH`
- `BOT_TOKEN`
- `STRING_SESSION`
- `OWNER_ID`
- `MONGODB_URI`
- Optional: `LOGGER_ID`, `DB_NAME`, `YOUTUBE_API_KEYS`, `YT_API_TOKEN`, `NUB_YT_API_BASE_URL`
Quickstart (local or VPS)
-------------------------
1. Clone the repo:
```bash
git clone https://github.com/nub-coders/nub-music-bot.git
cd nub-music-bot
```
2. Install dependencies:
```bash
python3 -m pip install -r requirements.txt
```
3. Provide environment variables (example using a `.env` file or export commands). At a minimum set `BOT_TOKEN` and either `STRING_SESSION` or Pyrogram credentials.
4. Run the bot:
```bash
python3 main.py
```
Deploy
------
[](https://heroku.com/deploy?template=https://github.com/nub-coders/nub-music-bot)
[](https://app.nubcoder.com/deploy?template=https://github.com/nub-coders/nub-music-bot)
- A `Procfile` and `app.json` are included for easy Heroku deployment (see repository root).
Contributing
------------
Contributions are welcome. Open issues or PRs with clear descriptions and tests where appropriate.
License
-------
This project is licensed under the MIT License - see the `LICENSE` file for details.
Credits
-------
Developed by the 
Nub Coders community.
For detailed configuration, inspect `config.py` and `app.json` in the project root.