Communitygithub.com

vibe-motion/skills

Créez des graphiques financiers animés en chandeliers (K-lines) dans un projet Remotion. Couvre l'acquisition de données (Yahoo Finance), l'architecture de plugins (config / timeline / Scene / plugin), le dessin image par image sur Canvas, un style sombre de terminal de trading, ainsi que l'aperçu et le rendu avec Remotion Studio. Mots-clés : K线图, 蜡烛图, candlestick, OHLC, animation boursière, vidéo de graphiques financiers, graphiques Remotion.

Qu'est-ce que skills ?

Ce skill guide un agent AI à travers la création complète d'un graphique en chandeliers (candlestick) animé pour l'indice S&P 500 au sein du projet Remotion `vibe-motion-app`. Il détaille d'abord la récupération de données OHLC historiques gratuites via l'API Yahoo Finance, sans nécessité de clé API, en utilisant un script Node.js dédié. Ensuite, il décrit la structure d'architecture de plugin requise, composée de quatre fichiers clés (`config.js`, `timeline.js`, `Scene.jsx`, `plugin.js`) plus un preset de rendu, assurant une séparation claire des paramètres, de la logique d'animation, du rendu visuel et de l'enregistrement. L'animation est réalisée sur un élément `<canvas>` pour des performances optimales, avec une logique de fondu et de croissance des bougies, et un thème sombre rappelant un terminal de trading. Enfin, il explique comment enregistrer le plugin, le vérifier et le rendre, que ce soit sous forme d'image fixe ou de vidéo complète via la ligne de commande ou Remotion Studio. Le skill est conçu pour les développeurs utilisant Remotion avec React, TailwindCSS et pnpm, et met l'accent sur des principes robustes comme la réactivité haute résolution (DPR) et la gestion d'état basée uniquement sur les trames (`frame`) pour une parallélisation optimale du rendu.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vibe-motion/skills/tree/HEAD/remotion-candlestick

Demander à votre IA préférée

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

Documentation

Processus de création d'animation de chandeliers (Candlestick) avec Remotion

Ce skill documente le processus complet de création d'un graphique en chandeliers (K-line) pour le S&P 500 dans le projet Remotion vibe-motion-app.

Prérequis

  • Projet Remotion 4.0.438, configuré avec React 19 + TailwindCSS v4
  • Architecture de plugins : motion/ définit les scènes, remotion/ gère le pipeline de composition Remotion
  • pnpm comme gestionnaire de paquets

Étape 1 : Récupération des données financières

Yahoo Finance fournit des données OHLC historiques gratuites (sans clé API).

Créez scripts/fetch-sp500-data.mjs :

// Cœur : Appel à l'API Yahoo Finance Chart
const url = `https://query1.finance.yahoo.com/v8/finance/chart/%5EGSPC?period1=${PERIOD1}&period2=${PERIOD2}&interval=1wk`;
const resp = await fetch(url);
const json = await resp.json();
const result = json.chart?.result?.[0];
const ts = result.timestamp;
const quote = result.indicators.quote[0];
// Extraction de { t: timestamp, o: open, h: high, l: low, c: close }

Enregistrez dans public/data/sp500-weekly.json, pour que Remotion le charge via staticFile().

Paramètres :

  • %5EGSPC = symbole Yahoo du S&P 500 (codage URL de ^GSPC)
  • interval=1wk = hebdomadaire ; options possibles : 1d, 1mo
  • period1 / period2 = timestamps Unix, couvrant environ 40 ans (1984-2026)

Étape 2 : Création de la structure des fichiers du plugin

Chaque plugin Remotion nécessite 4 fichiers principaux + un preset de rendu :

motion/nom_plugin/
  config.js                 → Paramètres par défaut
  timeline.js               → Contexte de scène + calcul d'animation image par image
  Scene.jsx                 → Composant React (dessin Canvas)
  plugin.js                 → Objet d'enregistrement du plugin
  render-presets/
    default.json            → Preset de rendu

2a. config.js — Paramètres par défaut

export const DEFAULT_LAYOUT_PARAMS = Object.freeze({
  videoWidth: 1920,    // 16:9 paysage
  videoHeight: 1080,
});

export const DEFAULT_ANIMATION_PARAMS = Object.freeze({
  durationSeconds: 28,  // Durée totale de l'animation
  title: "S&P 500",
  subtitle: "40 dernières années · Graphique hebdomadaire en chandeliers",
});

export const DEFAULT_MOTION_PROPS = Object.freeze({
  ...DEFAULT_LAYOUT_PARAMS,
  ...DEFAULT_ANIMATION_PARAMS,
});

2b. timeline.js — Logique d'animation

Trois fonctions centrales doivent être implémentées :

// 1. Contexte de scène : validation + conversion de type forcée de tous les paramètres
export const resolveXxxSceneContext = (pluginParams) => { ... }

// 2. Calcul de la durée : durationSeconds * fps
export const getXxxDurationInFrames = ({ fps, sceneContext }) => { ... }

// 3. Props image par image : calcul de progress et autres valeurs d'animation à partir de frame/fps
export const buildXxxSceneProps = ({ frame, fps, loop, sceneContext }) => { ... }

Principe de conception clé : tous les états d'animation ne dépendent que du paramètre frame, satisfaisant aux exigences de rendu parallèle de Remotion.

2c. Scene.jsx — Composant de dessin Canvas

Utilisez <canvas> plutôt qu'une multitude d'éléments DOM pour de meilleures performances.

Mode de chargement des données :

const [dataHandle] = useState(() => delayRender("Chargement des données"));

useEffect(() => {
  fetch(staticFile("data/xxx.json"))
    .then(r => r.json())
    .then(data => { setData(data); continueRender(dataHandle); })
    .catch(err => cancelRender(err));
}, [dataHandle]);

Logique centrale de dessin Canvas :

const draw = useCallback(() => {
  const ctx = canvas.getContext("2d");
  const dpr = window.devicePixelRatio || 1;

  // Adaptation haute définition
  canvas.width = W * dpr;
  canvas.height = H * dpr;
  ctx.setTransform(dpr, 0, 0, dpr, 0, 0);

  // 1. Remplissage de fond
  // 2. Grille + échelle des prix axe Y
  // 3. Dessin des chandeliers (mèche + corps)
  // 4. Étiquettes d'années axe X
  // 5. Titre/sous-titre/informations statistiques
  // 6. Barre de progression
}, [data, progress, ...]);

useEffect(() => { draw(); }, [draw]);

Paramètres clés pour le dessin des chandeliers :

const CANDLE_GAP_RATIO = 0.28;  // Ratio d'espacement entre chandeliers
const CANDLE_FADE_FRAMES = 22;  // Nombre d'images pour l'animation d'entrée
const MAX_CANDLE_W = 8;         // Largeur maximale du chandelier (après mise à l'échelle)
const MIN_CANDLE_W = 0.6;       // Largeur minimale du chandelier

// Largeur du chandelier adaptée en fonction du nombre visible
const slotW = plotWidth / visibleCount;
const bodyW = Math.max(MIN_CANDLE_W, Math.min(MAX_CANDLE_W * scale, slotW * (1 - GAP_RATIO)));

Animation d'entrée (fondu + croissance depuis le bas) :

const appearFrame = (i / (N - 1)) * revealEndFrame;
const candleAge = currentFrame - appearFrame;
const fadeAlpha = Math.min(1, Math.max(0, candleAge / CANDLE_FADE_FRAMES));

// Animation de croissance
if (candleAge < CANDLE_FADE_FRAMES && candleAge > 0) {
  const growT = easeOutCubic(candleAge / CANDLE_FADE_FRAMES);
  displayBodyBottom = lerp(lowY, bodyBottom, growT);
}

ctx.globalAlpha = fadeAlpha;
// ... dessin de la mèche + corps ...
ctx.globalAlpha = 1;

Couleurs du thème sombre :

const COLORS = {
  bg: "#1a1a19",
  grid: "#2c2c2a",
  upBorder: "#e66767",       // Bordure bougie haussière (rouge)
  upFill: "rgba(230,103,103,0.15)",  // Remplissage bougie haussière (semi-transparent)
  downFill: "#199e70",        // Remplissage bougie baissière (vert)
  textPrimary: "#ffffff",
  textSecondary: "#c3c2b7",
  textMuted: "#898781",
  accent: "#3987e5",
};

2d. plugin.js — Enregistrement du plugin

export const xxxPlugin = Object.freeze({
  id: "ID_plugin",
  defaultProps: DEFAULT_MOTION_PROPS,
  SceneComponent: XxxScene,
  waitForSceneLayoutReady: true,  // Attendre le chargement complet des données

  resolveSceneContext: (params) => ...,
  getDurationInFrames: ({ fps, sceneContext }) => ...,
  buildSceneProps: ({ frame, fps, loop, sceneContext }) => ...,
  getLayout: ({ sceneContext }) => sceneContext.layout,
});

waitForSceneLayoutReady: true garantit que le composant Scene appelle onAutoLayoutReady() avant de commencer à rendre les images.

2e. render-presets/default.json

{
  "title": "S&P 500",
  "subtitle": "40 dernières années · Graphique hebdomadaire en chandeliers",
  "videoWidth": 1920,
  "videoHeight": 1080,
  "durationSeconds": 28
}

Étape 3 : Enregistrement de la composition

Modifiez motion/project.js pour basculer ACTIVE_COMPOSITION vers le nouveau plugin :

import { xxxPlugin } from "./xxx/plugin.js";

export const ACTIVE_COMPOSITION = Object.freeze({
  id: "SP500Kline",
  fps: 30,
  plugin: xxxPlugin,
});

Étape 4 : Validation et rendu

# Vérifier l'enregistrement de la composition
pnpm run remotion:compositions

# Lancer l'aperçu Studio (avec glissement de la timeline, réglage des paramètres)
pnpm run dev

# Rendu d'une image fixe
npx remotion still SP500Kline out/frame.png --frame=420

# Rendu de la vidéo complète
npx remotion render SP500Kline out/output.mp4

# Rendu avec un preset
REMOTION_PROPS_FILE=motion/xxx/render-presets/default.json pnpm run remotion:render

Problèmes courants

Problème CORS avec l'API Yahoo Finance

Dans l'environnement de rendu Remotion (navigateur sans tête Node.js), il n'y a pas de problème CORS. Si l'aperçu navigateur rencontre des problèmes CORS, utilisez staticFile() pour charger le JSON pré-récupéré local.

Flou du Canvas sur écrans haute densité (DPI élevé)

Multipliez toujours par devicePixelRatio :

canvas.width = W * dpr;
canvas.height = H * dpr;
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);

Trop de chandeliers rend la largeur trop petite

Définissez une largeur minimale de 0,6 px. Lorsque slotW < 1, réduisez le ratio d'espacement ou agrégez les données.

Contrôle de la progression de l'animation

Utilisez des fonctions d'easing segmentées :

  • Les 3% initiaux établissent rapidement une base
  • Les 90% intermédiaires révèlent à vitesse constante
  • La fin peut légèrement ralentir pour renforcer l'effet dramatique

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills associés