Como reproduzir um vídeo com o FFmpeg (ffplay) no Windows 10

Resposta rápida: para reproduzir um vídeo com o FFmpeg no Windows 10, use ffplayo FFmpeg, o pequeno reprodutor de mídia que acompanha muitas versões do FFmpeg. Se o FFmpeg estiver no seu PATH, o comando básico é ` ffmpeg --help` ffplay "C:\Videos\My video.mp4". Adicione -fs`--fullscreen` se quiser que o vídeo seja iniciado em tela cheia.

O FFplay foi concebido para ser simples. A documentação oficial o descreve como um reprodutor de mídia portátil baseado nas bibliotecas FFmpeg e SDL, usado principalmente como plataforma de testes para as APIs do FFmpeg. Isso significa que ele é excelente para pré-visualizações rápidas e solução de problemas, mas não se comporta como um reprodutor completo para desktop com uma barra de reprodução permanente.

1. Certifique-se de que sua versão do FFmpeg inclua o ffplay.

O projeto FFmpeg publica o código-fonte em vez de um instalador próprio para Windows. Sua página oficial de downloads direciona os usuários do Windows para versões compiladas. Após baixar e extrair uma versão compilada, abra a binpasta e confirme se o arquivo ffplay.exeestá presente junto com ferramentas como ` ffmpeg.exeffmpeg` e `ffmpeg` ffprobe.exe.

Se o seu pacote não contiver ffplay.exe, use uma versão para Windows que o inclua. Você não precisa de uma interface gráfica separada apenas para visualizar um vídeo local.

2. Confirme se o ffplay está sendo executado a partir do Prompt de Comando.

Abra o Prompt de Comando ou o PowerShell e execute:

ffplay -version

Se você visualizar as informações da versão, o Windows conseguirá encontrar o executável. Se você receber uma mensagem como "'ffplay' não é reconhecido" , adicione o bindiretório do FFmpeg ao PATH ou execute o arquivo executável pelo seu caminho completo, por exemplo:

C:\ffmpeg\bin\ffplay.exe -version

3. Reproduza um vídeo local com o ffplay

O método mais simples é passar o arquivo de vídeo para ffplay. As aspas são importantes quando uma pasta ou nome de arquivo contém espaços:

ffplay "C:\Users\YourName\Videos\My video.mp4"

Você também pode acessar primeiro a pasta do vídeo:

cd /d "C:\Users\YourName\Videos"
ffplay "My video.mp4"

O FFplay abre uma janela de reprodução separada e inicia o arquivo. Ao contrário de um reprodutor de mídia típico, ele não requer controles de reprodução visíveis na tela; a maior parte da interação é feita com o teclado e o mouse.

4. Inicie o modo de tela cheia e use os controles de reprodução.

O FFplay não precisa iniciar em tela cheia. Para solicitar o modo tela cheia ao iniciar, use a -fsopção documentada:

ffplay -fs "C:\Users\YourName\Videos\My video.mp4"

Você também pode definir um volume de inicialização de 0 a 100, por exemplo ffplay -volume 60 "My video.mp4", ou repetir continuamente com ffplay -loop 0 "My video.mp4".

Os controles úteis da documentação atual do ffplay incluem:

Problemas comuns do ffplay no Windows 10

'ffplay' não é reconhecido

Geralmente, isso é um problema de PATH ou uma versão que não inclui o FFmpeg ffplay.exe. Execute o comando com o caminho completo ffplay.exeprimeiro. Se isso funcionar, você pode adicionar a binpasta do FFmpeg ao PATH para maior conveniência.

O caminho do arquivo falha

Coloque o caminho completo entre aspas duplas, especialmente se ele contiver espaços. Além disso, verifique a extensão e o nome do arquivo no Explorador de Arquivos em vez de digitá-los de memória.

O reprodutor fecha imediatamente

Inicie o ffplay a partir de um terminal já aberto, em vez de clicar duas vezes em um executável. O terminal permanece visível para que você possa ler quaisquer erros de decodificação, acesso a arquivos ou sintaxe que o ffplay exibir.

O vídeo não tem imagem nem áudio.

O suporte a codecs e formatos pode variar de acordo com a versão do Windows instalada. Experimente uma versão atualizada, disponível na página de downloads do FFmpeg, e verifique a saída do console para identificar erros específicos de decodificador ou fluxo. Você também pode executar o comando ffprobe "file.mp4"para inspecionar os fluxos antes da reprodução.

Uma observação sobre o suporte ao Windows 10.

A Microsoft encerrou o suporte padrão para o Windows 10 Home, Pro, Enterprise e Education em 14 de outubro de 2025. Os comandos ffplay acima ainda podem funcionar em sistemas Windows 10 que executam a versão do FFmpeg escolhida, mas a Microsoft recomenda a migração para uma versão do Windows com suporte, sempre que possível. Consulte o aviso de fim de suporte do Windows 10 da Microsoft para obter detalhes sobre o ciclo de vida.