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
fetchrecusou.** 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.
