Repolode
geeklee

geeklee/srt-whiteboard-animation

Uma skill de IA que transforma legendas SRT em animações de quadro branco desenhadas à mão, com fundo de papel bege e exportação em MP4.

Estrelas
4,616
Forks
720
Issues abertas
8
Último commit
há 3 meses

O que é?

Este projeto é uma skill de agente de IA que converte um arquivo de legendas SRT em uma animação desenhada à mão no estilo quadro branco. Cada cena é composta por um desenho linear e um arquivo de anotações que define as regiões, a ordem de desenho, o timing e a linha da legenda à qual cada elemento pertence. Os elementos aparecem na ordem narrativa e, dentro de cada região, a caneta faz traços contínuos: primeiro o contorno em tinta e, depois, o preenchimento com cor.

O fluxo de trabalho é dividido em etapas. A skill analisa o SRT e sugere divisões de cena com cerca de 25 a 35 segundos; em seguida, gera um desenho linear, cria anotações e permite que o usuário ajuste as regiões e o timing em uma página de pré-visualização no navegador antes da renderização. As cenas individuais são renderizadas em MP4 e podem ser unidas em um vídeo mais longo. A saída tem um estilo minimalista, com fundo de papel quente, traços em cinza-escuro e toques pontuais de vermelho, laranja e azul.

O projeto é escrito em Python e usa OpenCV, além de incluir um script auxiliar que prepara um ambiente virtual isolado.

Recursos principais

  • 01Analisa legendas SRT e sugere divisões de cena de 25 a 35 segundos.
  • 02Desenha cada região com um traço contínuo: primeiro o contorno em tinta e, depois, o preenchimento com cor.
  • 03Gerencia regiões, timing, vínculos com as legendas e áreas de sobreposição protegidas em um arquivo de anotações JSON.
  • 04Inclui uma página de pré-visualização no navegador para ajustar regiões, ordem e timing.
  • 05Renderiza cenas individuais em MP4 e une várias cenas em um único vídeo.

Casos de uso

  • Transformar explicações educativas ou legendas de cursos em vídeos de quadro branco desenhados à mão.
  • Produzir histórias narradas ou conteúdo para vídeos curtos em um estilo simples de esboço.
  • Criar vídeos curtos para compartilhar conhecimento, em que cada cena acompanha a sequência das legendas.

Início rápido

  1. 1

    Verificar a configuração do ambiente Python

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

    Preparar o ambiente virtual isolado

    python scripts/prepare_env.py
  3. 3

    Analisar as legendas SRT para sugerir cenas

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

    Renderizar uma cena em MP4 com o renderizador de fluxo

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

Antes de usar

  • Cada cena precisa de um arquivo de anotação feito manualmente, então o fluxo de trabalho exige bastante trabalho.
  • O processo exige confirmação em várias etapas antes da renderização, portanto não é totalmente automático.
  • O projeto foi desenvolvido como uma habilidade de agente de IA, então seu fluxo de trabalho pressupõe um assistente de IA.

Tópicos

Perguntas frequentes

O que é srt-whiteboard-animation?
Uma skill de IA que transforma legendas SRT em animações de quadro branco desenhadas à mão, com fundo de papel bege e exportação em MP4. Este projeto é uma skill de agente de IA que converte um arquivo de legendas SRT em uma animação desenhada à mão no estilo quadro branco. Cada cena é composta por um desenho linear e um arquivo de anotações que define as regiões, a ordem de desenho, o timing e a linha da legenda à qual cada elemento pertence. Os elementos aparecem na ordem narrativa e, dentro de cada região, a caneta faz traços contínuos: primeiro o contorno em tinta e, depois, o preenchimento com cor.
srt-whiteboard-animation é gratuito? Qual é a licença?
srt-whiteboard-animation é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
srt-whiteboard-animation ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de srt-whiteboard-animation foi em 27 de jul. de 2026.
Para que posso usar srt-whiteboard-animation?
Transformar explicações educativas ou legendas de cursos em vídeos de quadro branco desenhados à mão. Produzir histórias narradas ou conteúdo para vídeos curtos em um estilo simples de esboço. Criar vídeos curtos para compartilhar conhecimento, em que cada cena acompanha a sequência das legendas.
Como instalar srt-whiteboard-animation?
Verificar a configuração do ambiente Python: python scripts/prepare_env.py --check Preparar o ambiente virtual isolado: python scripts/prepare_env.py Analisar as legendas SRT para sugerir cenas: python scripts/parse_srt.py <字幕.srt> --target-sec 30 --min-sec 25 --max-sec 35 Renderizar uma cena em MP4 com o renderizador de fluxo: <ENV_PY> scripts/render_stream_whiteboard.py <图片路径> <标注路径> <输出.mp4> assets/drawing-hand.png --ink-path grid --color-fill contour-wipe
Onde consigo srt-whiteboard-animation?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/geeklee/srt-whiteboard-animation

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados