Kapitel 13/README.md aktualisiert

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`)  
+- Installierte Nextcloud (Pflicht, als Ablageort für Clips)  
-- ca. 10 GB freier Speicher für temporäre Dateien  
+- Optional: RTMP-Server für VODs (alternativ reine Dateiablage in Nextcloud)  
-- **Pflicht:** Nextcloud-Ordner, auf den der LXC zugreifen kann (WebDAV oder lokales Mount)  
+- n8n-Instanz zur Automatisierung (Start/Stopp Clipper, Analyse, Metadaten-Generierung)  
-- **Optional:** RTMP-Server (falls direkt aus VODs geschnitten werden soll)  
+- Grundwissen: Basisbefehle (`ssh`, `nano`), Verständnis für LXC  
-- **Optional:** Nginx Proxy Manager für internen Webzugriff (LAN/VPN)
 
 ## Ziel  
-- LXC `clipper` mit **ffmpeg**  
+- Vollautomatisierte Highlight-Erstellung aus langen Videos  
-- Ordnerstruktur: `/watch` (Eingang, z. B. Nextcloud-Mount), `/out`, `/temp`, `/logs`  
+- Clipper läuft nur bei Bedarf (n8n startet/stoppt den Dienst)  
-- Automatischer Watch-Modus: neue Dateien in `/watch` werden verarbeitet  
+- Analyse kombiniert: Szenenerkennung + KI-Vorschläge → Schnittpunkte  
-- Optionaler HTTP-Endpoint (POST `/clip`) für manuelle/automatisierte Jobs  
+- Deckungsgleiche Treffer (±5 Sekunden) werden als Clips exportiert  
-- Verlustfreier Smart-Copy-Schnitt bei H.264/AAC; sauberer Re-Encode-Fallback bei Bedarf  
+- Neben jedem Clip entsteht eine Textdatei mit Titel & Hashtags pro Plattform (YouTube, TikTok, Instagram, Facebook, …)  
-- Einheitliche Dateinamen (Titel, Dauer, Zeitstempel)
+- 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).  
+1. Video landet in Nextcloud (oder optional über RTMP).  
-2. System vorbereiten (Update, Zeitsync, Basis-Tools).  
+2. n8n erkennt neue Datei, prüft Upload-Abschluss.  
-3. **ffmpeg** installieren und prüfen.  
+3. n8n startet Clipper, Analyse beginnt.  
-4. Ordnerstruktur anlegen; Log-Rotation aktivieren.  
+4. Clipper liefert Schnitt-Vorschläge (Szenen, Audio-Peaks).  
-5. Nextcloud-Ordner einbinden (WebDAV-Mount oder lokaler Share) → `/watch`.  
+5. n8n ergänzt KI-Analyse und gleicht Ergebnisse ab.  
-6. Optional: RTMP-VOD-Ordner zusätzlich anbinden.  
+6. Deckende Vorschläge werden geschnitten, Clips exportiert.  
-7. Watch-Script/Dienst aktivieren (erkennt neue Dateien, schneidet Clips, legt sie in `/out` ab).  
+7. n8n erzeugt automatisch Titel + Hashtags pro Plattform und speichert sie in Textdateien neben den Clips.  
-8. Test-Clip erzeugen und Ergebnis prüfen.
+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).  
+- Fertige Highlight-Clips liegen samt Metadaten-Dateien strukturiert in Nextcloud.  
-- Stabiler Betrieb mit Logs/Exit-Codes, geeignet für spätere Automatisierung.
+- 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*.  
+- Vorheriges Kapitel: **RTMP (Kapitel 12)** – optional als Quelle  
-- **Nächstes Kapitel:** **Backup (Basis, privat)** – damit Ergebnisse & Konfigurationen sicher sind.
+- Nächstes Kapitel: **Backup (Basis, privat)** – Sicherung von Clips & Konfiguration