Communitygithub.com

hacimertgokhan/geomotion

Créez des animations vectorielles animées à la main (encre bouillonnante, remplissages style riso) à partir de formes simples, exportables en SVG animé, Lottie JSON, HTML ou liens partageables.

Qu'est-ce que geomotion ?

geomotion est un outil puissant pour générer des animations « faites à la main » à partir d'une spécification JSON simple. Il transforme une liste de keyframes, chacune contenant des formes géométriques, en une animation fluide où les formes de même `id` morphing entre les keyframes et où les lignes « bouillonnent » (ré-encrées ~12 fois par seconde) pour un rendu crayonné réaliste. L'outil prend en charge l'exportation en SVG animé, Lottie JSON, HTML ou via un lien de lecteur/studio interactif. Il peut être utilisé via des outils MCP (pour agents comme Claude), une CLI Node.js, ou même un simple script Python pour générer un lien. La spécification permet de contrôler finement les formes (cercle, ellipse, rectangle, ligne, polygone, étoile, cœur, blob, etc.), les couleurs (palette nommée ou hexadécimal), les transitions (easing, délais, effets d'apparition/disparition) et les transformations. Des règles de conception intégrées garantissent un rendu esthétique : toile 1200×1200, marges généreuses, 2–5 formes audacieuses par pose. Un catalogue de presets (loader, spinner, sunrise, chat, idea, ghost…) permet de démarrer rapidement, et l'outil propose même des composants web pour intégrer facilement l'animation sur un site.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hacimertgokhan/geomotion/tree/HEAD/skills/geomotion

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 geomotion ?

geomotion transforme une spécification JSON — une liste de keyframes, chacune étant une liste de formes — en une animation dessinée à la main. Les formes ayant le même id se morphing entre les keyframes ; les lignes continuent à « bouillonner » (ré-encrées ~12×/s) pour un rendu qui semble tracé à la main.

Site & studio : https://hacimertgokhan.github.io/geomotion · Dépôt : https://github.com/hacimertgokhan/geomotion

Flux de travail

  1. Choisissez une méthode (utilisez la première disponible) :
    • Outils MCP (geomotion_guide, geomotion_get_preset, geomotion_render, geomotion_share_link) : appelez geomotion_guide une fois, puis rendez.
    • CLI (Node 18+ avec réseau) : npx -y github:hacimertgokhan/geomotion render spec.json --both --formats svg,lottie,html
    • Sans outillage : écrivez la spécification, puis exécutez python scripts/link.py spec.json (dans ce dossier de compétence) pour obtenir un lien lecteur/studio que l'utilisateur peut ouvrir, modifier et exporter.
  2. Partez d'un preset lorsqu'il est proche (voir le catalogue ci-dessous) et adaptez les identifiants, positions, couleurs.
  3. Écrivez la spécification selon les règles ci-dessous. Validez (MCP geomotion_validate ou geomotion check spec.json).
  4. Livrez : chemins de fichiers et/ou lien du lecteur. Mentionnez le lien du studio pour qu'ils puissent l'ajuster. Proposez une version transparente (transparent: true ou "both") lorsque l'animation sera placée sur un site web.

Éléments essentiels de la spécification

{
  "name": "idée",
  "size": [1200, 1200],
  "fps": 24, "boil": 12, "loop": true,
  "background": "ivoire",
  "hold": 0.7, "duration": 0.9, "ease": "inOutCubic",
  "style": { "width": 24, "wobble": 1, "misregister": [-14, 10] },
  "keyframes": [
    { "shapes": [ { "id": "ampoule", "type": "cercle", "cx": 600, "cy": 520, "r": 220, "fill": "avoine" } ] },
    { "hold": 1.2, "shapes": [
      { "id": "ampoule", "type": "cercle", "cx": 600, "cy": 520, "r": 240, "fill": "soleil" },
      { "id": "rayon", "type": "ligne", "from": [600, 200], "to": [600, 110], "enter": "draw", "delay": 0.3 }
    ] }
  ]
}
  • Keyframe : hold (secondes affichées), duration (morphing vers la keyframe suivante), ease.
  • Types de formes : cercle {cx,cy,r}, ellipse {cx,cy,rx,ry}, rectangle {x,y,w,h,radius?} ou {cx,cy,w,h}, ligne {from,to}, polyligne {points,closed?}, polygone {points}, régulier {cx,cy,r,côtés}, triangle {cx,cy,r}, étoile {cx,cy,r,inner?,points?}, cœur {cx,cy,size}, blob {cx,cy,r,seed?}, croissant {cx,cy,r,épaisseur?,angle?}, vague {from,to,amplitude?,vagues?,phase?}, spirale {cx,cy,r,tours?}, arc {cx,cy,r,début,fin} (degrés, 0 = droite, sens horaire), chemin {d} (tout chemin SVG).
  • Options de forme : id (correspondance entre keyframes — toujours le définir), fill, stroke (couleur ou false), width, opacity, enter/exit (grow | pop | draw | fade | cut), delay (0–0.95, décalage), ease, transform {translate, rotate, scale, origin}, misregister: false pour les petits points solides.
  • Noms de palette : encre, ardoise, ivoire, papier, avoine, kraft, argile, corail, figue, ciel, cactus, olive, bruyère, soleil, blanc (ou tout hexadécimal).
  • Easing : linear, in/out/inOut Quad·Cubic·Sine, inOutQuart, outExpo, inOutExpo, outBack, inOutBack, outElastic, outBounce.

Règles de conception pour un rendu esthétique

  1. Toile 1200×1200, marge d'environ 120 px, 2 à 5 formes audacieuses par pose. Les petits détails sont peu lisibles.
  2. Encre pour chaque contour, un ou deux remplissages d'accent par pose (avoine, argile, soleil, ciel, cactus, corail).
  3. Racontez une histoire avec les identifiants : le même élément se transforme (soleil → lune, enveloppe → avion en papier, point → cœur).
  4. Échelonnez avec delay 0 / 0.15 / 0.3 ; utilisez "enter": "draw" pour les lignes qui doivent sembler écrites, "pop" pour des arrivées ludiques.
  5. Pauses 0,5–1,2 s, morphing 0,5–1,2 s. inOutCubic = calme, inOutBack/outBack = ludique, outElastic = gelée.
  6. Les rotations > 30° entre deux keyframes font couper les coins aux lignes — divisez les grandes rotations en plusieurs keyframes (voir les presets spinner, gears, orbit).
  7. Points solides (yeux, points de frappe) : "stroke": false, "fill": "encre", "misregister": false.

Catalogue de presets (points de départ)

  • interface : loader, spinner, success, error, toggle, bell, search
  • nature : sunrise, sprout, rain, night, sea
  • communication : chat, send, like, connect
  • idées : idea, growth, target, gears, house
  • personnages : smile, ghost, sparkle
  • abstrait : drift, orbit, kaleido, pebbles
  • mouvement : bounce, pendulum, jelly

Tout preset s'ouvre directement : https://hacimertgokhan.github.io/geomotion/play/#preset=<nom> (ajoutez &bg=0 pour un fond transparent) ou dans le studio : /studio/#preset=<nom>.

Intégration sur un site web

<script type="module" src="https://hacimertgokhan.github.io/geomotion/src/embed.js"></script>
<geo-motion preset="success" transparent style="width:160px"></geo-motion>
<geo-motion code="z…"></geo-motion>   <!-- la partie #s=… d'un lien de partage -->

Skills associés