Repolode
geeklee

geeklee/srt-whiteboard-animation

Una skill de IA que convierte subtítulos SRT en videos de animación de pizarra dibujados a mano sobre un fondo de papel beige cálido y los exporta como MP4.

Estrellas
4,616
Forks
720
Issues abiertos
8
Último commit
hace 3 meses

¿Qué es?

Este proyecto es una skill para agentes de IA que convierte un archivo de subtítulos SRT en una animación dibujada a mano con estilo de pizarra. Cada escena se compone de un dibujo lineal y un archivo de anotaciones que define las regiones, el orden de dibujo, los tiempos y la línea de subtítulos a la que corresponde cada elemento. Los elementos aparecen en orden narrativo y, dentro de cada región, el lápiz dibuja trazos continuos: primero el contorno de tinta y luego el relleno de color.

El flujo de trabajo se desarrolla paso a paso. La skill analiza el SRT y propone dividirlo en escenas de aproximadamente 25 a 35 segundos; después genera un dibujo lineal, crea las anotaciones y permite que el usuario ajuste las regiones y los tiempos en una página de vista previa en el navegador antes de renderizar. Las escenas individuales se renderizan en MP4 y se pueden unir para crear un video más largo. El resultado tiene un estilo minimalista, con un fondo de papel cálido, líneas de boceto gris oscuro y toques discretos de rojo, naranja y azul.

El proyecto está escrito en Python y usa OpenCV, además de incluir un script auxiliar que prepara un entorno virtual aislado.

Funciones clave

  • 01Analiza subtítulos SRT y propone dividirlos en escenas de 25 a 35 segundos.
  • 02Dibuja cada región con un trazo continuo: primero el contorno de tinta y luego el relleno de color.
  • 03Gestiona las regiones, los tiempos, los vínculos con los subtítulos y las zonas de superposición protegidas en un archivo de anotaciones JSON.
  • 04Incluye una página de vista previa en el navegador para ajustar las regiones, el orden y los tiempos.
  • 05Renderiza escenas individuales en MP4 y une varias escenas en un solo video.

Casos de uso

  • Convertir explicaciones educativas o subtítulos de cursos en videos de pizarra dibujados a mano.
  • Producir relatos narrados o contenido para videos cortos con un estilo de boceto sencillo.
  • Crear clips para compartir conocimientos en los que cada escena siga la secuencia de los subtítulos.

Inicio rápido

  1. 1

    Comprobar la configuración del entorno de Python

    python scripts/prepare_env.py --check
  2. 2

    Preparar el entorno virtual aislado

    python scripts/prepare_env.py
  3. 3

    Analizar los subtítulos SRT para proponer escenas

    python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35
  4. 4

    Renderizar una escena a MP4 con el renderizador de flujo

    <ENV_PY> scripts/render_stream_whiteboard.py <图片路径> <标注路径> <输出.mp4> assets/drawing-hand.png --ink-path grid --color-fill contour-wipe

Antes de usarlo

  • Cada escena necesita un archivo de anotaciones creado manualmente, por lo que el flujo de trabajo requiere mucho trabajo.
  • El proceso requiere confirmación en varias etapas antes del renderizado, así que no es totalmente automático.
  • El proyecto está diseñado como una habilidad de agente de IA, por lo que su flujo de trabajo presupone un asistente de IA.

Temas

Preguntas frecuentes

¿Qué es srt-whiteboard-animation?
Una skill de IA que convierte subtítulos SRT en videos de animación de pizarra dibujados a mano sobre un fondo de papel beige cálido y los exporta como MP4. Este proyecto es una skill para agentes de IA que convierte un archivo de subtítulos SRT en una animación dibujada a mano con estilo de pizarra. Cada escena se compone de un dibujo lineal y un archivo de anotaciones que define las regiones, el orden de dibujo, los tiempos y la línea de subtítulos a la que corresponde cada elemento. Los elementos aparecen en orden narrativo y, dentro de cada región, el lápiz dibuja trazos continuos: primero el contorno de tinta y luego el relleno de color.
¿srt-whiteboard-animation es gratuito? ¿Qué licencia tiene?
srt-whiteboard-animation es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿srt-whiteboard-animation sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de srt-whiteboard-animation fue el 27 jul 2026.
¿Para qué puedo usar srt-whiteboard-animation?
Convertir explicaciones educativas o subtítulos de cursos en videos de pizarra dibujados a mano. Producir relatos narrados o contenido para videos cortos con un estilo de boceto sencillo. Crear clips para compartir conocimientos en los que cada escena siga la secuencia de los subtítulos.
¿Cómo se instala srt-whiteboard-animation?
Comprobar la configuración del entorno de Python: python scripts/prepare_env.py --check Preparar el entorno virtual aislado: python scripts/prepare_env.py Analizar los subtítulos SRT para proponer escenas: python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35 Renderizar una escena a MP4 con el renderizador de flujo: <ENV_PY> scripts/render_stream_whiteboard.py <图片路径> <标注路径> <输出.mp4> assets/drawing-hand.png --ink-path grid --color-fill contour-wipe
¿Dónde consigo srt-whiteboard-animation?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/geeklee/srt-whiteboard-animation

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

Proyectos relacionados