Kapitel 13/Tutorial.md aktualisiert
This commit is contained in:
@@ -190,3 +190,157 @@ Inhalt:
|
|||||||
---
|
---
|
||||||
|
|
||||||
Damit ist der Clipper-LXC vorbereitet: Benutzer, Verzeichnisse, Pakete, Konfiguration und Einstiegsskripte sind eingerichtet. In den nächsten Abschnitten bauen wir die Anbindung an Twitch/n8n, implementieren die Analyse-Logik (inklusive Facecam, Hochformat und Untertitel) und fügen den eigentlichen Schnitt hinzu, bevor alles sauber in Nextcloud abgelegt wird.
|
Damit ist der Clipper-LXC vorbereitet: Benutzer, Verzeichnisse, Pakete, Konfiguration und Einstiegsskripte sind eingerichtet. In den nächsten Abschnitten bauen wir die Anbindung an Twitch/n8n, implementieren die Analyse-Logik (inklusive Facecam, Hochformat und Untertitel) und fügen den eigentlichen Schnitt hinzu, bevor alles sauber in Nextcloud abgelegt wird.
|
||||||
|
|
||||||
|
|
||||||
|
## Abschnitt 3 – n8n ↔ Twitch: VOD & Clips importieren, in Nextcloud ablegen, Clipper starten
|
||||||
|
|
||||||
|
In diesem Abschnitt verbinden wir n8n mit Twitch, Nextcloud und dem Clipper. Das Ziel: n8n erkennt automatisch neue VODs auf Twitch, lädt sie zusammen mit Clips herunter, legt sie in Nextcloud ab und startet dann die Analyse auf dem Clipper. Wir gehen Schritt für Schritt vor – immer mit klaren Hinweisen, ob wir uns gerade in der **n8n‑Weboberfläche**, im **Terminal** oder in **Nextcloud** befinden.
|
||||||
|
|
||||||
|
> **Entscheidung & Begründung – Rollenverteilung**
|
||||||
|
> **n8n** steuert (APIs, Logik, Benachrichtigungen). **Clipper** arbeitet (Download, Analyse, Schnitt). **Nextcloud** speichert (Archiv & Übergabe). So bleibt n8n schlank und ausfallsicher, während Clipper CPU/IO für Medienjobs bekommt.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Schritt 1: Zugriff zwischen den Containern vorbereiten (Terminal)
|
||||||
|
|
||||||
|
Melde dich zuerst im **Terminal deines n8n‑LXC** an. Wir richten hier die Verbindung zum Clipper und zu Nextcloud ein.
|
||||||
|
|
||||||
|
**SSH‑Schlüssel für Clipper erzeugen:**
|
||||||
|
```bash
|
||||||
|
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ""
|
||||||
|
ssh-copy-id clipper@<CLIPPER-IP>
|
||||||
|
ssh clipper@<CLIPPER-IP> "echo OK"
|
||||||
|
```
|
||||||
|
Ersetze `<CLIPPER-IP>` durch die IP/den Hostnamen deines Clipper‑LXC (z. B. `10.0.0.42`). Wenn **OK** erscheint, kann n8n ohne Passwort auf den Clipper zugreifen.
|
||||||
|
|
||||||
|
**App‑Passwort für Nextcloud:**
|
||||||
|
Melde dich nun in der **Nextcloud‑Weboberfläche** an. Gehe in dein Benutzerprofil → *Sicherheit* → *App‑Passwörter* und erzeuge ein neues Passwort. Notiere dir Benutzername + App‑Passwort. Diese nutzt n8n später für den Upload via WebDAV. Die Adresse sieht so aus:
|
||||||
|
```
|
||||||
|
https://<DEINE_NEXTCLOUD_DOMAIN>/remote.php/dav/files/<DEIN_NC_BENUTZER>/
|
||||||
|
```
|
||||||
|
Beispiel: `https://cloud.example.com/remote.php/dav/files/streamer/`
|
||||||
|
|
||||||
|
**Twitch‑API Zugang:**
|
||||||
|
Gehe in die [Twitch Developer Console](https://dev.twitch.tv/console), lege eine App an und notiere **Client ID** und **Client Secret**. Danach öffne die **n8n‑Weboberfläche** in deinem Browser (`http://<DEINE_N8N_DOMAIN>:5678`), melde dich an und gehe links auf **Credentials** → **+ Add Credential** → *OAuth2 API*.
|
||||||
|
|
||||||
|
- Grant Type: *Client Credentials*
|
||||||
|
- Access Token URL: `https://id.twitch.tv/oauth2/token`
|
||||||
|
- Client ID / Secret eintragen
|
||||||
|
- Speichern und testen.
|
||||||
|
|
||||||
|
Referenz: [Twitch Auth‑Doku](https://dev.twitch.tv/docs/authentication)
|
||||||
|
|
||||||
|
> **Entscheidung & Begründung – Warum Client‑Credentials?**
|
||||||
|
> Für **Get Users**, **Get Videos**, **Get Clips** reicht ein App‑Token. Der Flow ist stabil, ohne User‑Login/Refresh‑Token‑Pflege.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Schritt 2: Twitch‑User‑ID herausfinden (n8n‑Weboberfläche)
|
||||||
|
|
||||||
|
Die Twitch‑API benötigt deine **numerische User‑ID**, nicht den Login‑Namen. Wir holen diese ID einmalig in n8n.
|
||||||
|
|
||||||
|
1. Gehe in der n8n‑Weboberfläche auf **Workflows** → **+ New Workflow**.
|
||||||
|
2. Ziehe einen **HTTP Request Node** auf die Arbeitsfläche.
|
||||||
|
3. Konfiguriere ihn so:
|
||||||
|
- Methode: GET
|
||||||
|
- URL: `https://api.twitch.tv/helix/users?login=<DEIN_LOGIN>`
|
||||||
|
- Authentifizierung: OAuth2 Credential (aus Schritt 1)
|
||||||
|
- Header: `Client-Id: <DEINE_CLIENT_ID>`
|
||||||
|
4. Klicke auf **Execute Node**.
|
||||||
|
5. Im Ergebnis findest du im Feld `data[0].id` deine **User‑ID** (z. B. `123456789`). Diese Zahl ist entscheidend und ersetzt ab jetzt `<DEINE_TWITCH_USER_ID>` in allen weiteren Schritten.
|
||||||
|
|
||||||
|
Referenz: [Get Users](https://dev.twitch.tv/docs/api/reference#get-users)
|
||||||
|
|
||||||
|
> **Entscheidung & Begründung – Login vs. User‑ID**
|
||||||
|
> Der „Login“ ist nur ein Anzeigename. Die API filtert zuverlässig über die **numerische ID** – deshalb holen wir sie einmalig und verwenden sie konsequent.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Schritt 3: Workflow bauen (n8n‑Weboberfläche)
|
||||||
|
|
||||||
|
Jetzt bauen wir den eigentlichen Workflow, der regelmäßig neue VODs prüft, herunterlädt und ablegt.
|
||||||
|
|
||||||
|
1. **Cron‑Trigger anlegen:**
|
||||||
|
- Ziehe einen **Cron Node** auf die Arbeitsfläche.
|
||||||
|
- Stelle ihn auf „Every 10 minutes“.
|
||||||
|
Damit prüft n8n alle 10 Minuten auf neue VODs.
|
||||||
|
|
||||||
|
2. **VOD‑Daten abrufen:**
|
||||||
|
- Ziehe einen weiteren **HTTP Request Node** an den Cron‑Node.
|
||||||
|
- URL:
|
||||||
|
```
|
||||||
|
https://api.twitch.tv/helix/videos?user_id=<DEINE_TWITCH_USER_ID>&type=archive&first=1
|
||||||
|
```
|
||||||
|
- Auth: OAuth2 Credential
|
||||||
|
- Header: `Client-Id: <DEINE_CLIENT_ID>`
|
||||||
|
- Ergebnis: In `data[0]` stehen `id`, `title`, `url`, `created_at`, `published_at`.
|
||||||
|
|
||||||
|
Referenz: [Get Videos](https://dev.twitch.tv/docs/api/reference#get-videos)
|
||||||
|
|
||||||
|
3. **Clips abrufen (optional):**
|
||||||
|
- Ziehe einen weiteren **HTTP Request Node** an.
|
||||||
|
- URL:
|
||||||
|
```
|
||||||
|
https://api.twitch.tv/helix/clips?broadcaster_id=<DEINE_TWITCH_USER_ID>&started_at=<created_at>&ended_at=<published_at>
|
||||||
|
```
|
||||||
|
- Ergebnis: Liste mit Clips, die im Zeitraum des VOD erstellt wurden.
|
||||||
|
|
||||||
|
Referenz: [Get Clips](https://dev.twitch.tv/docs/api/reference#get-clips)
|
||||||
|
|
||||||
|
4. **VOD herunterladen (Terminal im Clipper‑LXC):**
|
||||||
|
Jetzt wechselst du ins **Terminal des Clipper‑LXC**. Stelle sicher, dass `yt-dlp` installiert ist (`apt install -y yt-dlp`). n8n ruft per SSH folgenden Befehl auf:
|
||||||
|
```bash
|
||||||
|
mkdir -p "/srv/clipper/inbox/{{ $json.data[0].id }}"
|
||||||
|
yt-dlp -o "/srv/clipper/inbox/{{ $json.data[0].id }}/%(title)s.%(ext)s" {{ $json.data[0].url }}
|
||||||
|
```
|
||||||
|
Damit entsteht ein Unterordner `/srv/clipper/inbox/<VOD-ID>/` mit dem Video.
|
||||||
|
|
||||||
|
> **Entscheidung & Begründung – Warum lädt *Clipper* (und nicht *n8n*)?**
|
||||||
|
> VODs kommen als **HLS‑Streams** (m3u8, segmentiert, signiert). Ein robuster Download braucht **yt‑dlp/ffmpeg** mit Retry/Resume und I/O‑Puffer. Das ist CPU/IO‑lastig und gehört auf die **Werkbank** (Clipper), nicht in die **Steuerzentrale** (n8n). So bleibt n8n stabil und reagiert weiter auf Webhooks.
|
||||||
|
|
||||||
|
5. **Clips herunterladen (Terminal im Clipper‑LXC, optional):**
|
||||||
|
Für jeden Clip‑URL ruft n8n per SSH `yt-dlp` auf:
|
||||||
|
```bash
|
||||||
|
yt-dlp -o "/srv/clipper/inbox/<CLIP_ID>/%(title)s.%(ext)s" https://clips.twitch.tv/<CLIP_ID>
|
||||||
|
```
|
||||||
|
|
||||||
|
6. **Upload nach Nextcloud (n8n‑Weboberfläche):**
|
||||||
|
- Ziehe einen **HTTP Request Node** auf die Arbeitsfläche.
|
||||||
|
- Methode: **PUT**
|
||||||
|
- Auth: **Basic Auth** (Benutzername + App‑Passwort aus Schritt 1)
|
||||||
|
- URL:
|
||||||
|
```
|
||||||
|
https://<DEINE_NEXTCLOUD_DOMAIN>/remote.php/dav/files/<DEIN_NC_BENUTZER>/Clips/{{ $json.data[0].id }}/<Dateiname>
|
||||||
|
```
|
||||||
|
- Ergebnis: In Nextcloud liegt danach ein Ordner `Clips/<VOD-ID>/…`.
|
||||||
|
|
||||||
|
> **Entscheidung & Begründung – Warum Nextcloud?**
|
||||||
|
> Zentrales, versionierbares Speicherziel mit Freigaben/Quotas/Backups. Clipper und andere Systeme können darauf zugreifen, ohne erneut von Twitch laden zu müssen.
|
||||||
|
|
||||||
|
7. **Analyse starten (Terminal im Clipper‑LXC):**
|
||||||
|
Zum Abschluss ruft n8n per SSH das Skript `clipper-analyze` auf:
|
||||||
|
```bash
|
||||||
|
/srv/clipper/bin/clipper-analyze \
|
||||||
|
"/srv/clipper/inbox/{{ $json.data[0].id }}/{{ $json.data[0].title }}.mp4" \
|
||||||
|
"vod-{{ $json.data[0].id }}"
|
||||||
|
```
|
||||||
|
Das Skript erzeugt im Clipper‑Temp‑Ordner eine `candidates.json`. Mit dieser arbeiten wir in Abschnitt 4 weiter.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Alternative: Twitch‑Community‑Node (n8n‑Weboberfläche)
|
||||||
|
|
||||||
|
Wenn du statt HTTP Requests lieber einen fertigen Twitch‑Node nutzen willst, kannst du in self‑hosted n8n einen **Community‑Node** installieren. Die Anleitung: [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/). Beachte: Community‑Nodes sind Drittanbieter‑Code und können bei Updates Probleme machen. Für einen stabilen Dauerbetrieb empfehlen wir den API‑Weg mit HTTP Request.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Kontrolle
|
||||||
|
|
||||||
|
Nach einem erfolgreichen Durchlauf prüfst du im **Terminal des Clipper‑LXC**:
|
||||||
|
```bash
|
||||||
|
su - clipper
|
||||||
|
ls -lh /srv/clipper/inbox/<VOD-ID>
|
||||||
|
|
||||||
|
tail -n 50 /srv/clipper/logs/clipper.log
|
||||||
|
```
|
||||||
|
Und in der **Nextcloud‑Weboberfläche** solltest du den Ordner `Clips/<VOD-ID>` sehen. Damit ist die Pipeline geschlossen: Twitch liefert VODs, n8n steuert den Ablauf, Clipper verarbeitet, Nextcloud speichert. In Abschnitt 4 gehen wir in die Analyse‑Logik und die KI‑Auswertung.
|
||||||
|
|||||||
Reference in New Issue
Block a user