From 15ddad8516264cb9a8cbbde79c739bcccf961ddf Mon Sep 17 00:00:00 2001 From: Thomas Dannenberg Date: Sun, 24 Aug 2025 11:59:01 +0000 Subject: [PATCH] Kapitel 13/README.md aktualisiert --- Kapitel 13/README.md | 53 +++++++++++++++++++++++--------------------- 1 file changed, 28 insertions(+), 25 deletions(-) diff --git a/Kapitel 13/README.md b/Kapitel 13/README.md index 83edc02..44144d3 100644 --- a/Kapitel 13/README.md +++ b/Kapitel 13/README.md @@ -1,38 +1,41 @@ -# Kapitel 13 – Clipper (serverseitiger Video-Schnitt für Highlights) +# Kapitel 13 – Clipper (automatisierte Highlight-Erstellung) ## Einleitung -Clips sind Reichweiten-Booster: Aus langen Streams oder VODs entstehen kurze Highlights für Shorts/Reels/TikTok. Der Clipper läuft als eigener LXC-Dienst und erstellt automatisiert Ausschnitte – wahlweise aus einem überwachten **Nextcloud-Ordner** (empfohlen) oder, optional, aus VODs des RTMP-Servers. So brauchst du keinen RTMP-Server, wenn du deine Videos einfach in die Nextcloud legst. +Lange Streams bringen wenig Reichweite, kurze Highlights dagegen enorme Aufmerksamkeit. +Mit dem Clipper bauen wir ein System, das eingehende Videos automatisch analysiert, sinnvolle Highlight-Punkte erkennt und fertige Clips erstellt. +Die Steuerung übernimmt n8n: Es stößt Clipper nur bei Bedarf an, wertet die Analyse (z. B. KI + Szenenerkennung) aus und legt die fertigen Clips mitsamt automatisch erzeugten Titeln & Hashtags für alle Plattformen in Nextcloud ab. ## Voraussetzungen - Proxmox LXC mit **Debian 12 (Bookworm)** -- Grundkenntnisse Shell (`ssh`, `nano`) -- ca. 10 GB freier Speicher für temporäre Dateien -- **Pflicht:** Nextcloud-Ordner, auf den der LXC zugreifen kann (WebDAV oder lokales Mount) -- **Optional:** RTMP-Server (falls direkt aus VODs geschnitten werden soll) -- **Optional:** Nginx Proxy Manager für internen Webzugriff (LAN/VPN) +- Installierte Nextcloud (Pflicht, als Ablageort für Clips) +- Optional: RTMP-Server für VODs (alternativ reine Dateiablage in Nextcloud) +- n8n-Instanz zur Automatisierung (Start/Stopp Clipper, Analyse, Metadaten-Generierung) +- Grundwissen: Basisbefehle (`ssh`, `nano`), Verständnis für LXC ## Ziel -- LXC `clipper` mit **ffmpeg** -- Ordnerstruktur: `/watch` (Eingang, z. B. Nextcloud-Mount), `/out`, `/temp`, `/logs` -- Automatischer Watch-Modus: neue Dateien in `/watch` werden verarbeitet -- Optionaler HTTP-Endpoint (POST `/clip`) für manuelle/automatisierte Jobs -- Verlustfreier Smart-Copy-Schnitt bei H.264/AAC; sauberer Re-Encode-Fallback bei Bedarf -- Einheitliche Dateinamen (Titel, Dauer, Zeitstempel) +- Vollautomatisierte Highlight-Erstellung aus langen Videos +- Clipper läuft nur bei Bedarf (n8n startet/stoppt den Dienst) +- Analyse kombiniert: Szenenerkennung + KI-Vorschläge → Schnittpunkte +- Deckungsgleiche Treffer (±5 Sekunden) werden als Clips exportiert +- Neben jedem Clip entsteht eine Textdatei mit Titel & Hashtags pro Plattform (YouTube, TikTok, Instagram, Facebook, …) +- Plattformen sind in n8n erweiterbar, ohne das Clipper-System ändern zu müssen ## Ablauf -1. LXC „clipper“ anlegen (Debian 12, 1 vCPU, 512 MB RAM, 8–16 GB Disk). -2. System vorbereiten (Update, Zeitsync, Basis-Tools). -3. **ffmpeg** installieren und prüfen. -4. Ordnerstruktur anlegen; Log-Rotation aktivieren. -5. Nextcloud-Ordner einbinden (WebDAV-Mount oder lokaler Share) → `/watch`. -6. Optional: RTMP-VOD-Ordner zusätzlich anbinden. -7. Watch-Script/Dienst aktivieren (erkennt neue Dateien, schneidet Clips, legt sie in `/out` ab). -8. Test-Clip erzeugen und Ergebnis prüfen. +1. Video landet in Nextcloud (oder optional über RTMP). +2. n8n erkennt neue Datei, prüft Upload-Abschluss. +3. n8n startet Clipper, Analyse beginnt. +4. Clipper liefert Schnitt-Vorschläge (Szenen, Audio-Peaks). +5. n8n ergänzt KI-Analyse und gleicht Ergebnisse ab. +6. Deckende Vorschläge werden geschnitten, Clips exportiert. +7. n8n erzeugt automatisch Titel + Hashtags pro Plattform und speichert sie in Textdateien neben den Clips. +8. Clips + Metadaten landen in einem eigenen Unterordner der Nextcloud. +9. n8n stoppt Clipper wieder, um Ressourcen zu sparen. ## Ergebnis -- Clips werden serverseitig erstellt, landen automatisch in `/out` und sind sofort upload-fertig (MP4, H.264/AAC). -- Stabiler Betrieb mit Logs/Exit-Codes, geeignet für spätere Automatisierung. +- Fertige Highlight-Clips liegen samt Metadaten-Dateien strukturiert in Nextcloud. +- Keine manuelle Bearbeitung nötig – nur Sichtkontrolle. +- Clipper wird nur aktiv, wenn wirklich eine neue Datei verarbeitet werden soll. ## Weiterführend -- Vorher sinnvoll: **n8n (Kapitel 11)** *bereits erledigt*, **RTMP (Kapitel 12)** *optional*. -- **Nächstes Kapitel:** **Backup (Basis, privat)** – damit Ergebnisse & Konfigurationen sicher sind. +- Vorheriges Kapitel: **RTMP (Kapitel 12)** – optional als Quelle +- Nächstes Kapitel: **Backup (Basis, privat)** – Sicherung von Clips & Konfiguration