YouTube Live

Der eigene YouTube-Livestream: Chat mitlesen und schreiben, Umfragen, Titel, Beschreibung und Sichtbarkeit ändern, Werbepausen, Zuschauer und Likes. Super Chats, Sticker, Mitglieder und neue Abonnenten werden zu Alerts.

Eigenschaft	Wert
Fach	Streaming & Chat
Schlüssel	youtube (so heißt das Plugin in Makros)
Bei frischer Installation	aus (im Marktplatz einschalten)
Befehle	9
Einrichtung	2 Felder, dazu der Knopf „Bei YouTube anmelden“

Wofür

Dein eigener YouTube-Livestream auf dem Deck: den Chat mitlesen (als Widget auf dem Display), im Chat schreiben, Umfragen starten und beenden, Titel, Beschreibung und Sichtbarkeit ändern, eine Werbepause einfügen, Zuschauer und Likes zählen. Dazu werden Super Chats, Super Sticker, neue Mitglieder, Mitglieds-Meilensteine, verschenkte Mitgliedschaften und neue Abonnenten zu Alerts, die das Plugin „Alerts“ zeigen kann.

Was Twitch kann und YouTube nicht, steht unten unter Im Vergleich mit Twitch.

Wie bei Twitch gibt es keinen anonymen Weg: Alles läuft über die Anmeldung mit deinem Google-Konto. Das Plugin ist nicht eingerichtet, solange du nicht angemeldet bist, und tut dann nichts.

Einrichten: bei YouTube anmelden

Feld	Hinweis
YouTube-Anmeldung	geheim: wird nach dem Speichern nie wieder angezeigt
Super Chats, Mitglieder und Abos als Alert melden (ja/nein)	Beispiel: ja

Du brauchst dafür das Konto im Netz (siehe Konto und Abgleich). Google verlangt bei der Anmeldung und danach jede Stunde beim Erneuern des Zugangs einen Schlüssel der Anwendung. Der liegt auf dem Server dieser Software und verlässt ihn nie, also läuft beides über den Server. Ohne Konto im Netz sagt das Plugin „YouTube braucht das Konto im Netz“.

1. Plugins → YouTube Live → Aktivieren → Einrichten, unten links Bei YouTube anmelden.
2. Dein Browser öffnet Googles Anmeldung. Wähle das Google-Konto und, wenn du mehrere Kanäle hast, den Kanal, mit dem du streamst. Google fragt jedes Mal, damit nicht wortlos das zuletzt benutzte Konto zurückkommt.
3. Solange Google die Anwendung noch nicht geprüft hat, kommt eine Warnseite („Google hat diese App nicht überprüft“). Klicke dort auf Erweitert und dann auf Weiter zu …. Siehe unten unter „Bekannte Einschränkung“.
4. Sage zu. Dafür hast du drei Minuten.
5. Im Dialog steht danach Angemeldet als <Kanal>, der Zustand wird verbunden.

Die Antwort kommt über 127.0.0.1 (Port 9848) zurück, nur auf deinem Rechner. Die Anmeldung läuft mit PKCE: Ein Geheimwort, das vor dem Öffnen des Browsers gewürfelt wird, beweist, dass die Antwort zu genau dieser Anmeldung gehört.

Zugesagt wird ein einziges Recht:

Recht	Wofür
youtube.force-ssl	Chat lesen und schreiben, Umfragen, Titel, Beschreibung, Sichtbarkeit, Werbepause, die eigene Sendung finden, neue Abonnenten sehen

Ein schwächeres Recht nur zum Lesen gäbe es, aber dann ginge weder Schreiben noch der Titel. Zwei Rechte hießen auf Googles Seite zwei Haken, von denen einer fehlen kann. Fehlt der Haken für YouTube, lehnt das Plugin die Anmeldung mit „Die Freigabe für YouTube fehlt“ ab.

