Thomas/Homelab--Bratonein-Kontrollzentrum--Tutorial
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a0b33cec679de790f2a53e6e87593271f8a8cc76
Homelab--Bratonein-Kontroll…/Kapitel 10/Free Rhohtext.md

34 KiB
Raw Blame History

Kapitel 10 – n8n (Free)

Einleitung

Mit dem Tool n8n (gesprochen: „n‑n“) führst du eine zentrale Komponente für Automatisierungen in dein UCC-System ein. Das Ziel ist, wiederkehrende Aufgaben wie Erinnerungen, Uploads oder Social-Media-Posts nicht manuell erledigen zu müssen – sondern automatisiert, nachvollziehbar und kontrolliert im Hintergrund ablaufen zu lassen.

n8n ist eine sogenannte Low-Code-Automatisierungsplattform. Du erstellst Abläufe („Workflows“) visuell, indem du vordefinierte Funktionen – sogenannte „Nodes“ – miteinander verbindest. Es gibt Nodes für Zeitpläne, HTTP-Requests, Datenbanken, Social Media, Kalender, E-Mail, Twitch, Discord und viele weitere Dienste. Gleichzeitig kannst du eigene JavaScript-Logik ergänzen, wenn du mehr Kontrolle brauchst.

Im Gegensatz zu externen Diensten wie Zapier, Make oder IFTTT läuft n8n vollständig lokal – in einem eigenen Container auf deinem Server. Das bedeutet:

  • keine Daten verlassen dein Netzwerk,
  • keine Anmeldung oder Drittanbieter-Abhängigkeit,
  • keine Einschränkungen bei der Anpassung.

[!NOTE] Wir verwenden in diesem Tutorial ausschließlich die kostenfreie Community Edition von n8n. Diese wird lokal installiert, läuft dauerhaft im eigenen Container und stellt alle für den Einstieg relevanten Funktionen bereit.

Dieses Kapitel behandelt ausschließlich die Grundlagen:

  • Installation von n8n auf einem dedizierten Ubuntu-Container,
  • Konfiguration und Start als systemweiter Dienst,
  • Integration über Nginx Proxy Manager mit Subdomain und HTTPS,
  • Erstellung eines ersten produktiven Workflows (Stream-Reminder + Social Post).

Das hier erstellte Setup bildet die technische Basis für spätere Erweiterungen, z. B. das automatische Auslesen von Twitch-Kalenderdaten (ICS-Dateien), das Erzeugen und Planen von Social-Media-Inhalten oder automatisierte Uploads in deine Nextcloud. Diese folgen im Premium-Kapitel.

Wie immer setzen wir kein technisches Vorwissen voraus. Alles, was du für dieses Kapitel brauchst, hast du in den vorherigen Schritten bereits eingerichtet: Proxmox, LXC, Proxy, Domain und grundlegende Netzwerkstruktur. Wenn du diesen Abschnitt erfolgreich abgeschlossen hast, kannst du erste Automatisierungen vollständig eigenständig umsetzen – mit deinem eigenen System und ohne Drittanbieter.

Voraussetzungen & Ressourcen

Bevor du mit der Installation von n8n beginnst, solltest du sicherstellen, dass dein System korrekt vorbereitet ist. In diesem Abschnitt definieren wir die nötigen Ressourcen für den LXC-Container und klären, welche technischen Voraussetzungen erfüllt sein müssen, damit alle späteren Schritte funktionieren.

Container-Ressourcen

Für den n8n-Container legen wir folgende Ausstattung fest:

  • CPU: 2 vCPUs
    Zwei virtuelle Prozessoren reichen für die Ausführung typischer n8n‑Workflows im Hintergrund.
    Falls du später viele parallele Abläufe oder aufwendige API-Abfragen nutzen möchtest, kannst du die CPU-Zahl bei Bedarf erhöhen.

  • RAM: 2 GB
    Der Node.js-Prozess von n8n benötigt vergleichsweise wenig Arbeitsspeicher.
    Mit 2 GB läuft das System auch bei mehreren gleichzeitig aktiven Workflows stabil.
    Nur bei sehr großen Datenverarbeitungen (z. B. viele gleichzeitige Uploads oder komplexe Datenmanipulationen) kann mehr RAM sinnvoll sein.

  • Speicherplatz: 10 GB
    Dieser Platz reicht für die Grundinstallation, Logdateien und temporäre Workflow-Daten.
    Da n8n keine großen Medien speichert, ist der Speicherbedarf überschaubar.
    Wenn du viele eigene Skripte oder große JSON-Daten verarbeitest, kannst du den Container später vergrößern.

  • Betriebssystem: Ubuntu 24.04 LTS (64‑Bit)
    Wir setzen hier auf Ubuntu, da es moderne Pakete für Node.js bereitstellt und sich gut für die manuelle Installation eignet.
    Zudem verwenden wir Node.js ≥ 18.x, was unter Ubuntu besonders gut unterstützt wird.

  • Netzwerk: Feste IP-Adresse per DHCP-Reservierung
    Wie in Kapitel 1 beschrieben, richtest du im Router eine DHCP-Reservierung für den Container ein.
    So bleibt er immer unter derselben Adresse erreichbar und kann später korrekt im Proxy Manager eingebunden werden.

