Tipp: Sie können für alle Dateinamen und Verzeichnisse die automatische Vervollständigung mithilfe der Tab-Taste nutzen, sodass Sie nicht die kompletten Datei- oder Verzeichnisnamen manuell eintippen müssen.

Hinweis: Falls Sie den Musikbot für einen TeamSpeak 3 Server installieren möchten und Sie noch keinen eigenen TeamSpeak 3 Server haben, so können Sie sich vorher auch meine Anleitung zur Installation eines TeamSpeak 3 Servers unter Linux anschauen.

Diese Anleitung wurde am 03.04.2023 zuletzt überprüft und aktualisiert.

1. Falls Sie es noch nicht getan haben, laden Sie das Programm "PuTTY" herunter.
2. Verbinden Sie sich mithilfe von PuTTY via SSH mit Ihrem Root- oder vServer. Hierfür öffnen Sie PuTTY und geben im Textfeld "Host Name (or IP address)" die Domain oder IP-Adresse Ihres Servers ein. Klicken Sie anschließend unten auf "OK".
3. Aktualisieren Sie nun Ihre Paketlisten mit dem Befehl apt update.
4. Installieren Sie jetzt möglicherweise verfügbare Updates der auf Ihrem Server bereits installieren Pakete mit dem Befehl apt upgrade -y.
5. Installieren Sie anschließend diese Pakete, die benötigt werden, mit folgendem Befehl: apt install x11vnc xvfb libxcursor1 ca-certificates bzip2 libnss3 libegl1-mesa x11-xkb-utils libasound2 libpci3 libxslt1.1 libxkbcommon0 libxss1 libglib2.0-0 libxcomposite1 curl screen nano -y.
6. Optional (falls Sie die YouTube-Wiedergabefunktion nutzen möchten):
   1. Installieren Sie die für die YouTube-Wiedergabefunktion benötigten Pakete mithilfe des Befehls apt install python -y.
   2. Laden Sie nun das Software-Paket für die YouTube-Downloadfunktion herunter ("youtube-dl"). Diese Software wird später dafür genutzt, die Audiospur beliebiger YouTube Videos über den Musikbot wiedergeben zu können. Nutzen Sie hierzu den Befehl wget https://yt-dl.org/downloads/latest/youtube-dl -O /usr/local/bin/youtube-dl.
   3. Vergeben Sie mit dem Befehl chmod +x /usr/local/bin/youtube-dl nun noch die benötigten Rechte.
