TRAZO
Un pipeline local que convierte un archivo de texto en un video vertical de un minuto para explicar conceptos técnicos, con narración, animación programada y control de calidad automático.
Lo que ves
Un video corto que explica un concepto técnico con animación, mi voz y subtítulos, pensado para alguien que nunca programó. Los publico en YouTube, TikTok e Instagram.
00:00 / 01:24
El problema de Monty Hall
Tres puertas, un premio y una pregunta: ¿cambiar de puerta cambia tus probabilidades?
00:00 / 02:40
¿Cómo funciona un transistor?
Un voltaje pequeño decide si la corriente pasa o no, y con eso se construyen las computadoras.
Arquitectura
Un video es un archivo de texto con sus tomas, sus frases y sus escenas. Todo lo demás se genera a partir de ese archivo, así que una frase cambiada se refleja en la narración y en la animación sin tocar nada más.
Guion y storyboardYAML
Cada video vive en un archivo con sus tomas, frases, escenas y parámetros. Un esquema JSON valida la estructura antes de gastar tiempo en renderizar.
NarraciónMi micrófono y Kokoro
Grabo la narración con mi micrófono y el pipeline la alinea palabra por palabra con la animación. Kokoro también puede generar una voz con esos mismos tiempos.
Motor de escenasNode.js y skia-canvas
Dibuja cada fotograma de 1080×1920 a 30 fps como una función pura del tiempo. Por eso cada escena se puede probar y repetir.
Audio y montajeFFmpeg
Mezcla la voz con efectos y una base musical sintetizados a partir de los eventos de la escena, normaliza el volumen y exporta el MP4 y los subtítulos.
Control de calidadPython
Revisa el formato, el sonido, el texto dentro de la zona segura, el ritmo y el cierre en bucle. Marca fallos y avisos antes de que una persona revise el video.
- KokoroVoz generada en local, como alternativa a mi grabación
- skia-canvasRasterizado 2D de cada fotograma
- FFmpegCodificación, mezcla y subtítulos
- Interfaz localUn panel en el navegador que ejecuta los mismos comandos del pipeline
El texto es la fuente de verdad
Solo el archivo del video se edita a mano. Lo que se genera se reconstruye desde cero, así que el guion siempre describe fielmente lo que se ve y se escucha.
Cada estímulo tiene un motivo
Un zoom, un sonido o una aparición corresponde a algo que se dice en la narración. No hay efectos de adorno, porque un efecto sin significado distrae de la explicación.
Mismo guion, mismo video
Cada fotograma depende solo del tiempo y no del azar ni del estado anterior. Así el resultado es reproducible y un cambio en una escena no altera las demás.
El reto
Explicar un tema técnico a alguien que nunca programó, en 60 a 90 segundos, sin que el video se convierta en una secuencia de tarjetas de texto. Y hacerlo con una herramienta que pueda repetir el mismo resultado cada vez.
Lo que hay detrás
- El video se escribe como texto. Las tomas, las frases y las escenas viven en un archivo, y el resto se genera a partir de él.
- La narración es mi voz, grabada con micrófono, con tiempos por palabra para sincronizar cada animación con lo que se dice.
- Cada escena es un módulo en JavaScript que dibuja con Canvas 2D sobre Skia. Las cifras que aparecen en pantalla se calculan a partir de los datos que se dibujan.
- Los efectos de sonido y la base musical se sintetizan desde los eventos de la escena, así que cada sonido corresponde a algo que pasa en pantalla.
- Antes de entregar, una QA automática revisa formato, sonido, texto dentro de la zona segura, ritmo y cierre en bucle.
- Una persona revisa la pronunciación y la claridad de la explicación antes de publicar.
Decisiones y trade-offs
- Revisión humana antes de publicar. Es más lento, pero el motor no puede saber si una explicación es clara para alguien que empieza desde cero.
- Todo local y con mi propia voz. No dependo de servicios en la nube, y a cambio cada video lleva el tiempo de grabarlo a mano.
- Escenas programadas en lugar de un editor de video. Cada animación requiere código, pero se puede probar, versionar y repetir.
- Cada término se explica dentro del mismo video. El guion se alarga, pero cada video se entiende solo, sin depender de los anteriores.