engenheirode vídeo.
Tutorial · Tutoriais

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.

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, rode brew 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ão python3.
  • 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.

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

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 ↗
ENGENHEIRO DE VÍDEO / TUTORIAL TUTORIAIS
Tutorial4 min de leitura

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.

TutoriaisLer conteúdo ↗