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.
Quando alguém do meu grupo de editores trava logo no começo, quase sempre é a mesma coisa: falta um programa, ou ele está instalado do jeito errado. O agente tenta rodar um comando, não encontra a ferramenta e começa a inventar caminho.
Este post lista o que eu uso e o que o get-brolls exige, explica para que serve cada programa em linguagem de editor e mostra como instalar no Mac e no Windows. Não tem nada aqui que eu não use de verdade.
Por que editor precisa de “programa de programador”
Editar com IA, hoje, quer dizer ter um agente trabalhando no seu computador. Ele não clica no Premiere. Ele roda programas pelo terminal: um para cortar vídeo, outro para baixar, outro para transcrever. Se esses programas não estão lá, o agente fica de mãos atadas.
Pense como um plugin que o seu editor exige para abrir um projeto. Sem ele, o projeto abre pela metade.
1. O agente: Claude Code ou Codex
É quem lê suas instruções e executa o trabalho. Eu uso os dois. O get-brolls funciona nos dois: no Claude Code ele também pode ser instalado como plugin; no Codex, como skill numa pasta.
Os dois são pagos por assinatura, e o uso pesado gasta limite. Comece com o plano mais simples e só suba quando o seu fluxo estiver redondo.
2. Terminal
Você não precisa saber programar, mas vai abrir o terminal de vez em quando. No Mac, é o app Terminal. No Windows, o PowerShell. Na maior parte do tempo, quem digita os comandos é o agente; você só confere.
3. Python 3.11 ou mais novo
É a linguagem em que muita ferramenta de vídeo com IA é escrita, incluindo o get-brolls. Sem o Python, essas ferramentas nem abrem. Versão antiga também não serve: o get-brolls pede 3.11 ou mais novo.
4. FFmpeg e ffprobe
Se você instalar um programa só desta lista, que seja este. O FFmpeg é o canivete suíço do vídeo: corta, converte, extrai áudio, gera GIF, monta folha de quadros. O ffprobe, que vem junto, lê as informações do arquivo (duração, resolução, codec).
Um detalhe que pega muita gente: o FFmpeg precisa vir com suporte a texto (drawtext, que depende da biblioteca libfreetype). Sem isso, as prévias do get-brolls saem sem número e sem timecode nos quadros.
5. Node 22 ou mais novo (com npm)
O Node roda programas escritos em JavaScript. Na edição com IA, ele aparece em dois lugares: no navegador automatizado (Playwright) e no runtime que o yt-dlp usa para o YouTube. Sem ele, YouTube e Instagram falham no get-brolls. Ferramentas de motion por código, como HyperFrames e Remotion, também rodam em cima do Node.
6. Git
Serve para baixar e atualizar repositórios: é assim que a maior parte das skills e ferramentas é distribuída. Também guarda o histórico das suas mudanças, o que salva a vida quando o agente estraga um arquivo.
7. curl
Programa de download pela linha de comando. Já vem no Mac e no Windows recente. O get-brolls usa no fluxo do Instagram.
8. yt-dlp e Playwright CLI
O yt-dlp baixa vídeo de YouTube, TikTok e outros sites. O Playwright controla um navegador, usado quando a fonte precisa de navegador, como no Instagram.
No get-brolls você não instala esses dois à mão: o instalador da skill baixa as versões registradas para dentro da pasta dela.
Como instalar tudo
Mac (com o Homebrew, o gerenciador de pacotes mais usado no macOS):
brew install python ffmpeg node git curl
Windows (pelo winget, no PowerShell):
winget install Python.Python.3.13 Gyan.FFmpeg OpenJS.NodeJS.LTS Git.Git
Ubuntu/Debian:
sudo apt install python3 python3-venv ffmpeg nodejs npm curl git
Depois de instalar, feche e abra o terminal. Para conferir as versões:
python3 --version
ffmpeg -version
node --version
git --version
No Windows, use python --version em vez de python3.
Notas para o Mac
- O Homebrew é instalado uma vez e cuida do resto.
- Se o FFmpeg vier sem
drawtext, rodebrew reinstall ffmpeg. - Em Mac com chip Apple, a transcrição local pode rodar na placa de vídeo pelo MLX. Explico em transcrição local com Whisper na GPU.
Notas para o Windows
- Ao instalar Python e Node, deixe marcada a opção de adicionar ao
PATH. Sem isso, o terminal não encontra os programas. - O comando é
python, nãopython3. - Para rodar o instalador do get-brolls, use
powershell -ExecutionPolicy Bypass -File scripts/install.ps1. Não precisa de WSL nem de Git Bash.
Como conferir que está tudo certo
Com o get-brolls instalado, o doctor faz a conferência por você:
python3 scripts/gb.py doctor
Está pronto quando summary.missing vem vazio. Se aparecer alguma coisa ali, é o nome do que falta instalar. O passo a passo completo está em como instalar o get-brolls.
O que fica fora desta lista (de propósito)
- O seu editor. DaVinci Resolve, Premiere ou Final Cut continuam onde estão. A IA prepara o material; a finalização é sua.
- Dezenas de skills globais. Instalar tudo que aparece no GitHub deixa o agente com centenas de opções e piora o resultado. Instale por projeto. Explico como em como organizar skills e projetos para editar com IA.
- Ferramenta de origem duvidosa. Repositório que você não sabe quem fez, ou “pacote premium” de algo que é gratuito, fica de fora.
Próximo passo
Com a stack instalada, volte para o mapa geral em edição de vídeo com IA: por onde começar e escolha a primeira tarefa para automatizar. Se travar em alguma instalação, a Comunidade dos Engenheiros de Vídeo é onde a gente resolve isso junto.
