lesliedominguezriquezaacademy-creator/edicion-reels-nivel-1

Reel-Bearbeitung – Stufe 1 (Clean & Minimal)

Wandelt ein in 01-crudo/ aufgenommenes Video in ein vertikales 9:16-Reel um, sauber und bereit zur Überprüfung: ohne Stille, mit Karaoke-Untertiteln, dezenter Bewegung und Ausblendeffekt.

Grundregel: zuerst ein ENTWURF; die endgültige Version wird erst erstellt, nachdem die Person ihn genehmigt hat. Verwende niemals kostenpflichtige Dienste ohne vorherige Nachfrage.

Der gesamte Prozess ist lokal und kostenlos (Python + FFmpeg + Whisper). Die Skripte befinden sich bereits in scripts/. Schreibe sie nicht neu: verwende sie.

---

Schritt 0 – Werkzeuge vorbereiten (nur beim ersten Mal)

Führe zuerst python scripts/verificar_entorno.py aus: es prüft Python, FFmpeg (mit den vom Kit verwendeten Filtern) und Whisper und gibt an, was fehlt. Wenn alles OK ist, fahre mit Schritt 1 fort. Wenn nicht, behebe das Problem mit den unten stehenden Befehlen. Überprüfe stillschweigend, ob sie existieren. Wenn etwas fehlt, installiere es mit einer freundlichen Nachricht („Ich bereite die Werkzeuge vor, das dauert beim ersten Mal ein paar Minuten“):

python --version
ffmpeg -version
ffprobe -version
python -c "import whisper"

Wenn etwas fehlt:

• Python: Bitte die Person, es von python.org zu installieren („Add Python to PATH“ aktivieren) und das Terminal neu zu starten.
• FFmpeg (Windows): winget install Gyan.FFmpeg – dann Terminal neustarten. Auf dem Mac: brew install ffmpeg.
• Whisper: pip install openai-whisper (lädt beim ersten Mal das Modell small herunter, es ist kostenlos und läuft auf ihrem Computer).

Wenn etwas nicht installiert werden kann, blockiere nicht: erkläre, was fehlt, und biete die einfachste Alternative an.

Schritt 1 – Material prüfen

1. Liste auf, was in 01-crudo/ ist (und Ressourcen in 02-assets/).
2. Wenn es ein einzelnes Video gibt, verwende es. Wenn es mehrere gibt, frage welches. Wenn der Ordner leer ist, bitte die Person, ihr Video dorthin zu kopieren.
3. Bestätige Dauer und ob es Audio hat:

   ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "01-crudo/NAME.mp4"
   

4. Stelle maximal eine Frage zu Präferenzen, nur wenn nötig (z. B.: Gibt es Füllwörter, die sie von Hand schneiden möchte?). Wenn nicht, fahre mit den Standardwerten fort.

Schritt 2 – Den ENTWURF erstellen

Führe die gesamte Pipeline aus (transkribieren → Stille entfernen → vertikal exportieren):

python scripts/pipeline.py "01-crudo/NAME.mp4"

Was jeder Schritt macht (falls du sie einzeln ausführen oder anpassen musst):

Schritt	Skript	Ergebnis
Transkription mit Whisper (small, Wort-Zeitstempel)	scripts/transcribir.py	02-assets/subtitulos/NAME.srt und .words.json
Stille entfernen (> 0,5 s bei -35 dB)	scripts/limpiar_silencios.py	02-assets/sin_silencios/NAME.mp4 und .timeline.json
9:16 exportieren mit Untertiteln, Zoom und Ausblende	scripts/exportar_reel.py	03-output/NAME.mp4

Verfügbare Anpassungen in limpiar_silencios.py (verwende sie nur, wenn die Person es verlangt oder das Ergebnis es erfordert):

• --silence-duration 0.35 → schneidet kürzere Pausen (schnelleres Tempo).
• --cut-range ANFANG ENDE (wiederholbar) → schneidet einen exakten Abschnitt in Sekunden des Originalvideos. Dies ist die Möglichkeit, Füllwörter („äh“, „mmm“, „also“) oder Fehlaufnahmen zu entfernen: lies sie in 02-assets/subtitulos/NAME.words.json, finde ihre Zeitstempel und übergib sie als Bereiche. Zeige der Person die Liste der Schnitte an, bevor du sie anwendest, wenn es mehr als ein paar sind.
• --speed-range ANFANG ENDE GESCHWINDIGKEIT (wiederholbar) → andere Geschwindigkeit in einem Abschnitt (Sekunden des Originals), z. B. --speed 1.32 --speed-range 13 21.8 1.5. Verwende es, um langsame oder erklärende Teile mehr zu beschleunigen und wichtige normal zu lassen. Wenn die Person eine maximale Dauer (z. B. 55 s) verlangt, passe --speed an, bis es erfüllt ist, und messe mit ffprobe.
• --speed 1.1 → beschleunigt leicht, behält die Tonhöhe (zwischen 0,5 und 2,0). Verwende es nur, wenn verlangt.

Um nur den Bereinigungsschritt mit Anpassungen erneut auszuführen und dann zu exportieren:

python scripts/limpiar_silencios.py "01-crudo/NAME.mp4" --cut-range 12.4 13.1
python scripts/exportar_reel.py "02-assets/sin_silencios/NAME.mp4" "02-assets/subtitulos/NAME.srt" --output "03-output/NAME_draft.mp4"

