Avenox Studio — routeur opérateur
Guide rapide de l'opérateur pour un pipeline vidéo local-first, piloté par un agent. Tout s'exécute sur votre machine : pas d'éditeur cloud, pas de téléversement pour le rendu.
L'humain dirige et approuve la qualité ; l'agent exécute le pipeline.
Configuration
export STUDIO_JOBS="$HOME/video/projects" # les médias lourds vivent ici
export STUDIO_ROOT="/chemin/vers/ce/depot" # scripts, templates, charte graphique
Prérequis : macOS (encodage matériel via h264_videotoolbox ; Apple Silicon pour
mlx-whisper), ffmpeg, python3, melt/MLT, Node (pour HyperFrames). La plupart
fonctionne sous Linux avec libx264 et une version CUDA de whisper adaptée.
Principes de fonctionnement
- Discipline des médias. Les médias lourds ne doivent JAMAIS se trouver dans un dossier synchronisé dans le cloud — la synchronisation saturerait sur des fichiers intermédiaires de plusieurs Go et pourrait corrompre les écritures en cours. Les projets vivent dans
$STUDIO_JOBS/<job>//(raw/ cut/ graphics/ audio/ outputs/). Votre système de notes ne contient que le cerveau : ce système, la charte graphique, les plansedit.json. - Boucle de validation. Produisez un aperçu (images des graphismes + un rendu rapide) → envoyez pour retours → seulement ensuite le rendu final. Ne livrez jamais un final sans validation. C'est la règle la plus importante ; un agent qui rend des finals non revus fera perdre des heures sur un montage rejeté.
- La charte graphique est une contrainte ferme, pas une suggestion. Lisez
brand/frame.mdavant de créer un graphisme. Définissez-la une fois et verrouillez-la. (L'implémentation de référence est délibérément anti-« AI slop » : éditorial premium, papier chaud + encre + un seul accent, pas de néon/gradient/glassmorphism/3D-brillant.) - Format : YouTube 16:9 1080p60. Préréglage dans
brand/presets/youtube-16x9.json. - La finalisation est hybride. Générez automatiquement le brouillon ; le même fichier
.mlts'ouvre dans Kdenlive ou Shotcut pour une finition manuelle. N'essayez pas d'automatiser le goût. - La transcription par défaut est LOCALE avec
mlx-whisperetwhisper-large-v3-turbo— rapide, gratuit et performant sur l'audio non-anglais. Notez que la plupart des proxies de routage LLM n'exposent pas de endpoint whisper ; si vous passez par le cloud, utilisez une API vocale dédiée.
Scripts (scripts/)
| Script | Action |
|---|---|
| `autocut.sh IN.mp4 [balanced | aggressive |
transcribe.py IN.mp4 PREFIX | → transcript/PREFIX_timed.json + _narration.txt |
mltgen.py edit.json out.mlt --base <job-dir> | plan de montage → projet MLT (Kdenlive/Shotcut/melt) |
| `vrender.sh project.mlt out.mp4 [fast | quality]` |
grabshot.sh | capture d'écran du presse-papiers → disque |
slides2png.sh | diapositives statiques héritées — préférez HyperFrames |
remove-silence.py | passage silences autonome |
Les 7 étapes
- Réception — copie brute →
$STUDIO_JOBS/<job>/raw/. Confirmez le brief et les segments qui comptent vraiment. - Montage brut —
autocut.sh raw.mov balanced→cut/screen_cut.mp4;transcribe.pypour le script. Recette complète → compétenceavenox-roughcut. - Graphismes — HyperFrames. Passez par la compétence
hyperframes→ généralementmotion-graphics(courtes séquences),faceless-explainer(concepts développés) ougeneral-video. Lisezbrand/frame.mdd'abord ; rendez des MP4 animés dansgraphics/. Recette complète → compétenceavenox-graphics. - Assemblage — écrivez
edit.json(modèle danstemplates/edit.json) en mélangeantcut/*.mp4+graphics/*.mp4+ musique →mltgen.py edit.json project.mlt --base <job-dir>. - Sous-titres —
transcribe.py→.srt; appliquezbrand/caption-corrections.json(copiez-le depuiscaption-corrections.example.json— un dictionnaire de recherche/remplacement pour les termes que votre ASR déforme systématiquement). Livrez en tant que CC YouTube, pas incrustés. - Musique — tapis sonore sous tout, sidechain-duck sous la voix, ciblez ~-14 LUFS. Suivez les attributions dans
CREDITS.md. - Export —
vrender.sh project.mlt draft.mp4 fast→ validation du réalisateur →vrender.sh … final.mp4 quality→ nettoyez les fichiers temporaires.
Niveau de qualité des graphismes
Les clips HyperFrames doivent respecter brand/frame.md. Préférez un mouvement typographique, sobre et pesant. Si un plan n'a pas besoin de mouvement, une image statique propre suffit — n'animez pas pour le plaisir d'animer.
Références
- Montage brut :
avenox-roughcut· Graphismes :avenox-graphics - Compétences HyperFrames :
hyperframes(routeur),hyperframes-cli,hyperframes-animation,hyperframes-creative,motion-graphics,faceless-explainer,general-video - Charte graphique :
brand/frame.md(à remplir depuisbrand/frame.template.md)