1. Install Docker:
   • Linux
   • Windows/Mac

1. Clone the repository:

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

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

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

1. Check logs:

   docker logs -f tgmusicbot

   (Exit with Ctrl+C)

• 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

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

1. Install UV package manager:

   pip3 install uv

2. Clone the repository:

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

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 .

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

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

To restart the bot:

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

• API_ID – Get from my.telegram.org
• API_HASH – Get from my.telegram.org
• TOKEN – Get from @BotFather

• STRING1 - Pyrogram String Session, STRING2 ... STRING10

Get from @StringFatherBot

• OWNER_ID – Your Telegram User ID
• MONGO_URI – Get from MongoDB Cloud
• API_URL – Get from @FallenApiBot (API for unlimited downloads)
• API_KEY – Required for API_URL
• DOWNLOADS_DIR – Directory for downloads and TDLib database
• SUPPORT_GROUP – Support Group Link
• SUPPORT_CHANNEL – Support Channel Link
• IGNORE_BACKGROUND_UPDATES – Ignore background updates
• LOGGER_ID – Log Group ID
• AUTO_LEAVE – Leave all chats for all userbot clients.
• MIN_MEMBER_COUNT – Minimum number of members required for the bot to stay in a group.

• PROXY – Optional; Proxy URL for yt-dlp
• DEFAULT_SERVICE – Default search platform (Options: youtube, spotify, jiosaavn)
• DOWNLOADS_DIR – Directory for downloads and TDLib database

• COOKIES_URL – URLs for downloading cookies (More info here)