[!TIP] Plane beim Erstellen des Containers genug Reserven ein – auch wenn n8n anfangs wenig verbraucht.
Gerade wenn du das System später für Uploads, VOD-Verarbeitung oder komplexe Kalenderanalysen nutzt, steigen RAM- und CPU-Anforderungen deutlich.

Technische Voraussetzungen

Dieses Kapitel baut auf der bestehenden UCC-Grundstruktur auf. Folgende Komponenten solltest du bereits eingerichtet haben:

  • Proxmox läuft stabil (Kapitel 1)
    Der LXC-Container für n8n wird direkt dort erstellt und verwaltet.

  • Nginx Proxy Manager ist eingerichtet (Kapitel 3)
    Darüber wird n8n später mit Subdomain, HTTPS und Zertifikat erreichbar gemacht.

  • Domain oder DynDNS-Adresse ist vorhanden (Kapitel 4)
    Für die öffentliche Erreichbarkeit und Let's Encrypt brauchst du eine gültige Subdomain, z. B. n8n.deinprojekt.de.

  • Zugriff auf das Container-Terminal
    Du benötigst entweder direkten Zugriff über die Proxmox-Konsole oder per SSH auf den Container.

[!IMPORTANT] Wenn du n8n nur im lokalen Netzwerk einsetzen möchtest, kannst du den Container auch ohne Domain und HTTPS betreiben. Die Anleitung funktioniert in diesem Fall ebenfalls – du musst später lediglich eigene Proxy-Regeln anpassen.

Software und Versionen

In diesem Kapitel installierst du alle benötigten Komponenten manuell – ohne Docker, vollständig nachvollziehbar:

  • Node.js – ab Version 18.x (erforderlich für aktuelle n8n-Releases)
  • npm – Node Package Manager, wird automatisch mit Node.js installiert
  • n8n – Automatisierungstool, wird systemweit per npm install -g eingerichtet
  • PM2 – Prozessmanager, sorgt für dauerhaften Hintergrundbetrieb und Autostart

Alle Schritte erfolgen in der richtigen Reihenfolge und mit ausführlichen Erklärungen – du brauchst keine Vorkenntnisse im Umgang mit Node.js oder JavaScript.

[!TIP] Die direkte Installation ohne Docker erhöht die Transparenz. Du behältst volle Kontrolle über die Dateien, Logs und Prozesse – und kannst das System bei Bedarf gezielt sichern oder migrieren.

Schritt 1 – Grundsystem aktualisieren

Bevor wir mit der Installation von n8n beginnen, sorgen wir dafür, dass das Betriebssystem im Container auf dem neuesten Stand ist.
Das ist wichtig, um Fehler durch veraltete Pakete zu vermeiden und eine stabile Grundlage für die weiteren Schritte zu schaffen.

Öffne dazu in Proxmox die Shell des n8n-Containers.
Wähle in der linken Seitenleiste den Container aus und klicke auf Shell.

👉 Screenshot geeignet: Proxmox – Container ausgewählt und Konsole geöffnet

Gib anschließend den folgenden Befehl ein, um alle Paketlisten zu aktualisieren und die verfügbaren Updates zu installieren.
Starte danach den Container neu, damit die Aktualisierungen aktiv werden:

apt update && apt upgrade -y
reboot

[!NOTE] Führe diesen Schritt auch dann durch, wenn der Container gerade erst erstellt wurde.
Ein aktuelles Grundsystem verhindert spätere Konflikte bei der Installation von Node.js und n8n.

Schritt 2 – Node.js & n8n installieren

Nach dem Update ist das System bereit für die Installation der benötigten Software.
n8n basiert auf Node.js, daher müssen wir zunächst Node.js und den zugehörigen Paketmanager npm einrichten.
Anschließend installieren wir n8n selbst sowie den Prozessmanager PM2, damit n8n dauerhaft im Hintergrund laufen kann.

Benutzer wechseln

Wir installieren n8n nicht mit Administrator-Rechten, sondern unter einem eigenen Benutzerkonto.
Melde dich daher mit dem Benutzer an, den du in Schritt 1 erstellt hast:

su - n8nuser

👉 Screenshot geeignet: Konsole – Anmeldung als Benutzer n8nuser

Node.js installieren

Zuerst fügen wir das offizielle NodeSource-Repository hinzu, um die aktuelle Version (mindestens 18.x) zu erhalten, und installieren dann Node.js und npm:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

Prüfe nach der Installation die Versionen:

node -v
npm -v

Die angezeigten Versionsnummern sollten mindestens v18.x für Node.js und eine aktuelle npm-Version zeigen.

