TgMusicBot

Copy sample.env to create your configuration file:

cp sample.env .env

Where to get credentials

• API_ID & API_HASH: Log in to my.telegram.org with your Telegram phone number, select API development tools, and create an application.
• TOKEN: Message @BotFather on Telegram, send /newbot, follow the instructions, and copy the bot token provided.
• STRING1 (or STRING): Generate a Pyrogram string session for your assistant account using a session generator bot or local script.
• MONGO_URI: Register at MongoDB Atlas, create a database cluster, go to Database Access / Network Access to permit connections, and copy the connection string (mongodb+srv://...).
• OWNER_ID: Send /id to @userinfobot on Telegram to get your numeric user ID.

Environment Variables Reference

Docker isolates all dependencies (Go 1.26, FFmpeg, yt-dlp, Deno, dynamic libraries) inside a container.

1. Install Docker & Docker Compose

On Ubuntu / Debian:

sudo apt update
sudo apt install -y docker.io docker-compose-v2
sudo systemctl enable --now docker

2. Clone Repository & Configure Environment

git clone https://github.com/AshokShau/TgMusicBot.git
cd TgMusicBot
cp sample.env .env
nano .env

Fill in all required variables inside .env (API_ID, API_HASH, TOKEN, OWNER_ID, MONGO_URI, STRING1), then save and exit (Ctrl + O, Enter, Ctrl + X).

3. Build & Run Container

Using Docker Compose:

docker compose up -d --build

Or using standard Docker CLI:

docker build -t tgmusic .
docker run -d --name tgmusic --env-file .env --restart unless-stopped tgmusic

4. Container Management

• View Logs:

  docker compose logs -f
  

• Stop Bot:

  docker compose down
  

• Restart Bot:

  docker compose restart
  

1. Install System Dependencies

sudo apt update
sudo apt install -y build-essential ffmpeg curl wget unzip git

Install yt-dlp:

sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Install Deno (required for YouTube download challenges):

curl -fsSL https://deno.land/install.sh | sh
echo 'export DENO_INSTALL="$HOME/.deno"' >> ~/.bashrc
echo 'export PATH="$DENO_INSTALL/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Install Go (1.26 or higher required):

wget https://go.dev/dl/go1.26.0.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.26.0.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

2. Clone Repository & Prepare Configuration

git clone https://github.com/AshokShau/TgMusicBot.git
cd TgMusicBot
cp sample.env .env
nano .env

Fill in your configuration settings in .env.

3. Fetch Required Dynamic Libraries & Build

The bot uses precompiled C libraries for TDLib (libtdjson) and ntgcalls. Run the setup scripts before compiling:

# Download TDLib dynamic library
go run github.com/AshokShau/gotdbot/scripts/tools

# Download ntgcalls C libraries and headers
go run setup_ntgcalls.go

# Compile binary with CGO enabled
CGO_ENABLED=1 go build -o tgmusic main.go

4. Run the Bot

Test run directly in terminal:

./tgmusic

5. Background Execution

To keep the bot running after disconnecting from SSH, use tmux or screen.

Option A: Using tmux

# Start new session
tmux new -s tgmusic

# Run bot
./tgmusic

Detach with Ctrl + B, then press D.
Reattach later: tmux attach -t tgmusic

Option B: Using screen

# Start new screen session
screen -S tgmusic

# Run bot
./tgmusic

Detach with Ctrl + A, then press D.
Reattach later: screen -r tgmusic

• Ensure the assistant account is not banned or restricted in the group.
• Start the Voice Chat in the Telegram group before running /join or /play.
• Verify that your userbot session string (STRING1) is active and generated from the same API_ID / API_HASH.

• YouTube frequently updates bot detection mechanisms.
• Export raw cookies from your browser (using extensions like Get cookies.txt LOCALLY).
• Upload the cookies.txt file to a URL or GitHub Gist (raw link) and set COOKIES_URL in your .env.

• Ensure build-essential and gcc are installed on your Linux host.
• Always include CGO_ENABLED=1 when running go build.
• Make sure you executed go run github.com/AshokShau/gotdbot/scripts/tools and go run setup_ntgcalls.go prior to building.