7. Fügen Sie nun einen Benutzer mit dem Benutzernamen "sinusbot", der später den Musikbot ausführen wird, auf Ihrem Server hinzu. Verwenden Sie dazu folgenden Befehl: adduser --disabled-login sinusbot.
8. Die Abfrage weiterer Angaben wie Name, Telefonnummer, etc. können Sie einfach mit der Enter-Taste überspringen. Bestätigen Sie zum Schluss die Korrektheit der Informationen ebenfalls mit der Enter-Taste.
9. Erstellen Sie nun das Verzeichnis, in dem der Musikbot installiert werden soll, mit diesem Befehl: mkdir -p /opt/sinusbot und geben Sie mithilfe des Befehls chown -R sinusbot:sinusbot /opt/sinusbot/ dem Musikbot-Benutzer die nötigen Rechte in diesem Verzeichnis.
10. Wechseln Sie nun mit dem Befehl su sinusbot in das Benutzerkonto des Musikbot-Benutzers.
11. Begeben Sie sich mit dem Befehl cd /opt/sinusbot/ in das Verzeichnis, in dem der Musikbot installiert werden soll.
12. Laden Sie den Musikbot "SinusBot" nun herunter, indem Sie den folgenden Befehl ausführen: wget https://www.sinusbot.com/dl/sinusbot.current.tar.bz2
13. Nachdem der Download abgeschlossen ist, sollten Sie mit dem Befehl ls das heruntergeladene .tar.bz2-Archiv sehen. Entpacken Sie dieses mit dem Befehl tar xjf sinusbot.current.tar.bz2. Anschließend können Sie es mithilfe des Befehls rm sinusbot.current.tar.bz2 wieder löschen.
14. Kopieren Sie nun die benötigte Konfigurationsdatei mithilfe des folgenden Befehls: cp config.ini.dist config.ini
15. Nun benötigen Sie den TeamSpeak 3 Client für Linux, damit sich der Musikbot später mit Ihrem TeamSpeak 3 Server verbinden kann. Auch wenn Sie den Musikbot nur in Verbindung mit einem Discord Server nutzen möchten, benötigen Sie den TeamSpeak 3 Client, da der Musikbot sonst nicht startet. Laden Sie diesen Client mit folgendem Befehl herunter: wget https://files.teamspeak-services.com/releases/client/3.5.3/TeamSpeak3-Client-linux_amd64-3.5.3.run
16. Vergeben Sie mithilfe des Befehls chmod +x TeamSpeak3-Client-linux_amd64-3.5.3.run nun noch die Rechte zum Ausführen dieser Datei.
17. Nun müssen Sie den TeamSpeak 3 Client auf Ihrem Server einmal starten, um die Lizenzbedingungen zu akzeptieren. Das machen Sie mit dem Befehl ./TeamSpeak3-Client-linux_amd64-3.5.3.run. Mit der Enter-Taste scrollen Sie durch den Text und mit der "q"-Taste gelangen Sie zum Ende. Bestätigen Sie mit der "Y"-Taste, dass Sie die Lizenzbedingungen gelesen und akzeptiert haben und drücken Sie danach die Enter-Taste.
18. Optional (falls Sie die YouTube-Wiedergabefunktion nutzen möchten): Öffnen Sie die Konfigurationsdatei mit dem Befehl nano config.ini und fügen Sie den Parameter "YoutubeDLPath" in einer neuen Zeile hinzu. Geben Sie als Wert für diesen Parameter den Pfad zur YouTube-Downloadsoftware an (im gleichen Format wie die bereits existierenden Parameter/Zeilen). Dieser Pfad lautet "/usr/local/bin/youtube-dl". Speichern Sie danach Ihre Änderungen an der Konfigurationsdatei, indem Sie STRG + X, danach die "Y"-Taste und anschließend Enter drücken.
19. Löschen Sie nun die Datei "libqxcb-glx-integration.so", indem Sie den Befehl rm TeamSpeak3-Client-linux_amd64/xcbglintegrations/libqxcb-glx-integration.so ausführen.
20. Erstellen Sie jetzt das Plugin-Verzeichnis des TeamSpeak 3 Clients mit dem Befehl mkdir TeamSpeak3-Client-linux_amd64/plugins und kopieren Sie daraufhin das Musikbot-Plugin in dieses Plugin-Verzeichnis. Verwenden Sie hierzu diesen Befehl: cp plugin/libsoundbot_plugin.so /opt/sinusbot/TeamSpeak3-Client-linux_amd64/plugins/.
21. Jetzt müssen Sie noch die benötigten Rechte zum Ausführen des Musikbot-Scripts vergeben. Das machen Sie mit dem Befehl chmod +x sinusbot.
22. Der Musikbot ist nun installiert und Sie können ihn starten. Stellen Sie hierfür sicher, dass Sie mit dem Musikbot-Benutzer angemeldet sind, den Sie zuvor erstellt haben und dass Sie sich im Verzeichnis befinden. Ist das nicht der Fall, so können Sie mit dem Befehl su sinusbot zu diesem Benutzer und anschließend mithilfe des Befehls cd /opt/sinusbot/ in das Musikbot-Verzeichnis wechseln. Führen Sie für den ersten Start des Musikbots folgenden Befehl aus: screen -dmS sinusbot ./sinusbot -override-password IhrPasswort. Anstelle von "IhrPasswort" vergeben Sie hier ein beliebiges Passwort für das Webinterface.
23. Ihr Musikbot ist nun gestartet. Sie können das Webinterface über die IP-Adresse oder Domain Ihres Root- oder vServers mit dem Port 8087 erreichen. Rufen Sie hierfür im Browser also beispielsweise "http://123.123.123.123:8087" auf. Der Benutzername lautet "admin" und das Passwort ist das, welches Sie gerade festgelegt haben.
24. Sie können die Sprache des Webinterfaces nun auf Deutsch umstellen, indem Sie im Menü oben auf "Settings" klicken und unter "Language" anschließend "Deutsch" auswählen.
25. Da das Passwort des Musikbots jedoch nur beim ersten Start temporär gesetzt ist (über den Befehl bei Schritt 22), müssen Sie dieses nun noch in den Einstellungen im Webinterface fest ändern. Klicken Sie hierzu in den Webinterface-Einstellungen links auf "Benutzerkonten". Es erscheint nun eine Benutzerübersicht als Tabelle. Klicken Sie in der Zeile des Admin-Benutzers rechts auf den Bearbeiten-Button, vergeben Sie Ihr gewünschtes Passwort und speichern Sie diese Änderung abschließend mit einem Klick auf den Button "Änderungen speichern". Danach müssen Sie sich mit dem soeben gesetzten Passwort erneut anmelden.
26. Falls Sie den Musikbot auf einem Discord Server nutzen möchten, führen Sie folgende Schritte durch:
    1. Klicken Sie im Einstellungsmenü des Webinterfaces links auf "Instanzen" und fügen über den Button "Instanz erstellen" eine weitere Musikbot-Instanz hinzu.
    2. Wählen Sie als "Backend" nun "Discord" aus und vergeben Sie einen Namen für den Musikbot.
    3. Klicken Sie unter dem letzten Textfeld auf das rot markierte Wort "here", um die Übersicht Ihrer Discord-Apps aufzurufen. Hier müssen Sie den Musikbot über einen Klick auf "New Application" als Discord-App registrieren.
    4. Vergeben Sie einen Namen für Ihren Musikbot, welcher später auf dem Discord Server angezeigt wird (z.B. "SinusBot").
    5. Aktivieren Sie die Checkbox "By clicking Create, you agree to the Discord Developer Terms of Service and Developer Policy" und klicken Sie auf den Button "Create", um die Discord-App zu erstellen.
    6. Klicken Sie nun links auf den Menüpunkt "Bot", dann auf den Button "Add Bot" und anschließend auf "Yes, do it!".
    7. Klicken Sie unter der Überschrift "Token" auf den Button "Copy", um den Token (Zugangsschlüssel) für den Musikbot zu kopieren. Fügen Sie diesen Token nun im Musikbot-Webinterface in das Textfeld "Bot-Token" ein. Klicken Sie daraufhin auf "Erstellen".
    8. Wählen Sie in der Instanz-Übersicht nun die soeben erstellte Discord-Instanz aus, indem Sie auf den entsprechenden "Auswählen"-Button klicken.
    9. Wechseln Sie danach in den Einstellungen des Webinterfaces links auf die "Instanz-Einstellungen".
    10. Klicken Sie auf den roten Link "Klicke hier um dem Bot die Erlaubnis zu erteilen, deinen Server zu betreten", wählen Sie dann Ihren Discord-Server aus und klicken Sie anschließend auf den Button "Autorisieren", um den Musikbot nun mit Ihrem Discord Server zu verbinden.
    11. Starten Sie die Musikbot-Instanz, indem Sie im Webinterface oben auf den Einschalten-Button klicken. Nun sollte der Musikbot Ihrem Discord Server beigetreten sein.
    12. Laden Sie die Webinterface-Einstellungsseite im Browser noch einmal neu, wählen den gewünschten Discord-Channel unter "Standard-Channel" aus und klicken anschließend unten auf "Änderungen speichern". Der Musikbot sollte jetzt dem Discord-Channel beitreten und ist einsatzbereit.