Das Feld YouTube-Anmeldung zeigt nur, ob eine Anmeldung gespeichert ist. Du füllst es nicht von Hand. Der Anmeldeschlüssel steht im Klartext in der config.json, siehe Datenschutz. Das Zugangstoken lebt eine Stunde, wird nicht gespeichert und bei Bedarf neu geholt.

Befehle

Befehl	Name im Makro	Felder	Passt auf
Bei YouTube anmelden	youtube.sign_in	—	Taste
Stream suchen	youtube.find_stream	—	Taste
Chat-Nachricht senden	youtube.send_chat	message Nachricht *	Taste
Titel ändern	youtube.set_title	title Neuer Titel *	Taste
Beschreibung ändern	youtube.set_description	description Neue Beschreibung * (mehrzeilig)	Taste
Sichtbarkeit ändern	youtube.set_visibility	visibility öffentlich, nicht gelistet oder privat *	Taste
Umfrage starten	youtube.start_poll	title Frage * choices 2 bis 4 Antworten, getrennt mit | *	Taste; die Kachel zeigt den Zustand
Umfrage beenden	youtube.end_poll	—	Taste; die Kachel zeigt den Zustand
Werbepause einfügen	youtube.start_commercial	length Sekunden	Taste

* ist ein Pflichtfeld.

• Stream suchen: sieht nach, ob auf deinem Kanal gerade eine Sendung läuft, und hängt sich an ihren Chat. Läuft keine, meldet die Taste „Auf deinem Kanal läuft gerade kein Stream“. Nützlich, wenn du ohne OBS streamst oder nicht bis zur nächsten Suche warten willst (siehe unten).
• Chat-Nachricht senden: schreibt als du in den Chat deines laufenden Streams. Ohne Livestream gibt es keinen Chat und damit nichts zu schreiben. YouTube nimmt höchstens 200 Zeichen, längere Nachrichten werden gekürzt.
• Titel ändern: setzt den Titel der laufenden Sendung oder, wenn keine läuft, der nächsten geplanten. Höchstens 100 Zeichen, und YouTube nimmt < und > im Titel nicht an. Die Beschreibung bleibt, wie sie ist.
• Beschreibung ändern: dieselbe Sendung, höchstens 5000 Zeichen, mehrzeilig, ohne < und >. Der Titel bleibt, wie er ist. Eine leere Beschreibung schickt die Taste nicht ab: ein Tastendruck soll keine Beschreibung wegwischen. Wer sie wirklich leeren will, tut das im YouTube Studio.
• Sichtbarkeit ändern: öffentlich, nicht gelistet oder privat (die englischen Wörter public, unlisted, private gehen auch). Gilt für dieselbe Sendung wie der Titel.
• Umfrage starten: eine Frage und zwei bis vier Antworten, getrennt mit |, etwa Pizza|Pasta|Salat. Die Umfrage erscheint im Chat deines laufenden Streams. Anders als bei Twitch gibt es keine Dauer: sie läuft, bis du sie beendest (oder der Stream endet). Läuft schon eine, sagt die Taste „Es läuft schon eine Umfrage - erst beenden“.
• Umfrage beenden: schließt die laufende Umfrage; das Ergebnis bleibt im Widget stehen. Beide Umfrage-Tasten leuchten, solange eine Umfrage läuft.
• Werbepause einfügen: schiebt eine Werbepause in den laufenden Stream, Sekunden ist freiwillig, ohne Angabe 30. Ob YouTube dann wirklich Werbung zeigt, entscheidet YouTube. Ist der Kanal nicht monetarisiert oder Werbung für den Stream aus, sagt die Taste „YouTube lässt in diesem Stream keine Werbepause zu …“.

Die Befehle heißen wie bei Twitch (send_chat, set_title, start_poll, end_poll, start_commercial) und haben dieselben Felder. Ein Makro, das auf beiden Plattformen dasselbe tut, schreibt zweimal fast dasselbe.

