🎵 TgMusicBot – Telegram Music Bot

A high-performance Telegram Voice Chat Bot for streaming music from YouTube, Spotify, JioSaavn, and more. Built with Python, Py-Tgcalls, and PyTdBot.

🔥 Live Bot: @FallenBeatzBot

---

✨ Key Features

Feature	Description
🎧 Multi-Platform Support	YouTube, Spotify, Apple Music, SoundCloud, JioSaavn
📜 Playlist Management	Queue system with auto-play
🎛️ Advanced Controls	Volume, loop, seek, skip, pause/resume
🌐 Multi-Language	English, Hindi, Spanish, Arabic support
⚡ Low Latency	Optimized with PyTgCalls
🐳 Docker Ready	One-click deployment
🔒 Anti-Ban	Cookie & API-based authentication

---

🚀 Quick Deploy

---

📦 Installation Methods

📌 Docker Installation (Recommended) (Click to expand)

🐳 Prerequisites

1. Install Docker:
   • Linux
   • Windows/Mac

🚀 Quick Setup

1. Clone the repository:

   git clone https://github.com/AshokShau/TgMusicBot.git && cd TgMusicBot

🔧 Configuration

1. Prepare environment file:

   cp sample.env .env

2. Edit configuration (choose one method):

   • Beginner-friendly (nano):

     nano .env

     • Edit values
     • Save: Ctrl+O → Enter → Ctrl+X

   • Advanced (vim):

     vi .env

     • Press i to edit
     • Save: Esc → :wq → Enter

🏗️ Build & Run

1. Build Docker image:

   docker build -t tgmusicbot .

2. Run container (auto-restarts on crash/reboot):

   docker run -d --name tgmusicbot --env-file .env --restart unless-stopped tgmusicbot

🔍 Monitoring

1. Check logs:

   docker logs -f tgmusicbot

   (Exit with Ctrl+C)

⚙️ Management Commands

• Stop container:

  docker stop tgmusicbot

• Start container:

  docker start tgmusicbot

• Update the bot:

  docker stop tgmusicbot
  docker rm tgmusicbot
  git pull origin master
  docker build -t tgmusicbot .
  docker run -d --name tgmusicbot --env-file .env --restart unless-stopped tgmusicbot

📌 Step-by-Step Installation Guide (Click to Expand)

🛠️ System Preparation

1. Update your system (Recommended):

   sudo apt-get update && sudo apt-get upgrade -y

2. Install essential tools:

   sudo apt-get install git python3-pip ffmpeg tmux -y

⚡ Quick Setup

1. Install UV package manager:

   pip3 install uv

2. Clone the repository:

   git clone https://github.com/AshokShau/TgMusicBot.git && cd TgMusicBot

🐍 Python Environment

1. Create virtual environment:

   uv venv

2. Activate environment:

   • Linux/Mac: source .venv/bin/activate
   • Windows (PowerShell): .\.venv\Scripts\activate

3. Install dependencies:

   uv pip install -e .

🔐 Configuration

1. Setup environment file:

   cp sample.env .env

2. Edit configuration (Choose one method):

   • For beginners (nano editor):

     nano .env

     • Edit values
     • Save: Ctrl+O → Enter → Ctrl+X

   • For advanced users (vim):

     vi .env

     • Press i to edit
     • Save: Esc → :wq → Enter

🤖 Running the Bot

1. Start in tmux session (keeps running after logout):

   tmux new -s musicbot
   tgmusic

   Tmux Cheatsheet:

   • Detach: Ctrl+B then D
   • Reattach: tmux attach -t musicbot
   • Kill session: tmux kill-session -t musicbot

🔄 After Updates

To restart the bot:

tmux attach -t musicbot
# Kill with Ctrl+C
tgmusic

---

⚙️ Configuration Guide

🔑 Required Variables (Click to expand)

Variable	Description	How to Get
API_ID	Telegram App ID	my.telegram.org
API_HASH	Telegram App Hash	my.telegram.org
TOKEN	Bot Token	@BotFather
STRING1-10	Pyrogram Sessions (Only 1 Required)	@StringFatherBot
MONGO_URI	MongoDB Connection	MongoDB Atlas
OWNER_ID	User ID of the bot owner	@GuardxRobot and type /id
LOGGER_ID	Group ID of the bot logger	Add @GuardxRobot to the group and type /id

Optional Variables

Variable	Description	How to Get
API_URL	API URL	Start @FallenApiBot
API_KEY	API Key	Start @FallenApiBot and type /apikey
MIN_MEMBER_COUNT	Minimum number of members required to use the bot	Default: 50
PROXY	Proxy URL for the bot if you want to use it for yt-dlp (Optional)	Any online service
COOKIES_URL	Cookies URL for the bot
DEFAULT_SERVICE	Default search platform (Options: youtube, spotify, jiosaavn)	Default: youtube
SUPPORT_GROUP	Telegram Group Link	Default: https://t.me/GuardxSupport
SUPPORT_CHANNEL	Telegram Channel Link	Default: https://t.me/FallenProjects
AUTO_LEAVE	Leave all chats for all userbot clients	Default: True
START_IMG	Start Image URL	Default: IMG
DEVS	User ID of the bot owner	@GuardxRobot and type /id: e.g. 5938660179, 5956803759

---

🍪 Avoiding Bans

Option 1: Premium API

API_URL=https://tgmusic.fallenapi.fun
API_KEY=your-secret-key

📌 Get keys: Contact @AshokShau or @FallenApiBot

Option 2: Cookies

---

🤖 Bot Commands

Command	Description
/play [query]	Play music from supported platforms
/skip	Skip current track
/pause / /resume	Control playback
/volume [1-200]	Adjust volume
/queue	Show upcoming tracks
/loop	Enable/disable loop

---

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add some AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Note: Minor typo fixes will be closed. Focus on meaningful contributions.

---

📜 License

AGPL-3.0 © AshokShau.

---

💖 Support

Help keep this project alive!

---

🔗 Connect

---