27. Um den Musikbot - neben dem Webinterface - auch über Chat-Befehle steuern zu können, müssen Sie die Benutzer Ihres TeamSpeak 3 Servers bzw. Discord Servers mit entsprechenden Webinterface-Benutzern verknüpfen. Klicken Sie hierzu in den Webinterface-Einstellungen links auf "Benutzerkonten".
28. Derzeit gibt es nur den Benutzer "admin", über den Button "Benutzer hinzufügen" können Sie jedoch noch weitere hinzufügen.
29. Sie können einen Benutzer mit einem TeamSpeak- bzw. Discord-Benutzer verknüpfen, indem Sie rechts auf den Bearbeiten-Button klicken, unter "An neue Identität binden" den entsprechenden Benutzer auf Ihrem Server auswählen und anschließend auf "Änderungen speichern" klicken. In der Tabelle können Sie unter "Rechte" für jeden Benutzer individuell festlegen, welche Aktionen dieser ausführen darf.
30. Die verfügbaren Chat-Befehle finden Sie, wenn Sie in den Webinterface-Einstellungen links auf "Info" und dann auf den Reiter "Befehle" klicken.
31. Ihr Musikbot läuft ab sofort ununterbrochen im Hintergrund, somit können Sie PuTTY nun ohne Probleme schließen. Um den Musikbot zu stoppen, verwenden Sie den Befehl screen -r sinusbot -X quit. Wenn Sie den Musikbot starten möchten, stellen Sie sicher, dass Sie als Musikbot-Benutzer angemeldet sind (entweder direkt beim SSH-Login in PuTTY oder über den Befehl su sinusbot), wechseln Sie mit dem Befehl cd /opt/sinusbot/ in das Musikbot-Verzeichnis und starten Sie den Musikbot letztendlich mit dem Befehl screen -dmS sinusbot ./sinusbot.