Lehnt YouTube einen Befehl ab, steht der Grund in der Meldung, zum Beispiel „Für diesen Stream ist der Chat abgeschaltet“ oder „Diese Nachricht nimmt YouTube nicht an“.

Woran die Software merkt, dass du live bist

Nachzusehen kostet etwas vom Tageskontingent (siehe unten). Deshalb fragt die Software nicht ständig, sondern:

• Wenn OBS zu streamen beginnt (mit eingeschaltetem Plugin OBS Studio). YouTube braucht nach dem ersten Bild einen Moment, bis die Sendung als laufend gilt. Die Software sieht deshalb in den ersten Minuten ein paar Mal nach und hört auf, sobald sie die Sendung gefunden hat.
• Wenn du „Stream suchen“ drückst.
• Sonst alle 15 Minuten, und das nur, solange ein YouTube-Widget auf einem Bildschirm liegt.

Ohne OBS und ohne Taste kann es also bis zu einer Viertelstunde dauern, bis Chat und Zuschauerzahl erscheinen. Das Ende eines Streams merkt die Software am Chat, der dann schließt, an der Zuschauerzahl oder daran, dass OBS aufhört.

Widgets

Widget	Größe (Zellen)	Felder
YouTube-Chat	5 × 3	—
YouTube-Zuschauer	2 × 1	—
YouTube-Umfrage	5 × 2	—

Wie Widgets auf das Display kommen, steht unter Das Display.

Der Chat zeigt die letzten Nachrichten deines Streams. So funktioniert das Mitlesen:

• Die Nachrichten kommen als Strom: eine Verbindung, auf der YouTube neue Nachrichten von sich aus schickt. Das ist schneller und viel sparsamer als ständiges Nachfragen.
• Der Chat wird nicht gespeichert. Es werden nur die letzten 40 Zeilen gehalten, jede auf 200 Zeichen gekürzt. Was herausfällt, ist weg.
• Löscht ein Moderator eine Nachricht oder sperrt er jemanden, verschwindet das auch vom Display.
• Namen haben die Farben, die YouTube selbst zeigt: gelb für dich als Kanalinhaber, blau für Moderatoren, grün für Mitglieder. Alle anderen bekommen ihre Farbe vom Gerät.
• Super Chats und Sticker stehen mit Betrag im Chat, neue Mitglieder und Meilensteine als eigene Zeile.
• Endet der Stream, bleiben die letzten Zeilen stehen, bis ein neuer beginnt.

Es gibt auch einen gemeinsamen Chat, der Twitch und YouTube in einer Liste zeigt, mit den neuesten Nachrichten aus beiden unten. Für den Twitch-Teil gilt, was unter Twitch steht.

Die Zuschauerzahl zeigt, wie viele gerade zusehen, und darunter die Likes des Streams. Beides kommt aus einem Abruf, höchstens einmal je Minute, und nur, solange das Widget irgendwo liegt. Bleibt eine Zahl leer, ist entweder kein Stream live, die Zahl auf YouTube verborgen, oder sie ruht, um das Kontingent zu schonen. Eine stehengebliebene Zahl wäre schlimmer als keine.

Die Umfrage zeigt die laufende oder letzte Umfrage im Chat, mit Stimmen und Anteil, so wie das Widget „Twitch-Umfrage“. Die Stimmen kommen über den Chat; solange das Widget liegt oder eine Umfrage läuft, liest der Chat deshalb mit. Wird die Umfrage im YouTube Studio beendet statt mit der Taste, merkt die Software das nach etwa 20 Sekunden.

Alerts

Was auf YouTube passiert	Alert	Betrag
Super Chat	superchat	der Betrag, dazu der Text, den YouTube schreibt (etwa „5,00 €“)
Super Sticker	sticker	wie beim Super Chat
Neues Mitglied oder Wechsel der Stufe	member	—
Mitglieds-Meilenstein	milestone	die Monate
Verschenkte Mitgliedschaften	gift_member	die Anzahl
Neues Abo	subscriber	—

