Documentation

Tout sur Révélo Vidéo 2.3.0 : ce qu'il fait, quelles IA il utilise, comment se déroule un export, comment le recompiler, et sous quelles licences.

• Fonctions
• Guide de chaque réglage
• Les 13 modèles d'agrandissement
• Configuration requise
• Où sont les fichiers
• Moteurs
• Déroulement d'un export
• Organisation du code
• Compiler
• Moteurs externes
• Modèles
• Détails techniques
• Vitesse
• Limites
• Historique
• Licences

Fonctions

Guide de chaque réglage

La fenêtre a trois colonnes : les modèles à gauche, l'aperçu au centre, les réglages à droite. La file d'attente est en bas.

Modèle (colonne de gauche)

Changer de modèle remet les réglages fins à ses valeurs ; « Revenir aux valeurs du modèle » annule vos retouches.

Moteur

• IA · 13 modèles : le vrai calcul par réseaux de neurones, pour l'export et l'aperçu IA. Il ne s'applique qu'aux vidéos ajoutées, pas au clip d'exemple.
• Rapide · filtres : filtres de la carte graphique (WebGL), en temps réel, sans IA. L'export relit la vidéo à vitesse normale : gardez la fenêtre visible.
• Moteur de calcul : « Automatique » prend Video2X quand le modèle le permet ; « Video2X » le force (en flux, plus rapide) ; « Révélo » calcule image par image avec tous les modèles.

Modèle IA d'agrandissement

• Automatique : le modèle IA suit le modèle choisi à gauche. Une note sous le menu explique celui qui est utilisé.
• Qualité extrême (TTA) : l'IA calcule chaque image 8 fois sous différents angles et fait la moyenne. Un peu plus précis, environ 8 fois plus lent. Moteur Révélo seulement.
• Carte graphique peu puissante : découpe l'image en morceaux de 64 pixels pour les cartes avec peu de mémoire vidéo.

Images par seconde

• Cadence : comme l'original, 24, 30, 60, 90 ou 120 i/s. Au-dessus de l'original, l'IA crée les images manquantes ; en dessous, des images sont retirées.
• Ralenti : ×2 ou ×4. L'IA crée les images intermédiaires et le son est ralenti avec l'image (atempo).
• Modèle d'interpolation : RIFE 4.26 (le plus récent, Video2X), RIFE 4.25 (Video2X), RIFE 4.6 (tous usages), RIFE 4.0 (mouvements rapides), RIFE anime et RIFE UHD (doublement seulement), IFRNet L (mouvements complexes), IFRNet (rapide), DAIN (ralentis de très haute qualité, lent). IFRNet et DAIN passent par le moteur Révélo.

Restauration

• Colorisation par IA : aucune, DDColor (couleurs réalistes) ou DeOldify (couleurs vives). La luminosité de l'original est gardée, seules les couleurs viennent de l'IA.
• Effacer une zone : cliquez le bouton, puis tracez un rectangle sur l'aperçu (le zoom est pris en compte). L'IA MI-GAN reconstruit le fond dans le cadre pointillé, sur toute la vidéo ; le reste de l'image n'est pas touché. « Retirer la zone » l'annule.
• Arrière-plan : garder, flouter, fond vert (pour le montage), fond noir ou blanc. L'IA RobustVideoMatting détoure les personnes image par image, en gardant la mémoire de l'image précédente pour des contours stables.
• Stabiliser l'image : analyse du tremblement puis correction (vidstab ; deshake sur Mac), avec un léger zoom pour cacher les bords.
• Désentrelacer : enlève les lignes en peigne des cassettes VHS et des enregistrements de télé (bwdif).
• Réduire le scintillement : égalise la lumière d'une image à l'autre, pour les vieux films.
• Grain de film : ajoute un grain fin qui évite l'aspect « trop lisse » de l'IA.

Son