[!NOTE] Falls eine deutlich ältere Version angezeigt wird, wiederhole die Installation oder kontrolliere die Repository-Adresse.

n8n und PM2 installieren

Installiere nun n8n und den Prozessmanager PM2 global über npm:

sudo npm install -g n8n pm2

Mit PM2 stellst du sicher, dass n8n auch nach einem Neustart automatisch startet.

Überprüfe anschließend, ob n8n korrekt installiert wurde:

n8n --version

Die Ausgabe zeigt die aktuell installierte n8n-Version an.

[!TIP] PM2 sorgt dafür, dass n8n später automatisch als Hintergrunddienst läuft.
Die Konfiguration dafür nehmen wir im nächsten Schritt vor.

Schritt 3 – n8n als Dienst einrichten und starten

Damit n8n nicht nur manuell über die Konsole gestartet werden kann, richten wir den automatischen Start mit PM2 ein.
So läuft n8n dauerhaft im Hintergrund und wird bei jedem Neustart des Containers automatisch geladen.

n8n erstmals starten

Starte n8n zunächst einmalig, um sicherzustellen, dass es fehlerfrei läuft:

n8n

Die Konsole zeigt nun Startmeldungen von n8n an und wartet anschließend auf Anfragen.
Beende den Prozess wieder mit der Tastenkombination Strg + C.

👉 Screenshot geeignet: Konsole – n8n erfolgreich gestartet und wartet auf Anfragen

PM2 einrichten

Mit PM2 starten wir n8n als Hintergrundprozess:

pm2 start n8n

Damit n8n automatisch beim Systemstart geladen wird, registriere den PM2-Startdienst:

pm2 startup
sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u n8nuser --hp /home/n8nuser
pm2 save
  • pm2 startup zeigt den notwendigen Befehl für den Autostart an.
  • Mit pm2 save speicherst du die aktuelle PM2-Prozessliste.

Dienststatus prüfen

Überprüfe, ob n8n nun im Hintergrund läuft:

pm2 list

Die Ausgabe sollte den Prozess n8n mit dem Status online anzeigen.

[!NOTE] Ab diesem Punkt läuft n8n automatisch im Hintergrund und wird bei jedem Neustart des Containers selbstständig gestartet.

Schritt 4 – n8n im Nginx Proxy Manager einbinden

Öffne den Nginx Proxy Manager und lege einen neuen Proxy-Host für n8n an.

  1. Anmelden im NPM-Dashboard
    👉 Screenshot geeignet: NPM – Dashboard nach Login

  2. Klicke auf Add Proxy Host

  3. Trage im Reiter Details folgende Werte ein:

Feld Wert / Auswahl
Domain Names n8n.deinedomain.tld
Scheme http
Forward Hostname / IP IP-Adresse des n8n-Containers
Forward Port 5678
Block Common Exploits aktivieren
Websockets Support aktivieren

👉 Screenshot geeignet: Formular „Add Proxy Host“ mit IP des n8n-Containers und Port 5678

  1. Wechsle zu SSL und setze:
Feld Einstellung
Request a new SSL Certificate aktivieren
Force SSL aktivieren
HTTP/2 Support aktivieren

👉 Screenshot geeignet: SSL-Tab mit aktivierter Option „Force SSL“

  1. Klicke Save, um den Proxy-Host anzulegen.

Nach wenigen Sekunden ist n8n über die gewählte Subdomain erreichbar, z. B.:
https://n8n.deinedomain.tld

👉 Screenshot geeignet: Browser – n8n-Anmeldeseite über die Subdomain aufgerufen

[!TIP]
Falls der Zugriff auch von außen möglich sein soll, muss im Router Port 443 auf den NPM-Host weitergeleitet werden.

Schritt 5 – Vorbereitung: X-App und Credentials anlegen

In diesem Schritt richten wir die Verbindung zwischen n8n und X (ehemals Twitter) ein, damit später automatisch Beiträge gepostet werden können.

5.1 – X-Entwicklerkonto erstellen und Free-Plan aktivieren

  1. Gehe zu https://developer.x.com/ und melde dich mit deinem normalen X-Account an.
  2. Öffne im linken Menü Products → X API.
  3. Scrolle zu API Tiers & Pricing und wähle Free.
  4. Klicke auf „Sign Up for Free Account“ (der Button ist etwas unscheinbar).
  5. Im Formular die Use Cases eintragen – mindestens 250 Zeichen.
    Beispiel (englisch, ausreichend allgemein):

    We use the API to read and write posts programmatically in order to build community engagement and automate simple posting flows for our streams.

  6. Alle Häkchen für die Bedingungen setzen und die Anmeldung abschließen.

👉 Screenshot geeignet: Developer-Portal mit ausgewähltem Free-Plan

[!NOTE]
Mit dem Free-Plan steht genau eine App zur Verfügung.
Dieser Plan erlaubt bis zu 500 Posts (Write) und 100 gelesene Posts (Read) pro Monat – für Streaming-Ankündigungen reicht das in der Regel völlig aus.

