How to Connect a SinusBot Music Bot to Your TeamSpeak Server

What Is SinusBot

SinusBot is the most popular music bot for TeamSpeak 3. It connects to your server as a client, sits in a channel, and streams audio — YouTube links, radio streams, local files, whatever you feed it. Users control it through chat commands or a web interface.

DustBowl.Games can provide SinusBot as an add-on to your TS3 plan — contact support if you want it managed for you. If you'd rather run your own instance on a separate VPS, this guide covers the connection setup either way.

Step 1: Create a ServerQuery Login

SinusBot connects to your TS3 server using the ServerQuery interface — a text-based admin protocol that runs on port 10011. You need to create a dedicated login for it.

In your TS3 client (connected as a Server Admin):

1. Go to Tools menu → ServerQuery Login
2. Enter a username for the bot (e.g., sinusbot)
3. Click OK — the server generates a password and shows it to you once
4. Copy and save both the username and password immediately

If you lose the password, you'll need to delete that login and create a new one — there's no way to retrieve it.

Step 2: Configure SinusBot

In the SinusBot web interface (typically at http://your-sinusbot-ip:8087):

1. Go to Settings → Instances
2. Click Add Instance
3. Fill in the connection details:

Server Host:       your.ts3.server.ip (or domain)
Server Port:       9987
ServerQuery Port:  10011
Query Username:    sinusbot   (the login you just created)
Query Password:    [paste password here]
Bot Nickname:      MusicBot   (or whatever you want it called)
Default Channel:   Music      (channel name or ID)

4. Save and click Start Instance

The bot should appear in your TS3 channel list within a few seconds.

Step 3: Assign the Bot a Server Group

Give the bot a server group that has the right permissions to function:

• Join any channel
• Talk (voice activity, since it streams audio)
• Move itself between channels (if you want users to summon it)

You don't want to give it admin permissions. Create a dedicated "Bot" server group with only what it needs — keep it minimal.

Controlling the Bot

SinusBot responds to commands in the TS3 chat or through its web interface. Default commands:

!play [url or search]
!pause
!skip
!stop
!queue
!vol [0-100]

Commands are configurable. SinusBot has a scripting engine (JavaScript-based) that lets you write custom scripts to extend or change its behavior. The official SinusBot docs have the full scripting reference.

Security Notes

Never connect SinusBot using the serveradmin account. The serveradmin account has unrestricted access to your entire server — including destructive operations like deleting channels or banning everyone. If the bot is ever compromised or misbehaves, you don't want it running under that account.

Always use the dedicated low-privilege ServerQuery login you created in Step 1. One login per bot — if you run multiple bots, create multiple logins.

Also make sure port 10011 is not exposed to the public internet. ServerQuery should only be reachable from trusted IPs. On DustBowl.Games managed servers, this is handled automatically.

Related

• How to Use the TeamSpeak ServerQuery Interface
• How to Set Up Server Groups and Assign Roles on Your TeamSpeak Server
• How to Manage the TeamSpeak Server Admin Account