• Son : conserver ; IA DeepFilterNet (voix nettes, bruit supprimé, volume égalisé ensuite) ; réduire le souffle (filtre simple) ; égaliser le volume ; retirer le son.
• Force du nettoyage (avec DeepFilterNet) : fort (tout le bruit) ou doux (garde un peu d'ambiance).
• Voix et musique : garder tel quel ; voix seules ; karaoké (sans les voix) ; musique baissée à 25 % derrière les voix. La séparation se fait avant le nettoyage et les sous-titres.

Sous-titres (IA Whisper)

• Mode : fichier .srt à côté de la vidéo ; piste de sous-titres activable dans le lecteur ; incrustés dans l'image.
• Langue parlée : détection automatique ou une des 12 langues proposées (Whisper en reconnaît 90).
• Précision : rapide (modèle de 142 Mo), précis (466 Mo), excellent (1,5 Go). Le modèle se télécharge une seule fois.
• Traduire en anglais : écrit les sous-titres en anglais, quelle que soit la langue parlée.
• Avec le ralenti ou un extrait, les temps des sous-titres sont recalés automatiquement.

Extrait, fichier de sortie, résolution

• Extrait : début et fin en minutes:secondes (par exemple 10:00 et 10:20). Idéal pour tester un réglage avant toute la vidéo.
• Format : H.264 (lu partout), H.265 (deux fois plus léger), ProRes (pour le montage, en .mov). Conteneur : MP4 ou MKV. Qualité : standard, haute, maximale.
• Résolution de sortie : originale, ×2, ×4, 1080p ou 4K (au plus 4096 pixels de côté).

Réglages fins

Netteté, débruitage, exposition (gamma), luminosité, contraste, saturation, température (froid à chaud), aplats (dessins animés) et colorisation par filtre. En mode IA, ils sont appliqués après l'IA ; le débruitage règle aussi la force de Real-CUGAN et de waifu2x.

Aperçu

• Divisé, Avant, Après : comparaison de part et d'autre d'une ligne qu'on glisse avec la poignée ronde.
• Zoom ×1, ×2, ×4 (ou molette) : une fois zoomé, glissez l'image pour la déplacer.
• Aperçu IA : en mode IA, l'image affichée est calculée par le vrai modèle dès qu'on s'arrête sur une image ; l'étiquette de droite indique « IA · nom du modèle ». Sous l'image, une estimation donne le temps pour toute la vidéo.

File d'attente

• Chaque vidéo montre ce qui est prévu, puis pendant l'export : les étapes (terminées, en cours, en échec), une barre de progression, le nombre d'images, la vitesse, le lot, le temps restant, le temps écoulé, la source, le moteur et l'encodeur.
• Exporter la sélection ou Exporter tout ; Annuler arrête le calcul en cours.
• À la fin : aperçu de la vidéo, taille, bouton « Afficher dans le dossier ». En cas d'erreur, le message reste affiché avec « Ouvrir le journal ».

Les 13 modèles d'agrandissement

Après l'IA, l'image est ajustée à la résolution choisie (Lanczos).

Configuration requise

Où sont les fichiers

Deux moteurs de calcul

Video2X (Windows et Linux) traite la vidéo en flux, sans écrire chaque image sur le disque. Il sert pour Real-ESRGAN x4plus, animevideov3, Real-CUGAN, Anime4K et RIFE.

Révélo traite image par image, par lots de 120 : un lot est encodé pendant que l'IA agrandit le suivant. Il sert pour tous les autres modèles, et sur Mac. Le menu « Moteur de calcul » choisit automatiquement.

Déroulement d'un export

1. Lecture de la vidéo, choix de l'encodeur : carte graphique NVIDIA, AMD, Intel ou puce Apple, sinon processeur.
2. Téléchargement des modèles manquants, une seule fois.
3. Son : séparation voix / musique, nettoyage, sous-titres.
4. Image : effacement de zone, colorisation, arrière-plan. Chaque étape rend une vidéo intermédiaire quasi sans perte.
5. Stabilisation, puis extraction des images ou préparation de la vidéo.
6. Interpolation si la cadence ou le ralenti le demandent.
7. Agrandissement par l'IA choisie.
8. Finitions (couleurs, netteté, grain, sous-titres incrustés) et encodage final dans Vidéos › Révélo.

Chaque commande et son résultat sont notés dans un journal, ouvert par le bouton « Journal » du programme.

Organisation du code

app/
  main.js            moteur, export, aperçu, téléchargement des modèles, journal
  ia.js              IA ONNX Runtime : colorisation, effaceur, arrière-plan, voix / musique
  preload.js         pont entre l'interface et le moteur
  package.json       dépendances et installateur Windows
  tools/pack-xplat.mjs  paquets Mac et Linux fabriqués depuis Windows
interface/revelo.html   toute l'interface
site/                   page d'accueil et cette documentation
outils/compiler.ps1     recompile les quatre paquets

Compiler

Il faut Node.js. Les moteurs externes (plus de 1 Go) ne sont pas dans l'archive du code source : la liste des fichiers à télécharger depuis leurs pages officielles, et l'endroit où les ranger, est dans LISEZ-MOI.md.

cd app
npm install
powershell -File ..\outils\compiler.ps1

Moteurs externes inclus dans les paquets

Ils ne sont pas dans l'archive du code source. Windows : app/bin/<dossier> ; Mac : app/bin-xplat/mac-arm64 et mac-x64 ; Linux : app/bin-xplat/linux-x64. Les fichiers de modèles (.param, .bin) sont communs aux trois systèmes.

Sous Windows, msvcp140.dll, vcruntime140.dll et vcruntime140_1.dll sont livrés à côté de whisper-cli et de Video2X, pour les ordinateurs sans le runtime Visual C++.

Détails techniques

Limites connues

• Les paquets Mac ne sont pas signés par Apple : au premier lancement, il faut xattr -cr "/Applications/Revelo Video.app" dans le Terminal.
• Sur Mac, Video2X n'existe pas ; pour les sous-titres, installez whisper.cpp avec Homebrew : brew install whisper-cpp.
• Pas de restauration des visages : GFPGAN n'existe qu'en PyTorch, et la licence de CodeFormer interdit l'usage commercial.
• Sur Mac et Linux, les IA ONNX (colorisation, effaceur, arrière-plan, voix) tournent sur le processeur ou CoreML, plus lentement que sous Windows avec DirectML.

Historique des versions

Licences des composants

Chaque composant garde sa licence : Real-ESRGAN (BSD-3-Clause) ; Real-CUGAN, RIFE, waifu2x, RealSR, IFRNet et DAIN ncnn (MIT) ; Video2X (AGPL-3.0) ; FFmpeg (GPL) ; DeepFilterNet (MIT et Apache 2.0) ; whisper.cpp et Whisper (MIT) ; DeOldify (MIT) ; DDColor (Apache 2.0) ; MI-GAN (MIT) ; RobustVideoMatting (GPL-3.0) ; MDX-Net / Ultimate Vocal Remover (MIT) ; modèles de Phhofm (CC BY 4.0) ; ONNX Runtime et Electron (MIT). Les codes sources de ces projets sont à leurs adresses officielles, listées dans LISEZ-MOI.md.