Speichere den Entwurf mit dem Suffix _draft (und _draft2, _draft3 … bei weiteren Iterationen), um ältere Versionen nicht zu überschreiben. Wenn du pipeline.py verwendet hast, benenne die Ausgabe in NAME_draft.mp4 um.

Stilstandard (bereits in die Skripte eingebaut – ändere ihn nicht ohne Aufforderung)

• Format: vertikal 9:16, 1080×1920, 30 fps.
• Karaoke-Untertitel: warmweißer Text, aktives Wort in sanftem Gold, durchscheinender dezenter marineblauer Hintergrund, maximal zwei Zeilen, innerhalb der sicheren Zone (fern vom unteren Rand und den App-Buttons).
• Bewegung: sanftes Zoom und Schwenken, maximal 2,5 %. Keine Effekte stapeln oder Grafiken auf bereits überladene Bilder legen.
• Ende: Ausblende-Effekt (Bild und Audio).
• Audio: original, sauber, normalisiert auf -14 LUFS, ohne hinzugefügte Musik oder dekorative Effekte (das Start-Sound ist optional und personenspezifisch, siehe unten).
• Rhythmus: komprimierte Highlights; wenn die Person Schlüsselwörter hervorheben möchte, verwende die goldene Farbe, ohne zu überladen.

Eigenes Start-Sound (optional)

Standardmäßig hat das Reel keinen hinzugefügten Sound. Wenn die Person eine akustische Marke am Anfang möchte, muss es ihre eigene sein: frage sie, ob sie bereits eine Datei (.wav oder .mp3) hat, oder hilf ihr, eine eigene zu erstellen (z. B. mit FFmpeg oder Python synthetisieren, oder mit einer Ressource, die sie verwenden darf). Dann wird es unter die Stimpe gemischt:

python scripts/exportar_reel.py "02-assets/sin_silencios/NAME.mp4" "02-assets/subtitulos/NAME.srt" --sonido "pfad/zu/meinem_sound.wav" --output "03-output/NAME_draft.mp4"

• Wenn es die Stimpe überdeckt, senke SOUND_VOLUME (Standard 0,55) in scripts/exportar_reel.py.
• Lade keine Sounds von Drittanbietern oder kostenpflichtige herunter, ohne zu fragen und zu bestätigen, dass sie verwendet werden dürfen.

Schritt 3 – Den Entwurf vor der Übergabe überprüfen

Bevor du sagst, dass er fertig ist:

1. Bestätige, dass die Datei in 03-output/ existiert, und miss ihre Dauer mit ffprobe.
2. Extrahiere 2–3 Frames, um zu überprüfen, ob die Untertitel sichtbar sind und nicht aus der sicheren Zone ragen:

   ffmpeg -y -ss 5 -i "03-output/NAME_draft.mp4" -frames:v 1 "03-output/_check.png"
   

   Überprüfe sie und lösche die _check.png am Ende.
3. Vergleiche Originaldauer vs. Enddauer.

Wenn etwas fehlschlägt (Whisper transkribiert nicht, FFmpeg gibt Fehler aus), erkläre das Problem in einfacher Sprache, korrigiere und versuche es erneut. Gib keinen Entwurf mit schlecht synchronisierten oder abgeschnittenen Untertiteln ab.

Schritt 4 – Präsentieren und auf Freigabe warten

Öffne den Entwurf, damit die Person ihn hören und sehen kann:

• Windows: start "" "03-output/NAME_draft.mp4"
• Mac: open "03-output/NAME_draft.mp4"

Fasse in wenigen Zeilen zusammen:

• Dateipfad und Dauer (original → final).
• Was wurde geschnitten (Stille und ggf. Füllwörter oder manuelle Abschnitte).
• Was wurde angewendet (Untertitel, Zoom, Ausblende).

Beende mit der Frage: „Genehmigst du es oder was möchtest du anpassen?“ (Audio, Untertitel, Rhythmus, Zooms, Schnitte).

Erstelle die endgültige Version erst, wenn du ein explizites Ja erhältst.

Schritt 5 – Iterieren und die endgültige Version übergeben

• Wenn sie Änderungen wünscht: wende sie an, erstelle einen neuen Entwurf (_draft2) und gehe zurück zu Schritt 3.
• Wenn sie genehmigt: exportiere die endgültige Version mit demselben Exportbefehl, verwende --output "03-output/NAME_final.mp4".
• Gib den Pfad der endgültigen Datei an und schlage vor, sie auf Reels / TikTok / Shorts zu veröffentlichen.

---

Regeln

• Frage, bevor du einen kostenpflichtigen Dienst verwendest (APIs, Cloud-Editoren, Musikbibliotheken, KI-Sprachen). Der Standard-Workflow benötigt keinen.
• Lokales Whisper zum Transkribieren. Lade das Video nicht auf externe Dienste hoch.
• Lösche oder überschreibe keine Dateien aus 01-crudo/. Das Original bleibt immer erhalten.
• Speichere Ergebnisse in 03-output/ und Zwischendateien in 02-assets/.
• Sprich in einfacher Sprache: Die Person kennt sich möglicherweise weder mit Videoschnitt noch mit Programmierung aus.
• Wenn die Person etwas außerhalb von Stufe 1 verlangt (komplexe Animationen, Motion Graphics, mehrere Kameras, Color Grading), sage es ehrlich: Dieser Workflow deckt Bereinigung, Untertitel und dezente Bewegung ab; biete an, es als separaten Schritt zu machen.