SinusBot
In Macro Deck enthaltenSteuere die Musik deiner SinusBot-Instanzen und zeige auf deinem Deck, was sie spielen.
Zwei Widgets Musik-Player, die einen Titel spielen, eines im Stil Vollflächiges Cover und eines im Stil Kleines Cover, beide mit Name und Logo von SinusBot in der Kopfzeile
- Abspielen, pausieren, überspringen und springen auf jeder SinusBot-Instanz
- Lautstärke, Zufallswiedergabe und Wiederholung einstellen
- Einen Titel aus der Bibliothek des Bots abspielen
- Zeigt den laufenden Titel im Musik-Player-Widget
- Beliebig viele Bot-Instanzen hinzufügen
SinusBot ist ein Musikbot für TeamSpeak und Discord, den du auf deinem eigenen Server betreibst. Die SinusBot-Integration verbindet Macro Deck mit der SinusBot-Weboberfläche, sodass du steuern kannst, was eine Bot-Instanz spielt, und den aktuellen Titel auf deinem Deck siehst. Sie funktioniert mit jedem SinusBot, den Macro Deck über das Netzwerk erreicht, auf demselben Computer, in deinem lokalen Netzwerk oder auf einem Server.
Was du damit machen kannst
- Abspielen, pausieren, umschalten, zum nächsten oder vorherigen Titel springen und an eine Position im aktuellen Titel springen.
- Die Lautstärke festlegen, erhöhen oder verringern, die Zufallswiedergabe ein- oder ausschalten und die Wiederholung ein- oder ausschalten.
- Mit Play Track einen bestimmten Titel aus der Bibliothek des Bots abspielen. Lass den Titel leer, um beim Drücken der Taste einen auszuwählen.
- Den laufenden Titel, Interpreten und das Cover im Widget Musik-Player von Macro Deck zeigen und Titel, Position und Lautstärke des Bots über Variablen in Beschriftungen nutzen.
Einige Beispiele:
- Eine Reihe Tasten mit Previous Track, Toggle Play/Pause und Next Track für den Bot in deinem TeamSpeak-Kanal. Die Wiedergabetaste zeigt, ob der Bot spielt.
- Ein Schieberegler, der an die Lautstärkevariable des Bots,
sinusbot_<instance>_volume, gebunden ist, damit du die Musik leiser drehen kannst, während du sprichst. - Ein Widget Musik-Player für jeden Bot, daneben Tasten, deren Farbe über die Variable
music_player_<player>_album_colordem Cover folgt.
Mehrere Bots und das Verhalten der Integration
Jede SinusBot-Instanz, die du steuern willst, ist eine Konfiguration. Du kannst beliebig viele hinzufügen, auch Instanzen auf verschiedenen Servern, und wählst die Instanz im Feld Player jeder Aktion. Lässt du Player leer, steuert die Aktion die erste. Jede Konfiguration bekommt eigene Variablen, benannt nach dem Konfigurationsnamen, etwa sinusbot_<instance>_volume.
Macro Deck prüft die Verbindung beim Einrichten einer Konfiguration und lädt die Instanzen des Bots. Im Betrieb liest es regelmäßig den Wiedergabestatus. Ist der Bot kurz nicht erreichbar, zeigt das Deck weiter den letzten Titel; bleibt er unerreichbar, ist die Variable sinusbot_<instance>_is_connected false, und Aktionen tun nichts, bis der Bot wieder antwortet.
Das brauchst du
- Ein laufender SinusBot, dessen Weboberfläche Macro Deck erreicht, zum Beispiel
http://your-bot:8087. - Ein SinusBot-Benutzername und ein Passwort.
- Mindestens eine in der SinusBot-Weboberfläche angelegte Instanz.
So richtest du sie ein
Schritt 1: SinusBot-Weboberfläche prüfen
Öffne die SinusBot-Weboberfläche in einem Browser und melde dich an. Notiere die Adresse einschließlich Port, zum Beispiel
http://192.168.1.20:8087, und stelle sicher, dass es mindestens eine Instanz gibt.Schritt 2: SinusBot-Integration öffnen
Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf SinusBot. Klicke im Tab Übersicht im Abschnitt Konfiguration auf Konfiguration hinzufügen. Der Schalter oben rechts öffnet denselben Dialog, und die Integration ist eingeschaltet, sobald die Einrichtung abgeschlossen ist.
Schritt 3: Server und Anmeldung eingeben
Gib im Dialog SinusBot verbinden Folgendes ein:
- Server-URL: die Adresse der SinusBot-Weboberfläche, einschließlich Port.
- Benutzername und Passwort: das Konto, mit dem du dich bei SinusBot anmeldest.
Wenn du auf Fortfahren klickst, testet Macro Deck die Verbindung und lädt die Instanzen.
Schritt 4: Instanz auswählen
Wähle im Schritt Instanz auswählen die Bot-Instanz unter Instanz aus und klicke auf Fortfahren. Die Konfiguration wird als SinusBot mit dem Instanznamen in Klammern gespeichert. Wiederhole diese Schritte für jede weitere Instanz, die du steuern willst.
Schritt 5: Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf eine Taste. Das Deck muss entsperrt sein: Das ist es, wenn oben rechts die Schaltfläche Sperren zu sehen ist. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen SinusBot, nimm Toggle Play/Pause und wähle die Instanz unter Player.
Schritt 6: Taste drücken
Drücke die Taste auf deinem Deck. Der Bot startet oder pausiert die Wiedergabe, und die Taste zeigt den aktuellen Zustand. Ein Widget Musik-Player, das auf die Instanz eingestellt ist, zeigt den laufenden Titel.
Aktionen13
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Play
- Setzt die Wiedergabe fort.
- Pause
- Pausiert die Wiedergabe.
- Toggle Play/Pause
- Wechselt zwischen Wiedergabe und Pause und zeigt den aktuellen Zustand auf der Taste.
- Next Track
- Springt zum nächsten Titel.
- Previous Track
- Springt zum vorherigen Titel.
- Refresh State
- Liest den Wiedergabestatus sofort neu.
- Set Volume
- Legt die Wiedergabelautstärke fest (0 bis 100 %).
- Volume Up
- Erhöht die Wiedergabelautstärke um 10 %.
- Volume Down
- Verringert die Wiedergabelautstärke um 10 %.
- Seek
- Springt im aktuellen Titel an eine Position, in Sekunden.
- Toggle Shuffle
- Schaltet die Zufallswiedergabe um, ein oder aus.
- Set Repeat Mode
- Schaltet die Wiederholung ein oder aus. SinusBot hat nur einen Wiederholmodus, daher schalten beide Wiederholoptionen ihn ein.
- Play Track
- Spielt einen Titel aus der Bibliothek des Bots ab. Lass ihn leer, um beim Drücken der Taste einen Titel auszuwählen.
Auslöser7
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Titel geändert
- Ein anderer Titel wird gespielt (unter Music Player).
- Wiedergabe gestartet
- Die Wiedergabe wurde gestartet oder fortgesetzt (unter Music Player).
- Wiedergabe pausiert
- Die Wiedergabe wurde pausiert (unter Music Player).
- Wiedergabe gestoppt
- Die Wiedergabe wurde gestoppt (unter Music Player).
- Lautstärke geändert
- Die Lautstärke des Bots hat sich geändert, mit dem neuen und dem vorherigen Wert (unter Music Player).
- Player verbunden
- Die Bot-Instanz ist erreichbar geworden (unter Music Player).
- Player getrennt
- Die Bot-Instanz ist nicht mehr erreichbar (unter Music Player).
Variablen8
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Der aktuelle Titel und sein Interpret. SinusBot meldet kein Album, daher bleibt
sinusbot_<instance>_current_albumleer. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Ob der Bot spielt, pausiert oder gestoppt ist.
sinusbot_<instance>_volume- Die Wiedergabelautstärke in Prozent. Du kannst sie auch setzen, zum Beispiel mit einem Schieberegler.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- Die Länge des Titels und die Position in Sekunden sowie der Fortschritt in Prozent. Du kannst die Position setzen, um zu springen.
sinusbot_<instance>_album_art_url- Die Adresse des aktuellen Covers.
sinusbot_<instance>_device_name- Der Name der Bot-Instanz.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Ob Zufallswiedergabe und Wiederholung an sind.
sinusbot_<instance>_is_connected- Ob Macro Deck die Bot-Instanz erreicht.
Häufige Fragen
Kann ich mehr als einen Bot steuern?
Ja. Füge pro SinusBot-Instanz eine Konfiguration hinzu, auch auf verschiedenen Servern. Jede Aktion hat ein Feld Player für die Instanz, die sie steuert, und jede Konfiguration hat eigene Variablen.
Muss SinusBot auf demselben Computer laufen?
Nein. Macro Deck spricht über das Netzwerk mit der SinusBot-Weboberfläche, der Bot kann also auf einem Server oder einem anderen Computer laufen, solange Macro Deck seine Adresse erreicht.
Die Einrichtung meldet, dass keine Instanzen gefunden wurden. Was kann ich tun?
Das Konto hat keine Instanz, die es nutzen kann. Lege zuerst in der SinusBot-Weboberfläche eine Instanz an und richte die Konfiguration dann erneut ein.
Was passiert, wenn der Bot offline geht?
Eine kurze Unterbrechung leert das Deck nicht: Es behält den letzten Titel noch einen Moment. Bleibt der Bot unerreichbar, ist die Variable sinusbot_<instance>_is_connected false, und Macro Deck versucht weiter, ihn zu erreichen.
Wo wird mein Passwort gespeichert?
Das Passwort wird verschlüsselt auf deinem Computer gespeichert und nur zur Anmeldung bei deinem SinusBot verwendet.
Mehr in „Chat und Sprache“
Discord
In Macro Deck enthaltenSchalte dich stumm oder taub, tritt Sprachkanälen bei, ändere Spracheinstellungen und poste Webhook-Nachrichten in Discord von deinem Deck aus.
Discord-Webhooks
In Macro Deck enthaltenPoste umfangreiche Nachrichten mit Embeds und Erwähnungen über Webhooks in Discord-Kanäle, mit Live-Vorschau.