Avenox Studio – Operator-Router
Die schnelle Bedienungsanleitung für eine lokale, agentenbetriebene Videopipeline. Alles läuft auf Ihrem eigenen Rechner: keine Cloud-Editoren, kein Upload-zum-Rendern.
Der Mensch gibt Anweisungen und prüft die Qualität; der Agent führt die Pipeline aus.
Einrichtung
export STUDIO_JOBS="$HOME/video/projects" # schwere Mediendateien leben hier
export STUDIO_ROOT="/path/to/this/repo" # Skripte, Vorlagen, Markenrichtlinien
Voraussetzungen: macOS (Hardware-Encoding via h264_videotoolbox; Apple Silicon für
mlx-whisper), ffmpeg, python3, melt/MLT, Node (für HyperFrames). Das meiste
davon funktioniert auch unter Linux mit libx264 und einer ersetzten CUDA-Whisper-Build.
Betriebsprinzipien
- Mediendisziplin. Schwere Medien NIEMALS in einem cloud-synchronisierten Ordner – Synchronisation
würde bei Multi-GB-Zwischenprodukten überlasten und laufende Schreibvorgänge beschädigen. Aufträge
liegen in
$STUDIO_JOBS/<job>/(raw/ cut/ graphics/ audio/ outputs/). Ihr Notizsystem enthält nur das Gehirn: dieses System, die Markenrichtlinie,edit.json-Pläne. - Regie-Schleife. Erzeugen Sie eine Vorschau (Grafik-Standbilder + schneller Entwurfsrender) → zur Freigabe senden → erst dann final rendern. Niemals ein Finale ohne Freigabe ausliefern. Dies ist die mit Abstand wichtigste Regel; ein Agent, der Finals ungeprüft rendert, verbrennt Stunden mit einem abgelehnten Schnitt.
- Marke ist eine harte Einschränkung, kein Vorschlag. Lesen Sie
brand/frame.md, bevor Sie Grafiken erstellen. Definieren Sie sie einmal und sperren Sie sie. (Die Referenzimplementierung ist bewusst anti-"KI-Schrott": hochwertiger Redaktionsstil, warmes Papier + Tinte + ein einzelner Akzent, kein Neon/Gradient/Glassmorphismus/3D-Glanz.) - Format: YouTube 16:9 1080p60. Voreinstellung in
brand/presets/youtube-16x9.json. - Feinschliff ist hybrid. Automatisch den Entwurf erzeugen; die gleiche
.mlt-Datei öffnet in Kdenlive oder Shotcut für manuelle Nachbearbeitung. Versuchen Sie nicht, Geschmack zu automatisieren. - Transkription standardmäßig LOKAL mit
mlx-whisperundwhisper-large-v3-turbo– schnell, kostenlos und stark bei nicht-englischen Audioinhalten. Beachten Sie, dass die meisten LLM-Routing-Proxys keinen Whisper-Endpunkt bereitstellen; wenn Sie remote arbeiten, verwenden Sie eine spezielle Sprach-API.
Skripte (scripts/)
| Skript | Funktion |
|---|---|
autocut.sh IN.mp4 [balanced|aggressive|conservative] | Stille schneiden → _cut.xml (Premiere) oder --export-Varianten |
transcribe.py IN.mp4 PREFIX | → transcript/PREFIX_timed.json + _narration.txt |
mltgen.py edit.json out.mlt --base <job-dir> | Schnittliste → MLT-Projekt (Kdenlive/Shotcut/melt) |
vrender.sh project.mlt out.mp4 [fast|quality] | Rendern (fast = HW-Entwurf, quality = CRF18-Master) |
grabshot.sh | Zwischenablage-Screenshot → Festplatte |
slides2png.sh | Legacy-Statische Folien – HyperFrames bevorzugen |
remove-silence.py | Eigenständiger Stille-Durchgang |
Die 7 Schritte
- Aufnahme – Rohmaterial kopieren →
$STUDIO_JOBS/<job>/raw/. Briefing bestätigen und festlegen, welche Segmente wirklich wichtig sind. - Rohschnitt –
autocut.sh raw.mov balanced→cut/screen_cut.mp4;transcribe.pyfür das Skript. Vollständiges Rezept →avenox-roughcut-Skill. - Grafiken – HyperFrames. Über den
hyperframes-Skill routen → normalerweisemotion-graphics(kurze Beats),faceless-explainer(Konzeptstrecken) odergeneral-video. Zuerstbrand/frame.mdlesen; animierte MP4s ingraphics/rendern. Vollständiges Rezept →avenox-graphics-Skill. - Zusammenbau –
edit.jsonschreiben (Vorlage intemplates/edit.json) mitcut/*.mp4+graphics/*.mp4+ Musik mischen →mltgen.py edit.json project.mlt --base <job-dir>. - Untertitel –
transcribe.py→.srt;brand/caption-corrections.jsonanwenden (kopieren Sie es voncaption-corrections.example.json– eine Suchen/Ersetzen-Tabelle für Begriffe, die Ihre ASR zuverlässig verunstaltet). Als YouTube CC ausliefern, nicht eingebrannt. - Musik – Hintergrund unter alles, Sidechain-Ducking unter Sprache, Ziel
~-14 LUFS. Quellenangabe in
CREDITS.md. - Export –
vrender.sh project.mlt draft.mp4 fast→ Regie-Prüfung →vrender.sh … final.mp4 quality→ temporäre Dateien löschen.
Grafik-Qualitätsmaßstab
HyperFrames-Clips müssen brand/frame.md einhalten. Bevorzugen Sie typgetriebene, zurückhaltende,
gewichtige Bewegung. Wenn ein Beat keine Bewegung braucht, ist ein sauberes Standbild in Ordnung –
bewegen Sie nicht um der Bewegung willen.
Referenz
- Rohschnitt:
avenox-roughcut· Grafiken:avenox-graphics - HyperFrames-Skills:
hyperframes(Router),hyperframes-cli,hyperframes-animation,hyperframes-creative,motion-graphics,faceless-explainer,general-video - Markenrichtlinie:
brand/frame.md(ausfüllen nachbrand/frame.template.md)