Como gerar vídeos whiteboard em lote com Python e ffmpeg
Use a versão avançada do Editor de Vídeo Online em Python para gerar vídeos de mão desenhando em lote, a 30 fps exatos, com mão, duração e formato configuráveis.

Precisa produzir 20 vídeos de mão desenhando para um curso? Ou uma série de dicas para postar a semana inteira? Fazer um por um no navegador funciona, mas consome tempo, porque a gravação é em tempo real. Para isso existe a versão avançada do Editor de Vídeo Online, um script em Python que permite gerar vídeos em lote, com qualidade máxima e exatamente 30 quadros por segundo.
O que a versão avançada faz
- Gera vídeos de mão desenhando a partir de imagens (só esse modo).
- Processa uma imagem ou uma pasta inteira de uma vez.
- Exporta MP4 H.264 a 30 fps fixos, sem depender da aba do navegador.
- Permite configurar duração, formato, sensibilidade, pincel e mão.
Ela fica na pasta avancado do Editor de Vídeo Online, junto com as mãos mao_padrao.png e mao_manga.png.
Instalação
Você precisa de Python e ffmpeg.
Windows
- Instale o Python pelo site python.org e marque "Add Python to PATH" na instalação.
- No terminal, rode
winget install ffmpeg. - Na pasta
avancado, rode:
pip install -r dependencias-python.txt
Mac
brew install python ffmpeg
pip3 install -r dependencias-python.txt
As dependências são opencv-python, scikit-image e numpy.
Uso básico
Um desenho:
python gerar_video.py desenho.png
Uma pasta inteira (gera um vídeo para cada imagem):
python gerar_video.py pasta_com_desenhos/
Com outra mão e duração de 40 segundos:
python gerar_video.py desenho.png --mao mao_manga.png --duracao 40
Todas as opções
| Opção | O que faz | Padrão |
|---|---|---|
--saida | Arquivo .mp4 de saída (ou pasta, se a entrada for pasta) | Ao lado da imagem (pasta videos para pastas) |
--duracao | Segundos de desenho | 30 |
--final | Segundos com o desenho completo parado no fim | 2,5 |
--formato | vertical, horizontal, quadrado ou original | vertical |
--limiar | Sensibilidade do traço, de 80 a 240 | 190 |
--pincel | Espessura do pincel | 1.0 |
--mao | PNG transparente da mão | mao_padrao.png |
--ponta | Posição x,y da ponta do lápis no PNG da mão | 0,83 |
--base | Largura da mão (sem braço) no PNG, em pixels | 275 |
--tamanho | Escala da mão | 1.0 |
Exemplo completo, em formato horizontal:
python gerar_video.py desenho.png --duracao 40 --formato horizontal --saida meu_video.mp4
Com a sua própria mão:
python gerar_video.py desenho.png --mao minha_mao.png --ponta 0,83 --base 275
Para preparar a sua mão, veja como usar a sua própria mão na animação.
Fluxo de produção em série
- Padronize os esboços: mesmo formato, mesma espessura de traço, fundo branco. Veja como preparar um esboço.
- Nomeie os arquivos em ordem:
01-abertura.png,02-problema.png… - Teste um arquivo com diferentes valores de
--limiare--pincelaté ficar bom. - Rode a pasta inteira com os mesmos parâmetros.
- Monte os vídeos no Estúdio do Editor de Vídeo Online (com Importar vídeo) ou no seu editor preferido.
Navegador ou Python: quando usar cada um
| Situação | Melhor opção |
|---|---|
| Um vídeo, ajustes visuais na hora | Navegador |
| Colagem Vox ou Efeito papel | Navegador |
| Muitos vídeos de mão desenhando iguais | Python |
| 30 fps exatos e garantidos | Python |
| Computador lento para gravar em tempo real | Python |
Perguntas frequentes
A versão em Python faz colagens?
Não. A versão avançada é só para o modo Mão desenhando. Colagem Vox e Efeito papel são usados no navegador.
Preciso saber programar?
Não. Basta rodar os comandos deste guia no terminal, trocando o nome dos arquivos.
O vídeo sai com áudio?
Não. Adicione narração e música depois, no seu editor de vídeo. Veja como adicionar narração e música.
Conclusão
Para produção em escala, a versão avançada em Python é a ferramenta certa: uma pasta de esboços entra, uma pasta de MP4 sai. Para ajustes visuais e outros estilos, continue usando o Editor de Vídeo Online no navegador.
Faça o seu vídeo animado agora
O Editor de Vídeo Online roda no navegador (Chrome ou Edge): envie a imagem, escolha o estilo e grave o vídeo em MP4. Sem instalar nada.
Experimentar o Editor de Vídeo Online →



