TS3AudioBot Setup Guide

TS3AudioBot


Introduction

This product need a certain level of technical expertise. If you don't know what you are doing, you might break the System and cause bad things to happen.

  • Item Name : TS3AudioBot

Welcome to this getting started & setup guide.

This documentation is to help you setup the TS3AudioBot (https://github.com/Splamy/TS3AudioBot) and prepare it to use with our Product (Shop now!).

Requirements

You will need the following sofwares to install and use this product:

  1. A Server with the following tools installed:
    1. nano (text editor)
    2. a Server

For our server we are using Debian 9 64 bit. This should work on any other systems, tho probably changes are nessessary to make.

Getting Started #back to top

Make sure you system is up-to-date by executing sudo apt-get update -y && sudo apt-get upgrade -y.

Install the required Debian source repos with these commands: (Note: if you are not root, you maybe need to use sudo in front of some commands)

                                    root@server:~# wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg
                                    root@server:~# mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/
                                    root@server:~# wget -q https://packages.microsoft.com/config/debian/9/prod.list
                                    root@server:~# mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
                                    root@server:~# chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
                                    root@server:~# chown root:root /etc/apt/sources.list.d/microsoft-prod.list
                                
                                    root@server:~# apt-get install apt-transport-https
                                    root@server:~# apt-get update
                                    root@server:~# apt-get install dotnet-sdk-2.2
                                

Install the following further requirements.

                                    roo@server:~# apt-get install libopus-dev ffmpeg -y
                                

Now, download and install the latest stable-version of the bot itself.

                                    root@server:~# wget -O Bot.zip https://splamy.de/api/nightly/ts3ab/master_dotnet_core/download
                                    root@server:~# apt install unzip -y && unzip Bot.zip -d Bot && cd Bot/
                                

Run the bot with the following command and complete the setup. Enter your TeamSpeakID when promted. You can find it in the identities tab in the TeamSpeak3 client.

                                    root@server:~/Bot# dotnet TS3AudioBot.dll
                                    15:48:08.2901| INFO|| [============ TS3AudioBot started =============]
                                    15:48:08.4249| INFO|| [ Date/Time: Monday, February 24, 2020 3:48:08 PM
                                    15:48:08.4398| INFO|| [ Version: 0.10.1+7/master/65aa9a18
                                    15:48:08.4417| INFO|| [ Platform: Debian GNU/Linux 9 (stretch) (64bit)
                                    15:48:08.4417| INFO|| [ Runtime: .NET Core (2.2.8) ServerGC:True GC:SustainedLowLatency
                                    15:48:08.4417| INFO|| [ Opus: libopus 1.2~alpha2 (x64)
                                    15:48:08.4417| INFO|| [==============================================]
                                    15:48:09.0244| WARN|| No permission file found.
                                    Do you want to set up an admin in the default permission file template? [Y/n]
                                    Please enter an admin uid
                                    KuqEsXWtKi0lfOKcJzG6GSKf+jM=
                                    15:49:21.6495| INFO|| Creating new permission file ({"AdminUids":["KuqEsXWtKi0lfOKcJzG6GSKf+jM="], "OverwriteIfExists":false})
                                    It seems like there are no bots configured.
                                    Fill out this quick setup to get started.
                                    Please enter the ip, domain or nickname (with port; default: 9987) where to connect to:
                                    192.168.1.132
                                    Please enter the server password (or leave empty for none):

                                    15:50:39.1361| INFO|| Bot "default" connecting to "192.168.1.132"
                                    15:50:40.0780| INFO|| Started Webserver on port 58913
                                    15:50:40.2810| INFO|0| Bot "default"(0) connected.
                                

Now connect yourself with your TeamSpeak Server where the Bot joined and type: !api token in a private chat window. Save the response.

If you are using our product, now open the config.json and fill out the connection information for the Bot. The default port is 58913 and the token is the response from the bot.
Now you should be all good to go.

You can start the bot in the background by using screen

                                    root@server:~/Bot# apt install screen -y
                                    root@server:~/Bot# screen -S musik -dm dotnet TS3AudioBot.dll
                                

You can always resume and see the console with screen -r musik. To exit that screen again, use ctrl + a + d