Python · local · versão 1.0.0Um assunto. Um plano.
Um assunto. Um plano.
Muitas narrativas.
Organize a direção do seu próximo vídeo com cenas, tempos e prompts prontos para desenvolver.
Organize a direção do seu próximo vídeo com cenas, tempos e prompts prontos para desenvolver.
Uma ferramenta em Python para quem planeja vídeos educativos e narrativos. A partir de um assunto, organiza as cenas, os tempos previstos e as orientações de imagem, voz e música em dois arquivos. O histórico local ajuda a variar as escolhas entre trabalhos. Basta ter Python 3.9 ou superior: a criação do plano funciona offline, sem chave de API. O roteiro final, o áudio e o vídeo são produzidos depois, com outras ferramentas.
O motor entrega um briefing. Você revisa a narrativa e escolhe como produzir cada cena.
Origem e legado, mito e revelação, problema e solução, cronologia reversa, lugares e objeto-testemunha.
Uma principal e duas de apoio, com orientações para câmera, transições, texto e som.
O histórico evita algumas escolhas recentes. Com as opções esgotadas, o motor pode repetir.
As escolhas são sorteadas entre opções configuradas, considerando o histórico. O motor não pesquisa o tema nem avalia automaticamente se cada escolha combina com ele.
Sem instalação de pacotes. Git é útil para baixar o repositório; também é possível baixar o ZIP pelo GitHub.
python3 --version
Os comandos abaixo usam exemplos em português. A interface do motor e os textos gerados permanecem em pt-BR.
Abra o terminal na pasta onde deseja guardar os arquivos.
git clone https://github.com/inematds/motor-videos-narrativos.git cd motor-videos-narrativos python3 motor_video.py --help
A duração aceita vai de 20 a 600 segundos. Há formatos vertical, quadrado e horizontal.
python3 motor_video.py --tema "Como o café chegou ao Brasil" --duracao 60 --formato 9:16 --objetivo "educar e gerar curiosidade" --publico "público geral" --cta "Comente o que você descobriu"
O terminal mostra a pasta criada em jobs/. O plano.json organiza os dados; o prompt_pack.md apresenta cada cena e o checklist. O history.json nasce automaticamente na raiz.
python3 motor_video.py --tema "Por que as cidades antigas surgiam perto dos rios" --duracao 45 --formato 16:9 --seed 20261011 --voz informative_warm --out jobs/meu-plano
Use uma pasta nova em --out: arquivos existentes com os mesmos nomes são sobrescritos. Para repetir as escolhas, preserve a seed, os argumentos, a configuração e o histórico de entrada; só a seed não basta. Data e identificador podem mudar.
Preencha os espaços de texto falado, confira os fatos e revise as escolhas de direção. Depois produza a narração e meça sua duração para ajustar as cenas. Imagens, trilha, legendas, montagem e exportação do MP4 são etapas externas ao motor.
python3 -m json.tool jobs/meu-plano/plano.json
São planos de produção, sem roteiro final nem vídeo renderizado. Os materiais de origem estão em português.
Ler o DNA audiovisual da referência · Ler a proposta original
Os documentos originais descrevem o fluxo desejado e medições relatadas da referência. Não são evidência de renderização por este script. A mídia de referência não integra o pacote recebido.