Usar FFmpeg com yt-dlp

Embora o yt-dlp seja uma ferramenta extremamente capaz para descarregar media, ele depende fortemente do FFmpeg para lidar com tarefas de pós-processamento. Sem FFmpeg, perde funcionalidades críticas como fundir streams de vídeo e áudio em alta qualidade, converter ficheiros para diferentes formatos e incorporar metadados.

Para obter o melhor do yt-dlp, é essencial instalar e configurar corretamente o FFmpeg. Este guia explica como configurar e por que é necessário.

Instalar FFmpeg e FFProbe

Para o yt-dlp utilizar o FFmpeg, precisa de acesso aos executáveis binários standalone. Nota: instalar wrappers Python como ffmpeg-python via pip não é suficiente; precisa dos builds reais do software.

Windows: descarregue as builds mais recentes. O método mais simples é extrair ffmpeg.exe e ffprobe.exe e colocá-los na mesma pasta que o seu yt-dlp.exe. Em alternativa, pode colocá-los numa pasta dedicada e adicionar essa pasta ao PATH do sistema.
Linux/macOS: geralmente é melhor instalar via gestor de pacotes (por ex. apt install ffmpeg ou brew install ffmpeg), que trata automaticamente da configuração do PATH.

Por que o FFmpeg é essencial para o yt-dlp

Pode notar que sem FFmpeg, o yt-dlp não consegue descarregar vídeos 1080p ou 4K de forma eficaz em sites como o YouTube. Isto acontece porque as plataformas modernas frequentemente servem vídeo HD e áudio de alta qualidade como streams separados.

Fusão de streams (muxing): o yt-dlp descarrega a melhor faixa de vídeo e a melhor faixa de áudio separadamente. Depois chama o FFmpeg para “muxar” (combinar) tudo num único ficheiro (como MP4 ou MKV). Sem FFmpeg, ficaria com dois ficheiros separados ou teria de escolher uma versão combinada de menor qualidade.
Conversão de formatos: se precisar de um formato de saída específico (por ex. converter um vídeo musical diretamente para MP3 ou FLAC), o FFmpeg trata do transcoding.
Metadados e capítulos: o FFProbe (parte do suite FFmpeg) permite ao yt-dlp analisar streams para garantir que metadados, miniaturas e capítulos são incorporados corretamente.

Configurar o PATH do sistema

Se preferir não manter os binários na mesma pasta que o yt-dlp, deve garantir que o seu sistema operativo sabe onde os encontrar. Isso é feito ao adicionar a pasta bin do FFmpeg à sua variável de ambiente PATH.

No Windows:

Procure “Editar as variáveis de ambiente do sistema”.
Clique em Variáveis de ambiente.
Em “Variáveis do sistema”, encontre Path e clique em Editar.
Adicione o caminho completo para o diretório bin do FFmpeg (por ex. C:\Program Files\ffmpeg\bin).

Depois de configurado, reinicie o terminal. Pode verificar se funciona executando ffmpeg -version. Se aparecerem os detalhes da versão, o yt-dlp detetará e utilizará automaticamente.

Compreender a fusão de vídeo e áudio

O poder do yt-dlp está na seleção de formatos. O comportamento por defeito é normalmente bestvideo+bestaudio/best.

O operador +: indica ao downloader para obter os melhores streams de vídeo e áudio separados.
A fusão: depois de descarregar, o FFmpeg combina tudo. Por exemplo, pode combinar um stream de vídeo WebM com um stream de áudio Opus num contentor MKV.

Se os codecs forem compatíveis com o contentor desejado (por ex. MP4), o FFmpeg irá simplesmente copiar os streams (rápido). Se forem incompatíveis, irá re-encodar (mais lento, mas garante compatibilidade). Pode controlar este comportamento com as flags de seleção de formato do yt-dlp.