Repolode
Enviar
masihsultani

masihsultani/whiteboard-animator

Herramienta de línea de comandos y biblioteca de Python que convierte una imagen estilo pizarra en un MP4 renderizado en CPU que se revela como si estuviera dibujado a mano, con ritmo ajustable a la narración.

Ver en GitHub
Estrellas
242
Forks
27
Issues abiertos
3
Último commit
el mes pasado

¿Qué es?

whiteboard-animator toma una imagen terminada con tinta sobre fondo blanco y genera un video en el que se dibuja a mano. El texto se escribe palabra por palabra, los contornos se trazan, las formas se rellenan con pinceladas o con un barrido en ángulo y las ilustraciones lineales ramificadas se dibujan siguiendo un recorrido del lápiz cada vez. Funciona en CPU y no requiere entrenamiento ni claves de API para renderizar; usa un detector de texto CRAFT basado en ONNX incluido para distinguir el texto de las formas.

La herramienta se instala desde PyPI como el comando `whiteboard-animate` y también ofrece una API de Python para renderizar escenas, concatenar varias escenas en un video y ajustar los parámetros de fundido y relleno. La salida se genera con FFmpeg, que debe estar en el PATH. Se puede proporcionar audio para cada escena; en ese caso, el dibujo se ajusta para terminar dentro de la duración de la narración. Un plan de regiones en JSON puede estimar el ritmo a partir del texto de las anotaciones, y una función opcional basada en Gemini puede proponer ese plan.

El motor funciona mejor con dibujos limpios, de estilo marcador y colores planos. No admite fotos, degradados ni fondos con textura o de color como entrada.

Funciones clave

  • 01Escribe el texto palabra por palabra y traza los contornos automáticamente.
  • 02Rellena las formas con pinceladas o con un barrido, según su tamaño.
  • 03Funciona en CPU con un modelo de detección de texto incluido; no requiere GPU ni clave de API.
  • 04Ajusta el ritmo del dibujo a la duración de un archivo de narración.
  • 05Concatena varias escenas en un MP4 mediante FFmpeg.
  • 06Ofrece tanto una CLI como una API de Python con parámetros ajustables.

Casos de uso

  • Animar diagramas o bocetos de pizarra para clases o videos explicativos.
  • Añadir un efecto de revelado dibujado a mano a contenido educativo narrado.
  • Renderizar por lotes una serie de escenas ilustradas en un solo video desde la línea de comandos.

Inicio rápido

  1. 1

    Instalar FFmpeg (en macOS, mediante Homebrew)

    brew install ffmpeg
  2. 2

    Instalar el paquete desde PyPI

    pip install whiteboard-animator
  3. 3

    Renderizar una imagen de pizarra blanca como un MP4 de 8 segundos

    whiteboard-animate sketch.png --duration 8 -o sketch.mp4

Antes de usarlo

  • Requiere instalar FFmpeg y ffprobe por separado y tenerlos en el PATH.
  • Funciona mejor con dibujos de tinta estilo rotulador sobre fondo blanco; las fotos y los fondos de color no se animarán bien.
  • El ritmo de la narración se estima a partir del texto y no se sincroniza con el habla, por lo que la sincronización con la voz puede variar.

Temas

#animation#video#whiteboard#ffmpeg#computer-vision#python#cli

Preguntas frecuentes

¿Qué es whiteboard-animator?
Herramienta de línea de comandos y biblioteca de Python que convierte una imagen estilo pizarra en un MP4 renderizado en CPU que se revela como si estuviera dibujado a mano, con ritmo ajustable a la narración. whiteboard-animator toma una imagen terminada con tinta sobre fondo blanco y genera un video en el que se dibuja a mano. El texto se escribe palabra por palabra, los contornos se trazan, las formas se rellenan con pinceladas o con un barrido en ángulo y las ilustraciones lineales ramificadas se dibujan siguiendo un recorrido del lápiz cada vez. Funciona en CPU y no requiere entrenamiento ni claves de API para renderizar; usa un detector de texto CRAFT basado en ONNX incluido para distinguir el texto de las formas.
¿whiteboard-animator es gratuito? ¿Qué licencia tiene?
whiteboard-animator es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿whiteboard-animator sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de whiteboard-animator fue el 8 sept 2026.
¿Para qué puedo usar whiteboard-animator?
Animar diagramas o bocetos de pizarra para clases o videos explicativos. Añadir un efecto de revelado dibujado a mano a contenido educativo narrado. Renderizar por lotes una serie de escenas ilustradas en un solo video desde la línea de comandos.
¿Cómo se instala whiteboard-animator?
Instalar FFmpeg (en macOS, mediante Homebrew): brew install ffmpeg Instalar el paquete desde PyPI: pip install whiteboard-animator Renderizar una imagen de pizarra blanca como un MP4 de 8 segundos: whiteboard-animate sketch.png --duration 8 -o sketch.mp4
¿Dónde consigo whiteboard-animator?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/masihsultani/whiteboard-animator

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados