engenheirode vídeo.
Tutorial · Tutoriais

Como coletar b-roll com fonte registrada e revisão

Passo a passo para coletar b-roll com aprovação humana, direitos registrados e ORIGEM.md em cada entrega.

Aviso: O /get-brolls é um software proprietário dos Engenheiros de Vídeo, com todos os direitos reservados. Ele não é gratuito nem de código aberto. Baixar, instalar ou usar depende de autorização prévia, formalizada por e-mail. Ver a documentação do /get-brolls.

B-roll bom não é o que fica bonito na timeline. É o que você consegue defender depois: de onde veio, quem fez, se pode usar e quem aprovou. Este passo a passo mostra como coletar B-roll assim com o get-brolls, usando uma fonte que não pede chave nenhuma (a NASA). Os comandos são da versão pública atual, a 2.5.2. Se ainda não instalou, comece por como instalar o get-brolls.

O problema que isso resolve

Todo mundo já baixou um clipe às pressas, jogou na timeline e, três semanas depois, não lembrava mais de onde veio. Com cliente, isso vira dor de cabeça. O fluxo abaixo troca pressa por registro: nada é baixado sem aprovação humana e sem condições de uso anotadas, e cada entrega sai com um arquivo ORIGEM.md.

O que você precisa antes

Python 3.11 ou mais novo, FFmpeg, Node 22+, curl e Git, mais o Claude Code ou o Codex. Instalada a skill, rode o doctor e só continue com summary.missing vazio:

python3 scripts/gb.py doctor

Passo 1: buscar candidatos

Troque /caminho/meu-video pela pasta do seu vídeo. A busca devolve candidatos com um ID e não baixa nada.

python3 scripts/gb.py search --provider nasa --query "Artemis launch" --limit 3 --intent literal --project /caminho/meu-video

O --intent literal diz que você quer a coisa real citada na fala, não um vídeo bonito qualquer. Banco de imagens só entra quando você pede stock de propósito.

Passo 2: ver o trecho em movimento

python3 scripts/gb.py preview --candidate "<ID>" --start 0 --end 4 --project /caminho/meu-video

Isso gera um GIF e uma folha de quadros numerados. Mantenha as aspas no ID: ele pode ter espaço. Olhar o movimento evita escolher um trecho com texto sobreposto ou corte no meio da ação.

Passo 3: aprovar no Storyboard

python3 scripts/gb.py review --project /caminho/meu-video
python3 scripts/gb.py serve --background --project /caminho/meu-video

Abra o endereço que o comando devolver, clique em Aprovar nos trechos que servem e depois em salvar as decisões. Para trazer a aprovação de volta:

python3 scripts/gb.py import-review --by "Seu nome" --project /caminho/meu-video

Aqui está a revisão humana de verdade: o nome de quem aprovou fica registrado. Só use approve --all se você viu todas as prévias.

Passo 4: registrar as condições de uso

python3 scripts/gb.py permit --candidate "<ID>" --preset nasa --project /caminho/meu-video

Existem três formas: --evidence com as condições que você leu na página da fonte, --preset com o texto padrão da fonte, ou --declared-by quando você assume a responsabilidade por escrito. A ferramenta só registra. Ela não confere licença. Quem responde pelo uso é você, então abra a página da fonte e leia.

Passo 5: baixar, conferir e entregar

python3 scripts/gb.py fetch --candidate "<ID>" --project /caminho/meu-video
python3 scripts/gb.py verify --project /caminho/meu-video
python3 scripts/gb.py deliver --project /caminho/meu-video

O fetch corta só o trecho aprovado. O verify confere se cada arquivo está inteiro e abre. O deliver organiza tudo em entrega/, uma pasta por beat, com o corte, a folha de quadros e o ORIGEM.md (fonte, autor, trecho e hash).

Quando algo dá errado

  • **O fetch recusou.** Faltou a aprovação ou o registro de direitos. É a trava funcionando.
  • A prévia saiu sem número nos quadros. Seu FFmpeg veio sem suporte a texto (drawtext). Reinstale pelo gerenciador de pacotes.
  • YouTube ou Instagram falharam. Confira o Node e o doctor. Essas fontes dependem de ferramentas extras e mudam de comportamento sem aviso.
  • Não achou nada bom. Acontece. Reformule a busca ou rejeite os candidatos com reject --reason; o motivo fica salvo.

O que eu não automatizaria

Aprovação e direitos. Um script que aprova tudo sozinho derruba a única coisa que protege o seu vídeo. Automatize a busca, a prévia e a organização; deixe a decisão com uma pessoa.

Quer ver a lista completa de comandos? A documentação do get-brolls tem tudo, e a prévia da 2.6 mostra o que vem a seguir. Se quiser trocar ideia com quem usa isso no dia a dia, a Comunidade dos Engenheiros de Vídeo é o lugar.

Puxe o próximo fio

Uma ideia leva a outra.

Todos os conteúdos ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial5 min de leitura

Transcrição local com Whisper na GPU

Como rodar o Whisper na placa de vídeo do seu computador para transcrever horas de material, palavra por palavra, sem pagar por minuto.

TutoriaisLer conteúdo ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial5 min de leitura

Os programas que você precisa instalar para editar com IA

A stack mínima para editar vídeo com IA, explicada programa por programa, com os comandos de instalação no Mac e no Windows.

TutoriaisLer conteúdo ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial5 min de leitura

Legendas dinâmicas com IA: passo a passo

Da transcrição palavra por palavra ao arquivo pronto para a timeline: como fazer o agente gerar legendas dinâmicas sem texto encavalado.

TutoriaisLer conteúdo ↗