masihsultani/whiteboard-animator

O que é?

Recursos principais

• 01Escreve o texto palavra por palavra e traça os contornos automaticamente.
• 02Preenche as formas com pinceladas ou uma varredura, dependendo do tamanho.
• 03Funciona na CPU com um modelo de detecção de texto incluído, sem precisar de GPU nem de chave de API.
• 04Sincroniza a duração da animação com a duração de um arquivo de narração.
• 05Concatena várias cenas em um único MP4 usando o FFmpeg.
• 06Oferece uma CLI e uma API Python com parâmetros ajustáveis.

Casos de uso

• Animar diagramas ou esboços de quadro branco para aulas ou vídeos explicativos.
• Adicionar um efeito de revelação desenhada à mão a conteúdo educacional narrado.
• Renderizar em lote uma série de cenas ilustradas em um único vídeo pela linha de comando.

Início rápido

1. 1

   Instalar o FFmpeg (no macOS, via Homebrew)

   brew install ffmpeg
2. 2

   Instalar o pacote do PyPI

   pip install whiteboard-animator
3. 3

   Renderizar uma imagem de quadro branco em um MP4 de 8 segundos

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

Antes de usar

• !Requer que o FFmpeg e o ffprobe sejam instalados separadamente e estejam no PATH.
• !Funciona melhor com desenhos de tinta no estilo de marcador sobre fundo branco; fotos e fundos coloridos não serão bem animados.
• !O ritmo da narração é estimado com base no texto, sem sincronização com a fala, então pode haver diferenças de tempo em relação à voz.

Tópicos

Perguntas frequentes

O que é whiteboard-animator?

Ferramenta de linha de comando e biblioteca Python que transforma uma imagem no estilo whiteboard em um MP4 renderizado na CPU, com revelação desenhada à mão e ritmo opcionalmente sincronizado à narração. whiteboard-animator recebe uma imagem finalizada, com tinta sobre fundo branco, e produz um vídeo em que ela é desenhada à mão. O texto é escrito palavra por palavra, os contornos são traçados, as formas são preenchidas com pinceladas ou uma varredura em ângulo, e ilustrações com ramificações são desenhadas um caminho de caneta por vez. A renderização é feita na CPU, sem necessidade de treinamento ou chaves de API, usando um detector de texto CRAFT em ONNX incluído no pacote para distinguir texto de formas.

whiteboard-animator é gratuito? Qual é a licença?

whiteboard-animator é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

whiteboard-animator ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de whiteboard-animator foi em 8 de set. de 2026.

Para que posso usar whiteboard-animator?

Animar diagramas ou esboços de quadro branco para aulas ou vídeos explicativos. Adicionar um efeito de revelação desenhada à mão a conteúdo educacional narrado. Renderizar em lote uma série de cenas ilustradas em um único vídeo pela linha de comando.

Como instalar whiteboard-animator?

Instalar o FFmpeg (no macOS, via Homebrew): brew install ffmpeg Instalar o pacote do PyPI: pip install whiteboard-animator Renderizar uma imagem de quadro branco em um MP4 de 8 segundos: whiteboard-animate sketch.png --duration 8 -o sketch.mp4

Onde consigo whiteboard-animator?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/masihsultani/whiteboard-animator