Gráficos editoriales animados (Remotion)
Convierte la historia de un experimento, prueba o idea en un vídeo de 15-30 segundos basado en números y texto. El aspecto es fijo y cuidado: título serif elegante + palabra de énfasis en cursiva (azul cielo), etiquetas monoespaciadas en MAYÚSCULAS con poco espaciado, números grotescos en negrita y compactos; marco delgado continuo (marca arriba a la izquierda, "01 — CAPÍTULO" arriba a la derecha, progreso dividido + tiempo abajo), ligera cuadrícula de fondo, viñeteado y grano sutil. Tú escribes la historia en JSON, la imagen surge de ahí.
Si necesitas dibujos, personajes o escenas hechas a mano, esto no es lo adecuado; usa el skill animacion (PIL ink).
Ejemplo: ejemplos/x-animacion/ejemplo.json ("Hice el mismo trabajo con tres configuraciones diferentes"; los números son datos de demostración inventados, en pantalla aparece "datos de ejemplo").
Instalación (una vez)
cd remotion && npm install # Node 18+; la carpeta fuentes/ se copia automáticamente a public/fonts
El primer render descarga Chrome Headless Shell (~100 MB). Parte Python: numpy, Pillow, ffmpeg.
En los comandos, usa .venv/bin/python como Python (Windows: .venv\Scripts\python).
Ciclo
1. Entiende la historia
¿Cuál es la afirmación en una sola frase? ¿Qué números hay y de dónde vienen? Plataforma y relación de aspecto (X: 16:9, Reels/Shorts: 9:16, o ambas), duración (X 15-30 s). Si no hay números, invéntalos: pide al usuario el número medido o usa escenas sin números (título, lista, pregunta).
2. Escribe la lista de escenas: trabajo/x-animacion/<nombre>.json
Copia del ejemplo. Reglas:
- Cada escena una sola idea, 3-7 palabras por línea, español natural y sencillo. En lugar de una frase larga, usa dos líneas.
*palabra*= énfasis (cursiva en serif + azul). Máximo un énfasis por escena.- Los números solo pueden ser medidos. Si usas números no medidos/de ejemplo, mantén
"etiqueta": "datos de ejemplo"a nivel superior e informa al usuario. - En español, el porcentaje va delante:
"prefijo": "%"→%80. Para dinero y tiempo en comparaciones, proporciona el texto listo:"$0,61","5 min 12 s". capituloabre un nuevo capítulo (etiqueta arriba a la derecha + parte de la barra de progreso); 3-5 capítulos son suficientes.- Insignias de estado como "en espera", "próximamente" y notas para ti mismo; cada texto en pantalla es para el espectador.
tipo | Campos | Para qué | Duración recomendada |
|---|---|---|---|
titulo | sup?, lineas | gancho: primeros 2-3 s | 2,4-3 |
texto | lineas?, sup?, texto (≤160) | prompt/comando se escribe letra a letra con sonido de teclado | 0,55 + letra × 0,09 + 0,9 |
contador | sup?, valor, inicio?, decimal?, prefijo?, sufijo?, inf? | un solo número grande que aparece contando | 3 |
medidor | lineas, niveles[2-6] (nombre, etiqueta?) | nivel conceptual: se llena en orden de bajo a alto | 3-4 |
columnas | lineas, elementos[2-6] (nombre, valor, etiqueta?), prefijo/sufijo/decimal?, nota? | resultados medidos, etiqueta de orden automática | 4-4,5 |
comparacion | lineas (una sola línea), a, b (nombre, sup?, valor, infEtiqueta?, inf?), diferencia? (valor, etiqueta?, inf?) | A vs B: coste, duración | 4-5 |
lista | lineas, elementos[2-5] | inferencia, regla, paso | 1,6 + 0,5 × elemento |
pregunta | lineas, inf? | pregunta de cierre / llamada a la acción | 3 |
Cada escena requiere duracion (s), capitulo es opcional. A nivel superior: marca (nombre arriba a la izquierda), etiqueta?, tema?, escenas. Esquema: remotion/src/x/esquema.ts.
3. Borrador (vistazo rápido)
.venv/bin/python .claude/skills/x-animacion/herramientas/generar.py trabajo/x-animacion/<nombre>.json --relacion ambas --borrador
Render a media resolución, sin audio + página de contactos (<nombre>-<relacion>-borrador-sin-sonido-pagina.jpg). ÁBRELA y mira: líneas que sobresalen, elementos superpuestos, etiquetas ilegibles, grandes espacios vacíos. Corrige, vuelve a tomar borrador. Para editar en vivo: cd remotion && npx remotion studio.
4. Render + audio
.venv/bin/python .claude/skills/x-animacion/herramientas/generar.py trabajo/x-animacion/<nombre>.json --relacion ambas
Salidas en trabajo/x-animacion/: <nombre>-16x9.mp4 (1920×1080, 60 fps) y <nombre>-9x16.mp4 (1080×1920, 30 fps), con audio. El nivel de volumen predeterminado es -26 LUFS: claramente por debajo del habla (-14..-16), no ahoga si se superpone narración o cabeza parlante. Si se envía solo, usa --lufs -18; si se desea sin música, --sin-musica.
Paso a paso (lo mismo):
cd remotion && npx remotion render XAnimacion16x9 ../trabajo/x-animacion/<nombre>-16x9-sin-sonido.mp4 \
--props=../trabajo/x-animacion/<nombre>.json --muted && cd ..
.venv/bin/python .claude/skills/x-animacion/herramientas/audio.py trabajo/x-animacion/<nombre>.json \
--video trabajo/x-animacion/<nombre>-16x9-sin-sonido.mp4 --salida trabajo/x-animacion/<nombre>-16x9.mp4
5. Mide — no puedes mirar, no puedes escuchar
Al final de generar.py se ejecuta medir.py (a mano: medir.py <mp4> --json <json>):
- número de fotogramas y duración igual a lo esperado del JSON, audio y vídeo misma longitud;
- página de contactos: dos fotogramas de cada escena (mitad y justo antes de la salida) — ábrela y mira;
- LUFS integrado y pico real; en cada corte, el whoosh supera el lecho en cuántos dB (aviso si 2 dB por debajo). En el corte justo después de una escena de escritura, la diferencia es pequeña: hay sonido de tecla en la ventana anterior, normal. Lo que no puedas medir (si la música es agradable, si el ritmo es correcto) déjaselo claro al usuario.
6. Entrega
Rutas de archivo, duración, tiempo de render y resumen de medición. Si se usaron datos de ejemplo, repítelo.
Adaptar la apariencia
- Color: En JSON:
"tema": {"enfasis": "#38bdf8", "fondo": "#111113", "texto": "#ece7df", "palido": "#8b8883", "serie": [...]}. Mantén un solo color de énfasis;serieson colores de medidor/columnas. Valores predeterminados enremotion/src/x/componentes.tsx. - Marca:
"marca"es el nombre arriba a la izquierda (nombre del canal o de la serie). - Fuente: solo fuentes de distribución libre (como OFL). Pon el TTF y el texto de licencia en
fuentes/, añádelo a la lista enremotion/scripts/copiar-fuentes.mjsy aCARASenremotion/src/x/fuentes.ts, ejecutanpm run fuentes. Las fuentes incluidas con el sistema operativo (fuentes del sistema macOS/Windows) no se ponen en el repositorio, no se pueden distribuir. - Diseño: dos orientaciones en
useDiseno()(dentro decomponentes.tsx). En vertical, el contenido está entre y 300-1320: la interfaz de Reels/Shorts cubre ~190 px arriba, ~520 px abajo y la esquina inferior derecha. - Nuevo tipo de escena: añade esquema a
esquema.ts, componente aescenas.tsx, rama aDibujarEscena, nombre aTIPOSengenerar.py. Si necesita un sonido interno como el de teclado, calcula su tiempo contiempo.tsy enherramientas/comun.pycon la misma fórmula.
Errores comunes (medidos)
- El tiempo es la única fuente:
remotion/src/x/tiempo.tsyherramientas/comun.pyhacen el mismo cálculo (redondeo de fotogramas, ritmo de escritura). Si cambias uno y olvidas el otro, el whoosh se desvía del corte y el sonido de tecla de la letra. - El ID de composición no tiene guión bajo; no incrustes JSON en
--props, pasa la ruta de archivo. - Las fuentes se cargan con la API FontFace; no se espera
document.fonts.ready(en renders largos se ha visto que nunca se resuelve en una pestaña). Si la fuente no se carga, el render falla con error, no cae silenciosamente en una fuente de respaldo. - El grano no se calcula con SVG
feTurbulenceen cada fotograma (bloquea el render): se desplaza una baldosa de ruido generada una vez. - Mayúsculas en español con CSS (
lang="es"+text-transform): la Ñ sale correctamente. No usestoUpperCase()en JS. - No apliques animaciones de escala (zoom/pop) al texto: tiembla. Entrada = elevación desde máscara + opacidad.
- Si el render largo a 60 fps se traba, divídelo en partes como
--frames=0-899y combínalas con ffmpeg concat. - Tiempo de render medido (M1 Pro, 16 GB, concurrencia predeterminada): ejemplo de 27,4 s 16:9@60 ~67 s, 9:16@30 ~40 s; borrador (media res) 33 / 18 s.
Nota de licencia: Remotion
Remotion no tiene licencia MIT. Es gratuito para individuos y pequeñas empresas; las empresas por encima de cierto tamaño deben adquirir una licencia de pago. Antes de usarlo, consulta las condiciones actuales: https://www.remotion.dev/license — el código de este repositorio es MIT, Remotion en sí está sujeto a su propia licencia.