SouVi Engine

Moteur SouVi

souvi est dans le PATH et fonctionne depuis n'importe quel répertoire. Le moteur se trouve dans /home/cptdawn/Kode/SouVi-Engine (ci-dessous : $SOUVI). souvi <cmd> -h donne les options ; souvi presets liste les formats de livraison, les looks, les styles de titres, les transitions et les effets sonores.

Espace de travail

Chaque ensemble de livrables est un projet dans $SOUVI :

• projects/<slug>/ — timeline.json (le montage) et BRIEF.md (brief + journal des décisions datées)
• assets/<slug>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/ — sources, jamais modifiées
• output/<slug>/{drafts,renders,final,review}/ — résultats, versionnés _vNNN, jamais écrasés

Appelé depuis un autre dépôt : slug = nom du dossier de ce dépôt (suffixez-le pour un livrable distinct, ex. myapp-teaser). Importez les médias avec souvi import <slug> <fichiers…> (--as voice|sfx pour l'audio non musical, --link pour les gros fichiers) ; livrez avec souvi promote <render> --to <dossier dans le dépôt appelant>. Laissez git dans $SOUVI tranquille sauf si l'utilisateur le demande.

Les agents parallèles sont sans risque : chaque tâche s'exécute dans un dossier privé et les rendus d'un projet sont mis en file d'attente avec un verrou. Donnez à chaque livrable d'agent son propre slug.

Boucle

1. souvi new <slug> --preset <livraison> ; écrivez le brief dans BRIEF.md.
2. souvi import …, souvi assets <slug>, puis souvi look <clip> sur chaque source candidate.
3. Écrivez timeline.json après avoir lu $SOUVI/docs/timeline.md ; exécutez souvi plan <slug> jusqu'à ce que ce soit propre.
4. souvi render <slug> --draft (--gpu, --until N), révisez, corrigez.
5. souvi render <slug> (QC doit PASSER), révisez, souvi promote <render> [--to …].

Révision — vous ne pouvez pas regarder ni écouter, alors lisez les PNG que ces commandes produisent : souvi look <video> (feuille de contact ; --from/--to pour des feuilles denses autour des coupes), souvi frame <video> --at <t…>, souvi hear <fichier> (spectrogramme, forme d'onde, sonie). Le travail est terminé lorsque le rendu final passe cette révision et le QC.

Artisanat

Avant les décisions créatives, lisez video.md pour l'image et audio.md pour le son. Appliquez chaque élément de leurs listes de vérification de révision.

Outils mono-fichier

export --preset, master, voice, sfx, reverb, stabilize, denoise, grade, retime, qc, loudness, probe. Les fichiers traités sont placés à côté de leur source sous <name>.<tag>_vNNN.<ext>. Pour tout le reste, ffmpeg brut est acceptable tant qu'il conserve le traitement 10 bits, le redimensionnement lanczos, les tags BT.709 et le rééchantillonnage soxr ; terminez le niveau sonore avec souvi master et encodez les livrables avec souvi export.