Communitygithub.com

oleg-motion

Transformez des images statiques en animations professionnelles – bannières en boucle, annimations publicitaires, stories, clips style cinémagraphe (MP4/WebM/GIF).

Qu'est-ce que oleg-motion ?

oleg-motion est un outil de motion design déterministe qui transforme des images statiques en animations de haute qualité. Il fonctionne en rendant une scène HTML image par image dans un navigateur Chrome headless, encodée avec ffmpeg, garantissant des boucles parfaites et une reproductibilité totale. L'outil prend en charge les images JPG/PNG plates (qu'il décompose automatiquement en arrière-plan, sujet et calques de texte avec profondeur), les fichiers PSD multipoints, ou des dossiers de calques PNG, et ajoute des effets de caméra parallaxe/2.5D, des particules (neige, feuilles, poussière, confettis, bokeh), des effets de lumière (nuances brillantes, scintillements, flares, lueurs) et des animations de texte/produit tout en maintenant la netteté des prix, logos et textes légaux. Utile pour tous ceux qui souhaitent animer un visuel, créer une bannière vidéo en boucle, un GIF animé, une publicité animée, une story/reel à partir d'une image, ou réaliser un effet de parallaxe ou un cinémagraphe.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bonchuk/oleg-motion/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait oleg-motion ?

Motion design déterministe à partir d’images fixes : une scène HTML rendue image par image dans Chrome headless, encodée avec ffmpeg. Tout est une fonction pure du temps, donc les boucles se ferment exactement et les rendus sont reproductibles. Parlez à l’utilisateur dans sa langue ; conservez les noms de fichiers et le JSON de la scène en anglais.

$OM ci-dessous désigne le répertoire de cette compétence (le dossier contenant ce SKILL.md).

0. Assurez-vous que ça fonctionne (une fois par machine)

Exécutez tout via le lanceur $OM/om — il place en premier dans le PATH le Node, ffmpeg et Python propres à la compétence, ce qui fonctionne sur un Mac propre sans outils de développement.

$OM/om doctor              # ce qui est installé
bash $OM/scripts/setup.sh  # cœur : Node.js, ffmpeg, moteur de rendu (télécharge ce qui manque)
$OM/om setup --psd         # + import PSD
$OM/om setup --ml          # + calques automatiques pour images plates (~1 Go incl. modèles)
$OM/om update              # dernière version depuis GitHub (fonctionne sans git), puis configuration

L’installation ne nécessite ni mot de passe admin, ni Homebrew, ni git : les outils manquants sont téléchargés dans ~/.cache/oleg-motion/tools (remplacez le dossier avec OLEG_MOTION_HOME) ; les outils déjà présents sur la machine sont utilisés s’ils sont suffisants. Le cœur seul peut déjà animer n’importe quelle image (caméra, particules, lumière, superpositions). Demandez avant d’exécuter --ml — il télécharge des modèles. Si om n’est pas exécutable (décompressé depuis un zip), appelez bash $OM/om ….

1. Brief — regardez d’abord, puis demandez avec des options cliquables

Les gens déposent un fichier et disent « faites bouger ça ». La plupart ne peuvent pas décrire le mouvement en mots, donc ne posez pas de questions ouvertes — regardez d’abord l’image vous-même (ouvrez-la), listez ses éléments (titre, prix, bouton, logo, photos, produit, flèches…), puis demandez.

Kit de marque d’abord. Si la demande mentionne une marque/projet, ou qu’un *.brand.json / oleg-motion.brand.json se trouve dans le dossier de travail, ou que $OM/brands/ contient un kit correspondant, chargez-le et passez --brand à la scene : ses valeurs par défaut répondent à la plupart des questions (ignorez celles-ci) et ses protect / avoid / notes sont des règles strictes. Format : references/brand-kit.md. Pas encore de kit → proposez d’en sauvegarder un lors de la livraison (étape 6).

Ne demandez jamais sur le savoir-faire — les durées, l’easing, les amplitudes, les décalages, les nombres de particules sont des valeurs par défaut professionnelles (references/motion-guidelines.md). Modifiez-les seulement quand la personne le demande. Chaque question offre une valeur par défaut qu’ils peuvent simplement accepter.

Sautez les questions quand l’utilisateur dit « просто зроби » / « just do it » / « à votre guise », ou que les réponses sont déjà dans la demande : choisissez les valeurs par défaut et indiquez-les en une ligne.