5.2 – Überblick im Developer-Dashboard

Nach der Anmeldung erscheint im Dashboard → Projects & Apps automatisch ein erstes Projekt mit einer App.

👉 Screenshot geeignet: Dashboard mit Projekt-Kachel und Post-Limit-Anzeige

5.3 – Keys und Tokens vorbereiten

  1. Klicke in der App-Kachel auf das Zahnrad-Symbol → Keys and Tokens.
  2. Hier später API Key & Secret sowie Bearer Token generieren – diese brauchen wir gleich in n8n.

👉 Screenshot geeignet: Bereich „Keys and Tokens“ vor dem Generieren der Keys

[!WARNING]
Diese Schlüssel sind vertraulich und dürfen nicht öffentlich geteilt oder im Code abgelegt werden.
Speichere sie sicher ab.

5.4 – n8n-Credentials anlegen

  1. Öffne in n8n das linke Menü Credentials → + Neu.
  2. Wähle „X OAuth 2.0 API“ als Typ.
  3. Kopiere im geöffneten Fenster die angezeigte OAuth Redirect URL – diese wird gleich im Developer-Portal benötigt.
  4. Lasse dieses Credentials-Fenster in n8n geöffnet.

👉 Screenshot geeignet: n8n – neues Credentials-Fenster mit sichtbarer Redirect-URL

[!TIP]
Die Redirect-URL immer aus dem geöffneten n8n-Fenster kopieren, nicht manuell eintippen.

