⚡ A blazing-fast, reliable, and feature-packed Telegram bot for streaming music in group voice chats — built with Go.
- 🚀 High Performance: Optimized Go-based engine for ultra-low latency.
- 🎼 Smart Provider System: Supports YouTube, Telegram Files, and custom APIs.
- 🔄 Intelligent Fallback: Automatically switches sources if one fails.
- 🌍 Localization: Robust multi-language support (YAML-based).
- 🛠 Admin Suite: Speed control, seeking, looping, and advanced queueing.
# 1. Clone & Enter
git clone https://github.com/TheTeamVivek/YukkiMusic.git && cd YukkiMusic
# 2. Setup Environment
bash install.sh
cp sample.env .env # Edit your API_ID, TOKEN, etc.
# 3. Tidy & Run
go mod tidy
go run ./cmd/app
All settings are managed via environment variables. See the Configuration Guide for full details.
| Variable | Description |
|---|---|
API_ID / API_HASH |
Obtained from my.telegram.org |
TOKEN |
Bot token from @BotFather |
LOGGER_ID |
Channel ID for bot logs (Must start with -100) |
MONGO_DB_URI |
MongoDB Atlas or local connection string |
STRING_SESSIONS |
Assistant account sessions (Pyrogram/Telethon/Gogram) |
/play <query>— Play from YouTube/Telegram/fplay <query>— Force play (skips current track)/pause|/resume— Toggle playback state/queue— View the upcoming list/seek <seconds>— Jump to a specific time
/addsudo|/delsudo— Manage authorized controllers/stats— View system and database metrics/broadcast— Send a message to all active chats/maintenance— Toggle global maintenance mode
YukkiMusic/
├── cmd/app/ # Main entry point
├── config/ # Configuration & Environment loader
├── internal/
│ ├── core/ # Bot initialization & playback logic
│ ├── database/ # MongoDB schemas & operations
│ ├── locales/ # YAML-based translation files
│ ├── modules/ # Command handlers (play, skip, etc.)
│ ├── platforms/ # Source providers (YouTube, TG, etc.)
│ └── utils/ # Global helper functions
└── go.mod # Dependency management- Issues: Found a bug or have a suggestion? Open a GitHub Issue.
- Support: Join our Telegram community for help: @TheTeamVk.
- Updates: Follow @TheTeamVivek for news.
Made with ❤️ by Vivek Kumar
Licensed under the GNU General Public License v3.0