Sinon, demandez une fois, avec des options — utilisez l’outil AskUserQuestion quand disponible (cartes cliquables ; sinon un message avec des options numérotées). Jusqu’à 4 questions, chacune avec votre option recommandée en premier, construite à partir de ce que vous avez vu dans l’image :

  1. Où sera-t-elle diffusée ? → profil : « як є — ne pas modifier les proportions » (source : le rapport hauteur/largeur d’origine, grand côté limité à 1920 px), publication Instagram 4:5 (feed-portrait), Stories/Reels 9:16 (story), bannière de site web (web-hero / web-strip), affichage publicitaire GIF (display-*). Adaptez les 4 options à l’image : si son rapport correspond déjà à un format (ex. 4:5 → publication Instagram), proposez ce format au lieu d’un « як є » distinct (même résultat) et recommandez-le ; sinon recommandez d’abord « як є ». Un format avec un autre rapport recadre l’image (fit: cover) ou ajoute des marges floues (contain-blur) — dites-le, et ce qu’il coupe (bords du titre, CTA), pour que la personne ne soit pas surprise.
  2. Personnage ? → 3–4 ambiances qui correspondent à l’image, décrites par la sensation, pas par le nom : « calme & premium », « énergique », « festif », « presque immobile ». Mentionnez l’ambiance correspondante dans la description (premium, energetic, festive, calm … ; liste complète : $OM/om moods).
  3. Structure ? → « les éléments apparaissent, puis bouclent » (intro-loop, bon pour les posts sociaux), « boucle uniquement » (loop, bon pour les bannières de site), « un seul passage avec une fin » (oneshot).
  4. Quel est le héros ? (multiSelect) → les 3–4 éléments les plus importants que vous avez trouvés, par ex. « titre SUMMER SALE », « bouton CTA », « photos », « produit ». Le héros reçoit le mouvement principal ; tout le reste reste calme.

Valeurs par défaut si aucune réponse : profil à partir du rapport hauteur/largeur, 6 s (intro 2 s + boucle 4 s pour intro-loop), MP4, ambiance choisie dans la palette et le sujet. Une vidéo de référence (« comme ça ») prime sur toute réponse — décomposez-la avec references/reference-analysis.md et reproduisez son rythme, pas son contenu.

2. Plan de mouvement — accord sur les mots avant le rendu

Avant le premier rendu, montrez le plan en langage clair (langue de l’utilisateur), une ligne par élément, avec les durées — par ex. :

Intro (2 s) : le logo apparaît → le titre monte ligne par ligne → « -30 % » surgit → le bouton et le produit apparaissent par le bas. Boucle (4 s) : « -30 % » brille légèrement, un éclat le traverse · le bouton pulse · le produit flotte légèrement · poussière chaude en fond. Ne bouge pas : logo (seulement une étincelle), prix après apparition, dates.

Demandez « On fait comme ça, ou quelque chose à changer ? » dans le même message et ne procédez qu’après un oui (ou quand l’utilisateur a ignoré les questions — alors rendez directement et montrez le plan avec le résultat). Modifier le plan coûte des secondes ; modifier un rendu coûte des minutes. Le plan décide aussi quels éléments nécessitent leur propre calque à l’étape suivante.

3. Obtenez les calques

Choisissez selon l’entrée — l’objectif est un layers.json avec des rôles (voir references/scene-format.md) :

entréecommande
JPG/PNG plat, ML installé$OM/om py $OM/scripts/ml/auto_layers.py in.jpg --out work/layers
PSD$OM/om py $OM/scripts/psd_layers.py in.psd --out work/layers
dossier de calques PNG$OM/om layers-from-dir path/to/pngs
création design (cartes, boutons, flèches, photos avec têtes dépassant du cadre) ou auto-layers erronésécrivez regions.json (boîtes/polygones + mode masque) → $OM/om py $OM/scripts/ml/cut_regions.py regions.json --out work/layers (format dans le docstring du script)
image plate, sans MLécrivez layers.json à la main : un calque background (et demandez des zones de texte si les particules doivent éviter le texte)

Pour regions.json, trouvez les coordonnées en mesurant, pas à l’œil : seuillez les pixels clairs/sombres et imprimez les boîtes englobantes des composants ; pour les cartes photo, scannez la couleur du cadre et ajustez les bords (un polygone 3–5 px à l’intérieur du vrai bord laisse une ligne brillante dans l’arrière-plan et découpe la carte). Utilisez mask: "contrast" pour le texte/logos/lignes sur fond uni, "full" + popout pour les cartes photo avec une tête qui dépasse, "seg" pour les objets sur photos chargées.

Ouvrez toujours preview.png / les PNG des calques et vérifiez la séparation avant de construire la scène : les calques automatiques peuvent mal étiqueter (un logo détecté comme texte, un prix comme titre, un sujet qui est en fait l’arrière-plan). Corrigez les rôles dans layers.json — les rôles décident ce qui peut bouger. Si le détourage du sujet est mauvais, abandonnez ce calque plutôt que d’animer un bord irrégulier.

4. Construisez la scène

$OM/om scene --layers work/layers/layers.json --mood energetic \
     --profile feed-portrait --structure intro-loop [--brand brand.json] \
     [--intensity 1] [--speed 1] [--density 1] --out work/scene.json

