TS3 Music Bot Config Reference

Side-by-side configuration reference for SinusBot and TS3AudioBot — the two most popular TeamSpeak 3 music bots. Select a tab to explore key configuration options and startup commands.

Which bot should I use?

SinusBot

  • + Web GUI — easy setup for non-technical admins
  • + Windows + Linux support
  • + Built-in scripting with JavaScript
  • - Closed-source (proprietary)
  • - Requires TS3 client binary on server

TS3AudioBot

  • + Open-source (MIT license)
  • + REST API + Swagger UI for automation
  • + Advanced scripting & plugin support
  • - Steeper learning curve — config-file driven
  • - Linux only (Rust-based)

[General] section — config.ini

[General]

TS3Path = /opt/ts3server ← path to TS3 client binary

ListenPort = 8087 ← web UI port

ListenHost = 0.0.0.0 ← bind address

DataDir = data/ ← music library storage

UseSSL = false ← use reverse proxy for SSL

LogLevel = 3 ← 0=off 3=info 10=debug

MaxDownloadSize = 0 ← 0 = unlimited

Token = ← leave blank; auto-generated on first run

[YoutubeDL] section

[YoutubeDL]

YoutubeDLPath = /usr/bin/yt-dlp ← yt-dlp recommended over youtube-dl

Install yt-dlp: pip3 install yt-dlp or curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/bin/yt-dlp && chmod +x /usr/bin/yt-dlp

Startup commands

# Native Linux

SINUSBOT_USER=sinusbot ./sinusbot --template=ts3

# Docker

docker run --rm -d \

  -v $(pwd)/config:/opt/sinusbot/config \

  -v $(pwd)/data:/opt/sinusbot/data \

  -p 8087:8087 \

  sinusbot/sinusbot

First-run tip

On first start, SinusBot prints a temporary admin password to stdout. Copy it immediately — you'll use it to log into the web UI at http://your-server-ip:8087. Virtual server connection settings are configured in the web UI, not config.ini.

Private TeamSpeak hosting

Run your own TeamSpeak server.

Rent a private TeamSpeak server on real hardware — full control-panel access, your mods, your configs, your rules. It's your server; run it your way.

Rent a TeamSpeak server Real hardware · Full control panel · 98% SLA

Don't want to run it yourself? Our managed services & consulting team will set it up and keep it running for you — game servers, Windows, Linux, and cloud, from 10+ years of MSP work.