TS3AudioBot Installation unter Linux

TS3AudioBot Installation unter Linux

Diese Anleitung beschreibt die Installation und Inbetriebnahme des TS3AudioBot unter Linux. Sie ist für die Verwendung auf einer Website (Hosting-Dokumentation, Tutorials oder Knowledge Base) optimiert und richtet sich an Administratoren und fortgeschrittene Benutzer.


1. Was ist TS3AudioBot?

TS3AudioBot ist ein leistungsstarker Musikbot für TeamSpeak 3, der Streams, Musikdateien und Playlists automatisch in TeamSpeak-Channels abspielen kann. Er bietet viele Plugins, eine Weboberfläche und erweiterte Konfigurationsmöglichkeiten.


2. Systemvoraussetzungen

Empfohlene Mindestanforderungen:

  • Linux-Server (Ubuntu 20.04+ / Debian 11+ empfohlen)

  • 64-Bit-System

  • 1 vCPU

  • 512 MB – 2 GB RAM

  • 2–5 GB freier Speicher

  • Root-Zugriff oder sudo-Rechte

Zusätzlich erforderlich:

  • TeamSpeak 3 Client (für den Bot-Login)

  • Eine gültige TeamSpeak 3 ServerQuery-Berechtigung


3. System vorbereiten

System aktualisieren und notwendige Pakete installieren:

sudo apt update && sudo apt upgrade -y
sudo apt install wget screen mono-complete -y

Hinweis: TS3AudioBot benötigt Mono, da er auf .NET basiert.

4. Benutzer für TS3AudioBot anlegen (empfohlen)

Aus Sicherheitsgründen sollte der Bot nicht als Root laufen:

sudo adduser ts3audiobot
su - ts3audiobot

5. TS3AudioBot herunterladen

TS3AudioBot wird über das offizielle GitHub-Repository bereitgestellt:

wget https://github.com/Splamy/TS3AudioBot/releases/download/0.13.9/TS3AudioBot-linux-x64-0.13.9.tar.gz

Archiv entpacken:

tar xvf TS3AudioBot-linux-x64-0.13.9.tar.gz
cd TS3AudioBot

6. TS3AudioBot konfigurieren

Konfigurationsdatei erstellen

cp config.ini.example config.ini
nano config.ini

Wichtige Einstellungen:

  • Host → IP oder Domain des TeamSpeak 3 Servers

  • QueryPort → ServerQuery Port (Standard: 10011)

  • ServerAdminLogin / ServerAdminPassword → Zugangsdaten für ServerQuery

  • MusicDirectories → Pfad zu Musikdateien

  • WebPort → Port für Webinterface


7. TeamSpeak Client herunterladen

Der Bot benötigt einen TeamSpeak 3 Client:

wget https://files.teamspeak-services.com/releases/client/3.6.2/TeamSpeak3-Client-linux_amd64-3.6.2.run
chmod +x TeamSpeak3-Client-linux_amd64-3.6.2.run
./TeamSpeak3-Client-linux_amd64-3.6.2.run

Den Pfad anschließend in der config.ini hinterlegen.


8. TS3AudioBot starten

Bot starten:

mono TS3AudioBot.exe

Das Webinterface ist anschließend erreichbar unter:

http://SERVER-IP:WebPort

9. Firewall konfigurieren

Öffne den Webinterface-Port in deiner Firewall (Beispiel mit UFW):

sudo ufw allow WebPort/tcp
sudo ufw reload

10. Autostart mit systemd einrichten (optional)

systemd-Service erstellen

sudo nano /etc/systemd/system/ts3audiobot.service

Inhalt:

[Unit]
Description=TS3AudioBot
After=network.target

[Service]
User=ts3audiobot
WorkingDirectory=/home/ts3audiobot/TS3AudioBot
ExecStart=/usr/bin/mono /home/ts3audiobot/TS3AudioBot/TS3AudioBot.exe
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Service aktivieren und starten:

sudo systemctl daemon-reload
sudo systemctl enable ts3audiobot
sudo systemctl start ts3audiobot

11. Fazit

TS3AudioBot ist eine flexible Lösung, um Musik und Streams in TeamSpeak 3 Channels zu verwalten. Über das Webinterface können Playlists, Plugins und Zugriffsrechte komfortabel gesteuert werden.


Hinweis: Versionsnummern und Download-Links können sich ändern. Für den produktiven Einsatz wird eine gültige Lizenz oder ein aktueller Release empfohlen.