Cela ébauche scene.json à partir du bundle d’ambiance (et du kit de marque). Modifiez-le ensuite pour correspondre au plan convenu — c’est là qu’est le savoir-faire : des durées d’intro par calque décalées de 50 à 100 ms (cascade entière ≤ 2 s, entrées 400–800 ms, ease-out ; rebond seulement sur un élément ludique), lumière/lueur du héros, mouvement décoratif (flèches rebondissent, badges tournent), particules dans une couleur d’accent de l’image ou du kit de marque. Lisez references/effects.md pour chaque effet et ses paramètres, et references/motion-guidelines.md pour les limites qui maintiennent le professionnalisme.

5. Rendu, regardez, itérez

$OM/om render work/scene.json --out work/out --quality draft     # vérification rapide
$OM/om render work/scene.json --out work/out --formats mp4,webm,gif  # final

Après chaque rendu, regardez *-sheet.jpg (8 images) et, en cas de doute, extrayez des images individuelles (ffmpeg -ss 2.5 -i out.mp4 -frames:v 1 f.png) et visualisez-les. Le rapport (*-report.json, résumé dans stderr) vérifie : la couture de boucle, les flashs (≤3/s), les calques verrouillés ne bougeant pas, les zones de sécurité (texte/prix/CTA ≥ 10 % des bords, logos ≥ 5 % ; cut = un changement de format a recadré, as-designed = la source était déjà aussi serrée), le budget de fichier.

Corrigez les échecs avant de livrer — une couture visible signifie généralement des cycles non entiers ; un échec de budget signifie moins de particules/grain, ou une taille/fps GIF inférieure.

Montrez à l’utilisateur la version de travail (la planche contact ou le MP4) et invitez les ajustements dans ses propres mots — « plus lent », « moins de brillance », « sans particules », « bouton plus lumineux », « enlève l’intro ». references/tweaks.md fait correspondre ces phrases à des modifications de scène ; appliquez-les, re-rendez en version de travail, et ne rendez la version finale que lorsqu’il est satisfait.

Coût sur un laptop (M1, 8 Go) : calques automatiques ≈ 3–4 min par image (exécutez-le une fois, puis itérez sur la scène) ; rendu ≈ 0,2–0,4 s par image (6 s à 30 ips ≈ 1 min). Prévenez l’utilisateur avant les longues étapes.

6. Livrez

Donnez à l’utilisateur : les fichiers (chemins + tailles), l’affiche JPG, une phrase sur ce qui bouge, et pour les sites web l’indice d’intégration <video autoplay muted loop playsinline poster="…">. Si la plateforme cible a des limites strictes (taille exacte, codec, Mo max), dites qu’elles ont été respectées — ou non. S’il s’agissait d’un travail de marque et qu’aucun kit n’existe encore, proposez en une ligne d’en sauvegarder un (references/brand-kit.md) afin que la prochaine fois les questions soient déjà répondues.

Règles pour garder la qualité (et pourquoi)

  • Un mouvement héros, ≤ deux mouvements ambiants. Les spectateurs lisent une chose à la fois ; un mouvement supplémentaire entre en concurrence avec le message.
  • Les prix, textes légaux et logos restent rigides. Le mouvement brouille et fait trembler les lettres — la lisibilité et la confiance en la marque priment sur l’effet. Les rôles l’imposent ; ne réassignez pas un prix à text pour lui donner du mouvement.
  • Ne simulez pas le mouvement d’une personne. Une personne détourée ne peut pas courir ou agiter la main ; faire osciller ou pulser la figure entière ressemble à une marionnette en carton. Donnez de la profondeur aux personnes (parallaxe de caméra) et une introduction, rien de plus.
  • Petites amplitudes. 3–6 % de poussée de caméra, 2–4° d’inclinaison, ≤ 2 % de respiration. Les grands zooms et la parallaxe provoquent le mal des transports et semblent amateurs.
  • Cycles entiers uniquement. La boucle est parfaite parce que chaque mouvement effectue un nombre entier de cycles par boucle — ne définissez jamais de cycles fractionnaires.
  • Première image = affiche finie. En mode loop, la première image a déjà tout en place ; utilisez intro-loop quand des entrées sont souhaitées.
  • Pas de redessin génératif du texte. Cette compétence ne repeint jamais le texte ou les produits ; la vidéo IA (optionnelle, voir references/ai-video.md) est uniquement pour les arrière-plans, avec les calques d’origine recomposés par-dessus.

Dépannage

  • Playwright is not installed, Node.js is missing, erreurs ffmpeg → bash $OM/scripts/setup.sh.
  • Images vides ou noires → un chemin de calque est erroné (vérifiez les avertissements stderr) ou la scène n’a pas de calque d’arrière-plan.
  • Détection de texte ignorée → ocrmac est uniquement macOS ; ailleurs, passez les calques de texte manuellement.
  • Halos de bordure en parallaxe → réduisez depthParallax.amp, ou repeignez le panneau (les calques automatiques le font sauf si --no-inpaint).
  • GIF trop volumineux → les profils display-* le réduisent automatiquement ; sinon, abaissez ips/largeur.

Skills associés