• Gemeldet wird nur, was nach dem Verbinden passiert. Der Chat bringt beim Verbinden die letzten Nachrichten mit; ein Super Chat von vor einer Stunde soll nicht noch einmal aufleuchten.
• Die Einstellung Super Chats, Mitglieder und Abos als Alert melden (ja/nein) ist ohne Angabe ja.
• Darum läuft der Chat auch ohne Chat-Widget: YouTube schickt Super Chats und Mitgliedschaften auf demselben Weg wie Chatnachrichten, einen anderen gibt es nicht. Wer Alerts will, braucht also die Verbindung zum Chat, solange er live ist. Willst du weder Chat-Widget noch Alerts, stell die Einstellung auf nein: dann bleibt der Chat zu.
• Neue Abos meldet YouTube nirgends von selbst, auch nicht im Chat. Die Software sieht deshalb alle zwei Minuten in der Liste deiner neuesten Abonnenten nach, aber nur, solange du live bist und Alerts willst. Ein Abo kann also bis zu zwei Minuten später aufleuchten. Wer schon vor dem Start abonniert hatte, zählt nicht als neu.
• Nur öffentliche Abos sind sichtbar. Abos sind bei YouTube von sich aus privat; wer seine Abos nicht öffentlich gemacht hat, taucht in dieser Liste nicht auf und bekommt deshalb keinen Alert. Das ist dieselbe Liste, die auch das YouTube Studio unter „Neue Abonnenten“ zeigt.

Das Tageskontingent

YouTube teilt jeder Anwendung 10.000 Einheiten am Tag zu, und die Anwendung ist die dieser Software. Alle, die sie benutzen, teilen sich dieses Kontingent. Jeder Abruf kostet:

Was	Einheiten
Chat verbinden (einmal je Verbindung, nicht je Nachricht)	5
Chat-Nachricht senden	20
Umfrage starten	20
Umfrage beenden	20, dazu 5, wenn die Software die Umfrage erst suchen muss
Werbepause einfügen	1
Nachsehen, ob du live bist	1
Zuschauerzahl und Likes (zusammen)	1, höchstens einmal je Minute
Neue Abos	1, alle zwei Minuten, nur live und mit Alerts
Titel, Beschreibung oder Sichtbarkeit ändern	2 bis 3, in Ausnahmefällen gut 50 (wenn YouTube es nur über das Video ändern lässt)

Deshalb hält sich die Software zurück: kein ständiges Nachsehen, Zuschauer und Likes nur mit Widget, und wenn heute schon viel verbraucht ist, ruhen Zuschauer und Abos. Die Zustandszeile sagt ab etwa 500 Einheiten, wie viel dein Rechner heute verbraucht hat. Das ist eine Schätzung; was die anderen verbraucht haben, sieht hier niemand.

Ein Stream von drei Stunden mit Chat-Widget, Zuschauer-Widget und Alerts kostet etwa: Chat 5 bis 20, Zuschauer 180, Abos 90, dazu jede Taste, die du drückst.

Ist das Kontingent aufgebraucht, sagt die Zustandszeile das, und alles ruht bis Mitternacht pazifischer Zeit, meist 9 Uhr deutscher Zeit. Daran kannst du nichts ändern, und es ist kein Fehler deiner Einstellungen.

Im Vergleich mit Twitch

Was das Plugin Twitch kann, und was davon bei YouTube geht. Wo „gibt die YouTube-API nicht her“ steht, fehlt der Aufruf in YouTubes Schnittstelle ganz; nachgesehen in der Referenz der YouTube Data API v3, nicht vermutet. Im YouTube Studio selbst kannst du manches davon trotzdem tun.

