FFmpeg para Mac: instale para o OneMacTools com um clique
O FFmpeg é o mecanismo gratuito e de código aberto por trás das ferramentas de vídeo e áudio do OneMacTools. Ele não vem com o app, então, na primeira vez que você abre uma ferramenta que precisa dele, o OneMacTools oferece instalá-lo pelo Homebrew com um clique. Você também pode usar uma cópia que já tenha. As ferramentas de imagem, PDF, arquivos e IA no dispositivo nunca precisam do FFmpeg.
Nesta página
- O que é o FFmpeg e por que o OneMacTools o usa?
- Quais ferramentas do OneMacTools precisam do FFmpeg?
- Como instalar o FFmpeg no Mac pelo OneMacTools
- Usar o FFmpeg que você já tem (Homebrew, MacPorts ou sua própria compilação)
- Formatos e codecs que o FFmpeg libera
- Outros auxiliares: yt-dlp, ferramentas WebP e Ghostscript
- Atualizar o FFmpeg
- O FFmpeg não funciona? Soluções para problemas comuns
- Ferramentas mencionadas nesta página
- Perguntas
O que é o FFmpeg e por que o OneMacTools o usa?
O FFmpeg é um programa de código aberto muito usado para ler, converter e editar áudio e vídeo. Ele entende muito mais formatos e codecs do que o macOS sozinho: contêineres WebM e MKV, os codecs VP9 e Opus, codificação MP3, codificação em duas passagens para atingir um tamanho de arquivo exato, filtros de redução de ruído e mais. A maioria dos apps e sites de vídeo depende dele nos bastidores.
O OneMacTools executa o FFmpeg no seu Mac, só para os seus arquivos. Nada é enviado: o FFmpeg lê o original, grava o resultado em uma pasta temporária e o OneMacTools move o arquivo pronto para a sua pasta de saída. O FFmpeg também vem com o ffprobe, que o OneMacTools usa para ler a duração, o tamanho e os codecs de um arquivo quando o macOS não consegue (por exemplo, um arquivo MKV ou WebM).
O FFmpeg é um projeto separado, com licença própria, então o OneMacTools não o inclui. Ele só é instalado pelo Homebrew quando você pede, como descrito nos nossos termos de software de terceiros e na política de privacidade.
Quais ferramentas do OneMacTools precisam do FFmpeg?
Estas ferramentas mostram uma linha Com tecnologia FFmpeg no inspetor e não funcionam sem ele:
| Categoria | Ferramentas que precisam do FFmpeg |
|---|---|
| Vídeo | Comprimir vídeo, Comprimir para tamanho, Converter vídeo, Cortar vídeo, Redimensionar vídeo, Recortar vídeo, Girar e espelhar vídeo, Alterar velocidade, Silenciar vídeo, Substituir áudio, Marca d'água em vídeo, Predefinições de vídeo social, Mesclar vídeos, Vídeo para GIF, Extrair quadros, Loop, inverter e bumerangue |
| Áudio | Extrair áudio, Converter áudio, Limpar áudio, Cortar áudio, Criador de toques, Mesclar e nivelar áudio |
| Imagens | GIF para MP4 |
| Baixar | Baixar vídeo (também precisa do yt-dlp) |
Ferramentas que usam o FFmpeg só para uma opção
- Gravador de tela: salvar como GIF usa o FFmpeg. Sem ele, a gravação nunca se perde; ela é salva como MP4 com a nota “Salvo como MP4 — GIFs precisam do FFmpeg, que você pode instalar em Ajustes”.
- Legendas automáticas: Faixa de legendas (pode ser desativada) precisa do FFmpeg. Gravadas na imagem funciona sem ele.
Todo o resto, incluindo todas as ferramentas de imagem, PDF, arquivos, utilitários e IA no dispositivo, Gravar áudio, Corrigir cores de vídeo HDR e as telas de Seu Mac, usa os frameworks do próprio macOS e nunca precisa do FFmpeg.
Como instalar o FFmpeg no Mac pelo OneMacTools
O OneMacTools instala o FFmpeg com o Homebrew, o gerenciador de pacotes padrão do Mac. Se o Homebrew já estiver no seu Mac, é um clique:
- Abra qualquer ferramenta que precise do FFmpeg, como Converter vídeo. Um aviso laranja no topo diz Esta ferramenta precisa do FFmpeg com “O OneMacTools pode instalá-lo para você com o Homebrew.”
- Clique em Instalar. O banner mostra Instalando… enquanto o Homebrew baixa e instala o FFmpeg. Você pode continuar usando outras ferramentas enquanto isso.
- Quando termina, o aviso some e a ferramenta fica pronta. O FFmpeg passa a funcionar em todas as ferramentas da lista acima.
Você pode fazer o mesmo em Ajustes › Auxiliares: ao lado de FFmpeg, clique em Instalar com o Homebrew. Depois da instalação, a linha mostra um sinal verde e o local do FFmpeg, como /opt/homebrew/bin/ffmpeg.
Onde o FFmpeg fica guardado e qual é o tamanho dele
O Homebrew coloca o FFmpeg em sua própria pasta: /opt/homebrew em Macs com Apple silicon, /usr/local em Macs Intel. O OneMacTools não o copia para o app nem para a sua Biblioteca. O Homebrew também instala as bibliotecas de que o FFmpeg depende, então o tamanho do download depende do que você já tem; a primeira instalação pode levar alguns minutos em uma conexão lenta.
Usar o FFmpeg que você já tem (Homebrew, MacPorts ou sua própria compilação)
O OneMacTools procura um programa ffmpeg nestas pastas, nesta ordem, e usa o primeiro que encontrar:
/opt/homebrew/bin(Homebrew em Apple silicon)/usr/local/bin(Homebrew em Intel e muitas instalações manuais)/opt/local/bin(MacPorts)
Então, se você mesmo instalou o FFmpeg com brew install ffmpeg ou MacPorts, não há nada a fazer: Ajustes › Auxiliares já mostrará o sinal verde.
Caminho personalizado do FFmpeg
Se sua cópia está em outro lugar, por exemplo um build estático na sua pasta pessoal, digite o caminho completo em Caminho personalizado do FFmpeg em Ajustes › Auxiliares e pressione Return. O caminho precisa apontar para o próprio programa ffmpeg (não para a pasta) e o arquivo precisa ser executável. Um caminho personalizado tem prioridade sobre as pastas acima. Para ler os detalhes dos arquivos, o OneMacTools procura o ffprobe na mesma pasta do FFmpeg que usa, então mantenha os dois juntos.
Formatos e codecs que o FFmpeg libera
Com o FFmpeg instalado, estes são os formatos que as ferramentas de conversão do OneMacTools geram:
| Saída | Codec de vídeo | Codec de áudio |
|---|---|---|
| MP4 e MOV | H.264 (yuv420p, roda em qualquer lugar), otimizado para streaming | AAC 160 kbps |
| MKV | H.264 | AAC 160 kbps |
| WebM | VP9 | Opus 128 kbps |
| MP3 | MP3 (LAME, VBR de alta qualidade) | |
| M4A | AAC 192 kbps | |
| WAV / AIFF | PCM de 16 bits | |
| FLAC | FLAC (sem perdas) |
Converter vídeo aceita arquivos MP4, MOV, WebM, MKV e M4V e grava MP4, MOV, WebM ou MKV. Converter áudio grava MP3, M4A, WAV ou FLAC. Comprimir para tamanho usa codificação em duas passagens para que o resultado fique abaixo do tamanho que você escolher. Para passo a passo, consulte MOV para MP4 no Mac e comprimir um vídeo para e-mail.
Outros auxiliares: yt-dlp, ferramentas WebP e Ghostscript
Ajustes › Auxiliares lista mais três programas de código aberto dos quais algumas ferramentas dependem. Eles são instalados do mesmo jeito, pelo aviso da ferramenta ou por Instalar com o Homebrew:
| Auxiliar | Usado por | Por quê |
|---|---|---|
| yt-dlp | Baixar vídeo | Busca o vídeo a partir do link que você cola. |
| Ferramentas WebP | Converter para WebP | O macOS consegue ler WebP, mas não gravar. |
| Ghostscript | PDF para PDF/A | Grava arquivos PDF/A para arquivamento. |
Atualizar o FFmpeg
O OneMacTools não atualiza o FFmpeg sozinho; quem cuida dele é o Homebrew. Para atualizar, abra o Terminal e execute brew upgrade ffmpeg. O OneMacTools passa a usar a nova versão na próxima vez que uma ferramenta rodar, sem precisar reiniciar. O mesmo vale para o yt-dlp: se Baixar vídeo disser que um site recusou o download ou que um arquivo veio sem imagem, a mensagem sugere executar brew upgrade yt-dlp.
Atualizar o próprio OneMacTools (OneMacTools › Buscar atualizações…) nunca remove nem substitui o FFmpeg.
O FFmpeg não funciona? Soluções para problemas comuns
| O que você vê | O que fazer |
|---|---|
| “O FFmpeg não está instalado. Instale-o pelo banner acima ou em Ajustes.” | Clique em Instalar no banner, ou em Ajustes › Auxiliares › Instalar com o Homebrew. |
| “O Homebrew não está instalado…” | Instale o Homebrew a partir de brew.sh, ou digite um Caminho personalizado do FFmpeg. |
| “Não foi possível instalar o FFmpeg: …” | O Homebrew informou um erro. Execute brew doctor no Terminal, corrija o que ele listar e tente de novo; ou execute brew install ffmpeg você mesmo para ver a saída completa. |
| Caminho personalizado digitado, mas sem o visto verde | Confira se o caminho termina em ffmpeg, se o arquivo existe e se é executável. Pressione Return no campo para verificar de novo. |
| “Uma faixa de legendas que pode ser desativada precisa do FFmpeg…” | Instale o FFmpeg, ou escolha Gravadas na imagem em Legendas automáticas. |
| Uma gravação de tela salva como MP4 em vez de GIF | O FFmpeg não foi encontrado, ou a criação do GIF falhou. Instale o FFmpeg e depois converta o MP4 com Vídeo para GIF. |
Se uma tarefa falhar por outro motivo, a mensagem aparece na ferramenta e no Histórico. O guia de solução de problemas cobre todos os outros erros por sintoma.
Ferramentas mencionadas nesta página
Perguntas
O FFmpeg é gratuito e seguro de instalar em um Mac?
Sim. O FFmpeg é um software livre e de código aberto usado por inúmeros apps. O OneMacTools instala o pacote padrão do Homebrew a partir da fonte oficial do Homebrew, e o FFmpeg só roda nos seus próprios arquivos, no seu Mac.
O OneMacTools funciona sem o FFmpeg?
Sim. As ferramentas de imagem, PDF, arquivos, utilitários e IA no dispositivo nunca precisam dele, e as telas de Seu Mac também não. Só as ferramentas de vídeo e áudio listadas nesta página, GIF para MP4 e Baixar vídeo exigem o FFmpeg.
Posso usar o FFmpeg sem o Homebrew?
Sim. Baixe ou compile o FFmpeg como preferir e digite o caminho completo do programa ffmpeg em Ajustes › Auxiliares › Caminho personalizado do FFmpeg. O OneMacTools também encontra automaticamente cópias do MacPorts em /opt/local/bin.
Como desinstalo o FFmpeg?
Execute brew uninstall ffmpeg no Terminal. O OneMacTools mostrará o aviso de instalação de novo na próxima vez que você abrir uma ferramenta que precise dele. Desinstalar não afeta os resultados que você já gerou.
Por que o OneMacTools ainda diz que falta o FFmpeg depois que eu o instalei?
Ele só procura em /opt/homebrew/bin, /usr/local/bin e /opt/local/bin, além do seu caminho personalizado. Se sua cópia está em outro lugar, digite o caminho completo em Ajustes › Auxiliares e pressione Return.
O OneMacTools converte MKV ou WebM para MP4?
Sim, depois que o FFmpeg estiver instalado. Solte os arquivos MKV ou WebM em Converter vídeo e escolha MP4; o resultado usa vídeo H.264 e áudio AAC, então é reproduzido no QuickTime, no Fotos, no iPhone e em quase todos os apps e sites. Um lote de arquivos é convertido um após o outro em uma única pasta com data.
Preciso do ffprobe além do FFmpeg?
O Homebrew instala o ffprobe junto com o FFmpeg automaticamente. O OneMacTools o usa para ler a duração, o tamanho e os codecs de arquivos que o macOS não consegue abrir sozinho, como MKV, para que o progresso e o tempo restante sejam precisos. Se você usa um caminho personalizado, mantenha o ffprobe na mesma pasta.
O OneMacTools inclui o FFmpeg?
Não. O FFmpeg é um projeto de código aberto separado, com licença própria, então ele só é instalado pelo Homebrew quando você pede, e é mantido atualizado pelo Homebrew, não pelo app.