5.5 – User-Authentication in X einrichten

  1. Zurück im Developer-Portal → Projects & Apps → App Details wechseln.
  2. Bei User Authentication Settings auf „Set Up“ klicken.
  3. App Permissions: „Read and Write“ auswählen.
  4. Type of App: „Web App, Automated App or Bot“ auswählen.
  5. Bei Callback URL die zuvor aus n8n kopierte Redirect-URL einfügen.
  6. Bei Homepage URL die eigene Domain (z. B. https://deinedomain.tld) angeben.
  7. Save klicken und die folgende Warnung bestätigen.

👉 Screenshot geeignet: Formular „User Authentication Settings“ mit ausgewählter Berechtigung „Read and Write“ und Callback-URL

[!IMPORTANT]
Falls die Berechtigung nicht auf „Read and Write“ steht, können später keine Posts veröffentlicht werden.

5.6 – Client-Daten in n8n eintragen und Account verknüpfen

  1. Nach dem Speichern erscheinen im Developer-Portal Client ID und Client Secret.
  2. Zurück in das noch geöffnete Credentials-Fenster in n8n wechseln.
  3. Client ID und Client Secret dort eintragen.
  4. Auf „Account verknüpfen“ klicken.
  5. Es öffnet sich ein Pop-up-Fenster mit der X-Login-Seite.
  6. Mit dem normalen X-Konto anmelden und die App autorisieren.

[!WARNING]
Falls statt „Authorize App“ das X-Dashboard erscheint, das Fenster schließen und den Schritt „Account verknüpfen“ in n8n erneut ausführen.

👉 Screenshot geeignet: Pop-up mit X-Login und „Authorize App“

Damit sind die X-Credentials in n8n eingerichtet und einsatzbereit.

5.7 – Twitch-Auth-Credentials anlegen

Damit n8n die geplanten Streams abrufen kann, brauchen wir eine eigene Twitch-Anwendung mit User-Token (Authorization-Code-Flow).
Die benötigte OAuth-Redirect-URL kommt direkt aus n8n, deshalb beginnen wir dort.

5.7.1 – Redirect-URL aus n8n kopieren

  1. n8n öffnen → links Credentials → + Neu.
  2. „Twitch OAuth2 API“ als Typ auswählen.
  3. Im sich öffnenden Fenster die angezeigte OAuth Redirect URL vollständig kopieren.
  4. Fenster offenlassen, da wir gleich hierher zurückkehren.

👉 Screenshot geeignet: n8n – neues Twitch-Credential mit sichtbarer Redirect-URL

[!TIP]
Die Redirect-URL immer direkt aus n8n kopieren, nicht manuell eintippen – sonst schlägt die Authentifizierung fehl.

5.7.2 – Neue Anwendung in der Twitch-Developer-Console anlegen

  1. Twitch-Developer-Console öffnen: https://dev.twitch.tv/console/apps.
  2. Mit dem Twitch-Konto anmelden, das später für die Streams genutzt wird.
  3. Auf „Register Your Application“ klicken
    (in der deutschen Oberfläche: „Deine Anwendung registrieren“).
  4. Einen aussagekräftigen Namen vergeben, z. B. n8n-stream-schedule.
  5. Unter OAuth Redirect URLs die zuvor aus n8n kopierte URL einfügen.
  6. Unter Category „Application Integration“ auswählen.
  7. Bei Public / Öffentlich die Option „Öffentlich“ aktivieren.
  8. Auf Create klicken.

👉 Screenshot geeignet: Twitch-Developer-Console – Formular „Register Your Application / Deine Anwendung registrieren“ mit eingetragener Redirect-URL und aktivierter Option „Öffentlich“

[!IMPORTANT]
Die Redirect-URL muss exakt der aus n8n entsprechen, sonst schlägt die spätere Verknüpfung fehl.

5.7.3 – Client-ID und Secret sichern

  1. Nach dem Erstellen erscheint die Anwendung in der Übersicht.
  2. Auf Manage klicken.
  3. Die Client ID kopieren.
  4. Über New Secret einen neuen Client Secret erzeugen und kopieren.
  5. Beide Werte sicher speichern.

👉 Screenshot geeignet: Twitch-Developer-Console – App-Details mit sichtbarer Client ID und Button „New Secret“

[!WARNING]
Der Client Secret ist nur einmal sichtbar. Nicht öffentlich teilen und sicher aufbewahren.

5.7.4 – Credential in n8n fertigstellen

  1. Zurück zu n8n in das noch geöffnete Credential-Fenster wechseln.
  2. Folgende Felder ausfüllen:
    • Client ID: Wert aus der Twitch-Anwendung einfügen
    • Client Secret: Wert aus der Twitch-Anwendung einfügen
    • Auth URL: https://id.twitch.tv/oauth2/authorize
    • Access Token URL: https://id.twitch.tv/oauth2/token
    • Grant Type: Authorization Code
    • Scope: user:read:broadcast
    • Auth URI Query Parameters: leer lassen
    • Authentication: Body
  3. Auf „Account verknüpfen“ klicken.
  4. Im neuen Fenster mit dem Twitch-Konto anmelden und die Anwendung autorisieren.
  5. Falls statt „Authorize App“ das Twitch-Dashboard erscheint, Fenster schließen und den Vorgang „Account verknüpfen“ erneut ausführen.

👉 Screenshot geeignet: Twitch – OAuth-Freigabeseite mit „Authorize App“

[!NOTE]
Der Scope user:read:broadcast erlaubt n8n, die geplanten Streams des angegebenen Kanals über die Helix-API abzurufen.

5.8 – Hinweis zu Access Tokens

Mit den bisher eingerichteten Credentials für X und Twitch sind zwar die Schnittstellen verbunden, aber das reicht für den geplanten Workflow noch nicht aus.
Viele API-Endpunkte – insbesondere bei Twitch – benötigen zusätzlich einen Access Token (Bearer-Token) für jeden Abruf.

Zwar kann dieser Token theoretisch auch manuell über die Developer-Seiten erzeugt und in n8n eingetragen werden, doch solche Tokens laufen nach kurzer Zeit ab (bei Twitch z. B. meist nach 60 Tagen oder früher).
Ein händisches Nachtragen würde bedeuten, dass der Workflow regelmäßig ausfällt und manuell nachgepflegt werden muss.

[!IMPORTANT]
Wir werden deshalb im Verlauf des Workflows einen eigenen Node hinzufügen, der den Access Token automatisch anfordert und bei Bedarf erneuert.
So bleibt der Workflow stabil und benötigt keine manuelle Pflege.

Schritt 6 – Workflow in n8n aufbauen

In diesem Schritt erstellen wir den eigentlichen Workflow in n8n.
Wir fügen die benötigten Nodes hinzu und konfigurieren sie so, dass der Workflow regelmäßig die geplanten Twitch-Streams prüft und bei Bedarf automatisch Ankündigungen auf X erstellt.

6.1 – Cron Trigger (Workflow alle 30 Minuten starten)

Zweck:
Der Cron-Trigger ist der Startpunkt des Workflows.
Er sorgt dafür, dass alle 30 Minuten geprüft wird, ob ein geplanter Stream in Kürze startet.

Node-Typ: Schedule Trigger
Name: Cron – Workflow alle 30 Minuten starten

Einstellungen im Node:

  • Trigger Interval: Minutes
  • Minutes Between Triggers: 30

👉 Screenshot geeignet: n8n – Schedule Trigger mit „Trigger Interval: Minutes“ und Wert „30“

[!NOTE]
Die Zeitzone wird nicht im Node eingestellt.
Sie richtet sich nach der Workflow-Zeitzone (oben rechts im Workflow → Settings → Time Zone).
Ist dort nichts gesetzt, gilt die Zeitzone des Servers, auf dem n8n läuft.

[!TIP]
Die Intervalldauer (hier 30 Minuten) kann bei Bedarf angepasst werden. Für Ankündigungen kurz vor dem Stream reicht ein Intervall von 30 Minuten in der Regel aus.

6.2 – Code Node: Access Token prüfen

Zweck:
Dieser Node prüft bei jedem Durchlauf, ob bereits ein gültiger Twitch-Access-Token vorhanden ist und wie lange er noch gültig ist.
Wenn kein Token existiert oder die Restlaufzeit unter 24 Stunden liegt, markieren wir das für die nächste Stufe (Token erneuern).

Node-Typ: Code
Programmiersprache: JavaScript
Name: Code – Access Token prüfen

Einstellungen:

  • Language: JavaScript
  • Den folgenden Code einfügen:
// Liest gespeicherten Token aus den globalen Workflow-Daten
const sd = $getWorkflowStaticData('global');
const token = sd.twitch_token || '';
const expISO = sd.twitch_expires_at || '';
const expMs = expISO ? new Date(expISO).getTime() : 0;

const now = Date.now();
const msLeft = expMs ? (expMs - now) : 0;
const hoursLeft = msLeft > 0 ? (msLeft / (1000*60*60)) : 0;

// true, wenn kein Token vorhanden ist oder wenn er in <24h abläuft
const needsRefresh = !token || !expMs || hoursLeft < 24;

return [{
  json: {
    needsRefresh,
    token,
    expires_at: expISO,
    hoursLeft: Number(hoursLeft.toFixed(2))
  }
}];

👉 Screenshot geeignet: n8n – Code-Node mit eingefügtem JavaScript-Code

[!NOTE]
Dieser Node speichert nichts, sondern liefert nur Statusdaten (needsRefresh, hoursLeft, expires_at).
Die tatsächliche Erneuerung des Tokens erfolgt später im Workflow.

6.3 – IF Node: Access Token erneuern?

Zweck:
Dieser Node prüft, ob aus dem vorherigen Code-Node das Flag needsRefresh auf true steht.
Nur in diesem Fall wird im nächsten Schritt ein neuer Access-Token angefordert.

Node-Typ: IF
Name: IF – Access Token erneuern?

Einstellungen:

  • Conditions:
    • {{$json.needsRefresh}}
    • is true (Type: Boolean)

👉 Screenshot geeignet: n8n – IF-Node mit Bedingung {{$json.needsRefresh}} → is true (Boolean)

[!IMPORTANT]
Stelle sicher, dass der Vergleichs-Typ auf Boolean gesetzt ist, sonst wird der Wert eventuell als Text interpretiert und die Abfrage funktioniert nicht korrekt.

[!NOTE]

  • TRUE-Pfad: Token wird im nächsten Schritt erneuert.
  • FALSE-Pfad: Es wird mit dem bestehenden Token fortgefahren.

6.4 – HTTP Request: Neuen Twitch-Access-Token anfordern (TRUE-Pfad)

Zweck:
Fordert über die Twitch-API einen neuen Access-Token an, wenn der IF-Node festgestellt hat, dass keiner vorhanden ist oder der aktuelle bald abläuft.

Node-Typ: HTTP Request
Name: HTTP – Access Token anfordern

Einstellungen:

  • Method: POST
  • URL: https://id.twitch.tv/oauth2/token
  • Send Body: aktivieren
  • Content Type: Form-URL-Encoded
  • Body Parameters:
    • client_id → Wert aus den in n8n hinterlegten Twitch-Credentials
    • client_secret → Wert aus den Twitch-Credentials
    • grant_type → client_credentials

👉 Screenshot geeignet: n8n – HTTP-Request-Node mit konfigurierten Body-Parametern

[!NOTE]
Der Node gibt als Antwort ein JSON-Objekt mit access_token und expires_in zurück.
Diese Werte werden im nächsten Node gespeichert.

6.5 – Code Node: Neuen Access-Token speichern (TRUE-Pfad)

Zweck:
Speichert den vom HTTP-Request erhaltenen Twitch-Access-Token und dessen Ablaufzeitpunkt in den globalen Workflow-Daten.
So bleibt der Token auch für spätere Workflow-Durchläufe verfügbar.

Node-Typ: Code
Programmiersprache: JavaScript
Name: Code – Access Token speichern

Einstellungen:

  • Language: JavaScript
  • Den folgenden Code einfügen:
// Speichert neuen Token + Ablaufzeit in Workflow-Static-Data
const sd = $getWorkflowStaticData('global');

const access = $json.access_token;
const ttlSec = Number($json.expires_in || 0);

// Ablaufzeitpunkt berechnen und speichern
const expISO = new Date(Date.now() + ttlSec * 1000).toISOString();

sd.twitch_token = access;
sd.twitch_expires_at = expISO;

// Optional: verbleibende Stunden ausgeben
const msLeft = (new Date(expISO).getTime() - Date.now());
const hoursLeft = msLeft / (1000 * 60 * 60);

return [{
  json: {
    token: access,
    expires_at: expISO,
    hoursLeft: Number(hoursLeft.toFixed(2))
  }
}];

👉 Screenshot geeignet: n8n – Code-Node mit eingefügtem JavaScript-Code

[!NOTE]
Dieser Node speichert den neuen Token und gibt ihn zusätzlich mit seiner Restlaufzeit (hoursLeft) aus, sodass nachfolgende Nodes die Werte sofort verwenden können.

6.6 – Set Node: Token aus Cache bereitstellen (FALSE-Pfad)

Zweck:
Wenn der IF-Node feststellt, dass der vorhandene Token noch gültig ist, brauchen wir keinen neuen anzufordern.
Dieser Node liest die bereits gespeicherten Token-Daten aus den globalen Workflow-Daten und stellt sie den nachfolgenden Nodes zur Verfügung.

Node-Typ: Set
Name: Set – Token aus Cache bereitstellen

Einstellungen:

  • Mode: Add Field
  • Felder hinzufügen:
    • token → {{$json.token}}
    • expires_at → {{$json.expires_at}}
    • hoursLeft → {{$json.hoursLeft}}

👉 Screenshot geeignet: n8n – Set-Node mit eingetragenen drei Feldern (token, expires_at, hoursLeft)

[!NOTE]
Der Set-Node wird nur im FALSE-Pfad des IF-Nodes ausgeführt.
Er sorgt dafür, dass auch ohne Erneuerung dieselben Felder (token, expires_at, hoursLeft) für die nächsten Schritte bereitstehen.

6.7 – Merge Node: Token-Ströme zusammenführen

Zweck:
Führt die beiden möglichen Pfade aus dem IF-Node wieder zusammen:

  • TRUE-Pfad: liefert den neu angeforderten Token aus dem Code-Node „Access Token speichern“.
  • FALSE-Pfad: liefert den bereits vorhandenen Token aus dem Set-Node „Token aus Cache bereitstellen“.

So steht dem Workflow anschließend unabhängig vom Pfad derselbe Datensatz für die weiteren Schritte zur Verfügung.

Node-Typ: Merge
Name: Merge – Token zusammenführen

Einstellungen:

  • Mode: Append
  • Number of Inputs: 2

👉 Screenshot geeignet: n8n – Merge-Node mit „Mode: Append“ und „Number of Inputs: 2“

[!NOTE]
Da jeweils nur einer der beiden Pfade aktiv ist, genügt der Append-Modus, um den ausgegebenen Datensatz an den Hauptfluss zurückzugeben.

6.8 – HTTP Request: Twitch-Termine laden

Zweck:
Dieser Node ruft über die Twitch-Helix-API den aktuellen Stream-Zeitplan des Kanals ab, um zu prüfen, ob innerhalb der nächsten 30 Minuten ein Stream startet.

Node-Typ: HTTP Request
Name: HTTP – Twitch-Termine laden

Twitch-User-ID ermitteln (ohne Programmierung)

Die broadcaster_id ist eine numerische ID, die jedem Twitch-Kanal zugeordnet ist.
Du brauchst diese Zahl (nicht den Kanalnamen), um die API-Abfrage auszuführen.

So findest du sie leicht:

  1. Öffne im Browser die Seite
    https://streamscharts.com/tools/convert-username
  2. Gib deinen Twitch-Kanalnamen ein (z. B. bratonien_tv).
  3. Klicke auf Convert.
  4. Die angezeigte Zahl unter „Channel ID“ ist deine broadcaster_id.
  5. Kopiere diese Zahl und trage sie später im HTTP-Request-Node in das Feld broadcaster_id ein.

👉 Screenshot geeignet: StreamsCharts-Tool mit eingegebenem Kanalnamen und angezeigter Channel-ID

[!TIP]
Dieses Tool verwendet offiziell die Twitch-API, du brauchst dort keine eigenen Entwickler-Anmeldungen.

Einstellungen im Node

  • Method: GET
  • URL: https://api.twitch.tv/helix/schedule
  • Send Query: aktivieren
  • Query Parameters:
    • broadcaster_id → <Twitch-User-ID> des Kanals
    • start_time → {{$now.toUTC().startOf('day').toISO()}}
  • Send Headers: aktivieren
  • Header Parameters:
    • Authorization → Bearer {{$json.token}}
    • Client-ID → <deine Client-ID aus Twitch-Credentials>

👉 Screenshot geeignet: n8n – HTTP-Request-Node mit eingetragenen Query- und Header-Parametern

[!NOTE]
Die broadcaster_id ist die eindeutige numerische ID des Kanals.
Der Header Authorization enthält den Access-Token aus dem Merge-Node.
Der Header Client-ID ist zwingend erforderlich, sonst verweigert die Helix-API den Zugriff.

6.8 – HTTP Request: Twitch-Termine laden

Zweck:
Dieser Node ruft über die Twitch-Helix-API den aktuellen Stream-Zeitplan des Kanals ab, um zu prüfen, ob innerhalb der nächsten 30 Minuten ein Stream startet.

Node-Typ: HTTP Request
Name: HTTP – Twitch-Termine laden

Twitch-User-ID ermitteln (ohne Programmierung)

Die broadcaster_id ist eine numerische ID, die jedem Twitch-Kanal zugeordnet ist.
Du brauchst diese Zahl (nicht den Kanalnamen), um die API-Abfrage auszuführen.

So findest du sie leicht:

  1. Öffne im Browser die Seite
    https://streamscharts.com/tools/convert-username
  2. Gib deinen Twitch-Kanalnamen ein (z. B. bratonien_tv).
  3. Klicke auf Convert.
  4. Die angezeigte Zahl unter „Channel ID“ ist deine broadcaster_id.
  5. Kopiere diese Zahl und trage sie später im HTTP-Request-Node in das Feld broadcaster_id ein.

👉 Screenshot geeignet: StreamsCharts-Tool mit eingegebenem Kanalnamen und angezeigter Channel-ID

[!TIP]
Dieses Tool verwendet offiziell die Twitch-API und erfordert keine eigenen Entwickler-Anmeldungen.

Einstellungen im Node

  • Method: GET
  • URL: https://api.twitch.tv/helix/schedule
  • Authentication: Generic Credential Type
  • Generic Auth Type: OAuth2 API → wähle hier die zuvor in n8n angelegten Twitch-Credentials aus
  • Send Query Parameters: aktivieren
  • Query Parameters:
    • Name: broadcaster_id → <deine Twitch-User-ID>
    • Name: start_time → {{ $now.toUTC().startOf('day').toISO() }}
  • Send Headers: aktivieren
  • Header Parameters:
    • Name: Client-ID → <deine Client-ID aus den Twitch-Credentials>

👉 Screenshot geeignet: n8n – HTTP-Request-Node mit allen sichtbaren Parametern wie auf den beiden Referenz-Screenshots

[!NOTE]
Der Access-Token wird über die ausgewählte OAuth2-Credential automatisch mitgesendet.
Zusätzlich ist nur der Client-ID-Header notwendig.
Die Option Never Error bleibt deaktiviert, da sie hier nicht benötigt wird.

6.9 – Code-Node: „Parse ICS“

Zweck:
Dieser Node verarbeitet die Antwort des Nodes „Twitch-Termine laden“.
Er liest das JSON aus der Helix-API und erzeugt für jedes Stream-Segment ein einheitliches Objekt mit Start- und Endzeit, Titel, Beschreibung und einer Hash-ID.
So können wir die Termine später leichter filtern und weiterverarbeiten.

Node-Typ: Code
Name: Parse ICS

👉 Screenshot geeignet: n8n – geöffneter Code-Node mit eingefügtem Skript

Node-Einstellungen

  • Programming Language: JavaScript
  • Weitere Einstellungen bleiben auf Standard.

Eingabe

Der Node erwartet die Antwort des HTTP-Requests „Twitch-Termine laden“.
Der Inhalt liegt meist als Text-String in items[0].json.body vor.

Code-Inhalt

Kopiere den folgenden Code komplett in das Editorfeld des Code-Nodes:

/**
 * INPUT:  items[0].json  ODER items[0].json.body (String) vom HTTP Request /helix/schedule
 * OUTPUT: pro Segment ein Item in folgendem Schema:
 *   { uid, cancelled, title, description, startIso, endIso, tz, hash }
 */

const input = items[0]?.json ?? {};
let payload;

if (typeof input.body === 'string') {
  // HTTP-Node hat "Response Format: Text" -> JSON-String in body
  try { payload = JSON.parse(input.body); }
  catch (e) { throw new Error('HTTP body ist kein gültiges JSON'); }
} else if (input.data) {
  // HTTP-Node hat "Response Format: JSON"
  payload = input;
} else if (typeof input === 'string') {
  payload = JSON.parse(input);
} else {
  throw new Error('Unerwartete Eingabeform. Erwartet JSON oder body-String.');
}

const segments = Array.isArray(payload.data?.segments) ? payload.data.segments : [];

// Hash für eindeutige Segmentkennung
function hashHex(s) {
  let h = 5381;
  for (let i = 0; i < s.length; i++) h = ((h << 5) + h) ^ s.charCodeAt(i);
  return (h >>> 0).toString(16).padStart(8, '0');
}

function buildTitle() { return 'Streamtime'; }

function buildDesc(seg) {
  const lines = [];
  if (seg.title) lines.push(`Originaltitel: ${seg.title}`);
  if (seg.category?.name) lines.push(`Kategorie/Game: ${seg.category.name}`);
  return lines.join('\n');
}

const tz = 'Europe/Berlin';

const out = segments.map(seg => {
  const startIso = seg.start_time; // ISO-UTC laut Twitch
  const endIso   = seg.end_time;
  const title = buildTitle();
  const description = buildDesc(seg);
  const hash = hashHex(`${title}|${startIso}|${endIso}|${description}`);

  return {
    json: {
      uid: seg.id,
      cancelled: Boolean(seg.canceled_until),
      title, description,
      startIso, endIso, tz,
      hash
    }
  };
});

return out;

[!NOTE]

  • tz ist fest auf Europe/Berlin gesetzt, kann aber bei Bedarf angepasst werden.
  • Das Feld cancelled wird genutzt, um abgesagte Streams zu kennzeichnen.
  • Jeder Stream-Eintrag erhält einen Hash, der später als eindeutiger Schlüssel dient.