Twitch	YouTube	Warum
Bei Twitch anmelden	Bei YouTube anmelden
Clip erstellen	gibt die YouTube-API nicht her	Es gibt keinen Aufruf für Clips
Marker setzen	gibt die YouTube-API nicht her	Es gibt keine Stream-Marker in der Schnittstelle
Titel ändern	Titel ändern
—	Beschreibung ändern, Sichtbarkeit ändern	Gibt es bei Twitch so nicht
Werbung starten	Werbepause einfügen	Nur, wenn YouTube für den Stream Werbung zulässt
Chat-Nachricht senden	Chat-Nachricht senden
Umfrage starten / beenden	Umfrage starten / beenden	Zwei bis vier Antworten statt fünf, keine Dauer
Raid starten / abbrechen	gibt die YouTube-API nicht her	YouTube-Raids gibt es nur im Studio
Shoutout, Shoutout an den letzten Raider	gibt die YouTube-API nicht her	Kein Aufruf für Shoutouts, und Raids sind nicht zu sehen
Slow-Modus, Nur Emotes, Nur Follower, Nur Subs	gibt die YouTube-API nicht her	Chat-Einstellungen (Slow-Modus, nur Mitglieder, nur Abonnenten) lassen sich nur im Studio ändern
Chat als Widget	Chat als Widget	YouTube als Strom, Twitch über IRC
Umfrage als Widget	Umfrage als Widget
—	Zuschauer und Likes als Widget
Alert: Follow	Alert: neues Abo	Bis zu zwei Minuten später, nur öffentliche Abos
Alert: Sub, Resub	Alert: neues Mitglied, Meilenstein
Alert: verschenkte Subs	Alert: verschenkte Mitgliedschaften
Alert: Cheer	Alert: Super Chat, Super Sticker
Alert: Raid	gibt die YouTube-API nicht her	Ein Raid kommt weder im Chat noch sonst irgendwo an

Bekannte Einschränkung

• Keine Clips, keine Marker, keine Raids, keine Shoutouts, keine Chat-Modi. Dafür hat YouTubes Schnittstelle keinen Aufruf, siehe Im Vergleich mit Twitch. Im YouTube Studio geht es von Hand.
• Neue Abos nur, wenn sie öffentlich sind, und bis zu zwei Minuten später (siehe Alerts).
• Google hat die Anwendung noch nicht geprüft. Bis dahin zeigt Google bei der Anmeldung eine Warnseite, und es können sich nur bis zu 100 eingetragene Testnutzer anmelden. Wer nicht eingetragen ist, bekommt von Google eine Absage. Wende dich dann an den Betreiber der Software. Außerdem läuft die Anmeldung in diesem Zustand nach sieben Tagen ab: Die Zustandszeile sagt dann „Anmeldung abgelaufen oder zurückgezogen - bitte neu anmelden“.
• Das Tageskontingent ist geteilt (siehe oben). An einem Tag mit vielen Streams kann es für alle aufgebraucht sein.
• Ohne OBS merkt die Software einen Stream erst nach bis zu 15 Minuten, wenn du nicht „Stream suchen“ drückst.

Gut zu wissen

• Das Plugin ist bei einer frischen Installation aus.
• Die Zustandszeile zeigt zum Beispiel „Angemeldet als <Kanal> - live: <Titel> - Chat verbunden“ oder „Angemeldet als <Kanal> - nicht live“.
• „Keine YouTube-Anwendung hinterlegt (YOUTUBE_CLIENT_ID)“ heißt: Diese Fassung kennt die Google-Anwendung nicht. Das ist ein Problem der Fassung, nicht deiner Einstellungen.
• „Zu diesem Google-Konto gibt es keinen YouTube-Kanal“ heißt: Du hast bei der Anmeldung das Konto gewählt, aber keinen Kanal. Melde dich noch einmal an und wähle den Kanal.
• Lässt sich der Chat nur abfragen statt als Strom lesen, kommen die Nachrichten mit bis zu 30 Sekunden Verzögerung, und die Zustandszeile sagt „Chat verbunden (Abfrage, verzögert)“.