25/11/2023, 07:08 ffplay Documentação

ffplay Documentação

Índice

1 Sinopse
ffplay [options] [input_url]

2 Descrição
FFplay é um media player muito simples e portátil usando o FFmpeg bibliotecas e a biblioteca SDL. É usado principalmente
como um banco de ensaio para o várias APIs FFmpeg.

3 Opções
Todas as opções numéricas, se não especificadas de outra forma, aceitam uma cadeia de caracteres representando um número
como entrada, que pode ser seguido por um dos SI prefixos unitários, por exemplo: 'K', 'M' ou 'G'.

Se 'i' for anexado ao prefixo da unidade SI, o prefixo completo será interpretado como um prefixo de unidade para múltiplos
binários, que são baseados em poderes de 1024 em vez de poderes de 1000. Anexar 'B' à unidade SI prefixo multiplica o valor
por 8. Isso permite usar, por exemplo: 'KB', 'MiB', 'G' e 'B' como sufixos numéricos.

As opções que não usam argumentos são opções booleanas e definem o valor correspondente a true. Eles podem ser definidos
como false por prefixo o nome da opção com "não". Por exemplo, usando "-nofoo" definirá a opção booleana com o nome "foo"
como false.

3.1 Especificadores de fluxo

Algumas opções são aplicadas por fluxo, por exemplo, taxa de bits ou codec. Especificadores de fluxo são usados para
especificar com precisão a qual(is) fluxo(s) uma determinada opção pertence.

Um especificador de fluxo é uma cadeia de caracteres geralmente anexada ao nome da opção e separada dela por dois pontos.
Por exemplo, Contém o especificador de fluxo, que corresponde ao segundo fluxo de áudio. Portanto, selecionaria o codec AC3
para o segundo fluxo de áudio. -codec:a:1 ac3a:1

Um especificador de fluxo pode corresponder a vários fluxos, de modo que a opção seja aplicada a todos deles. Por exemplo, o
especificador de fluxo corresponde a todo o áudio Fluxos. -b:a 128k

Um especificador de fluxo vazio corresponde a todos os fluxos. Por exemplo, ou copiaria todos os fluxos sem recodificar. -
codec copy-codec: copy

As formas possíveis de especificadores de fluxo são:

stream_index

Corresponde o fluxo com esse índice. Por exemplo, iria definir o contagem de threads para o segundo fluxo para 4. Se for usado
como um especificador de fluxo adicional (veja abaixo), em seguida, ele seleciona o número de fluxo dos fluxos
correspondentes. A numeração do fluxo é baseada no ordem dos fluxos conforme detectado pela libavformat, exceto quando
uma ID de programa é também especificado. Neste caso, baseia-se na ordenação dos fluxos no programa. -threads:1
4stream_indexstream_index
stream_type[:additional_stream_specifier]

stream_type é um dos seguintes: 'v' ou 'V' para vídeo, 'a' para áudio, 's' para legenda, 'd' para dados e 't' para anexos. 'v'
corresponde a todos os vídeos fluxos, 'V' só corresponde a fluxos de vídeo que não são imagens anexadas, vídeo miniaturas ou
capas. Se for usado, então ele corresponde a fluxos que têm esse tipo e correspondem ao . Caso contrário, ele corresponde a
todos os fluxos do tipo especificado. additional_stream_specifieradditional_stream_specifier
p:program_id[:additional_stream_specifier]

Corresponde fluxos que estão no programa com o id . Se for usado, então ele corresponde a fluxos que ambos fazem parte do
programa e correspondem ao . program_idadditional_stream_specifieradditional_stream_specifier
#stream_id or i:stream_id

Corresponder o fluxo por ID de fluxo (por exemplo, PID no contêiner MPEG-TS).

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 1/9
25/11/2023, 07:08 ffplay Documentação
m:key[:value]

Corresponde fluxos com a marca de metadados com o valor especificado. Se não for fornecido, corresponde fluxos que contêm
a tag fornecida com qualquer valor. keyvalue
u

Corresponde fluxos com configuração utilizável, o codec deve ser definido e o informações essenciais, como dimensão de vídeo
ou taxa de amostragem de áudio, devem estar presentes.

Observe que no , a correspondência por metadados só funcionará corretamente para arquivos de entrada. ffmpeg

3.2 Opções genéricas

Essas opções são compartilhadas entre as ferramentas ff*.

-L

Mostrar licença.
-h, -?, -help, --help [arg]

Mostrar ajuda. Um parâmetro opcional pode ser especificado para imprimir a ajuda sobre um item. Se nenhum argumento for
especificado, somente a ferramenta básica (não avançada) opções são mostradas.

Os valores possíveis de são: arg

long

Imprima opções de ferramentas avançadas, além das opções básicas de ferramentas.

full

Imprimir lista completa de opções, incluindo opções compartilhadas e privadas para codificadores, decodificadores, demuxers,
muxers, filtros, etc.
decoder=decoder_name

Imprima informações detalhadas sobre o decodificador chamado . Use a opção para obter uma lista de todos os decodificadores.
decoder_name-decoders
encoder=encoder_name

Imprima informações detalhadas sobre o codificador chamado . Use a opção para obter uma lista de todos os codificadores.
encoder_name-encoders
demuxer=demuxer_name

Imprima informações detalhadas sobre o demuxer chamado . Use a opção para obter uma lista de todos os demuxers e muxers.
demuxer_name-formats
muxer=muxer_name

Imprima informações detalhadas sobre o muxer chamado . Use a opção para obter uma lista de todos os muxers e demuxers.
muxer_name-formats
filter=filter_name

Imprima informações detalhadas sobre o filtro chamado . Use a opção para obter uma lista de todos os filtros. filter_name-
filters
bsf=bitstream_filter_name

Imprima informações detalhadas sobre o filtro de fluxo de bits chamado . Use a opção para obter uma lista de todos os filtros de
fluxo de bits. bitstream_filter_name-bsfs
protocol=protocol_name

Imprima informações detalhadas sobre o protocolo denominado . Use a opção para obter uma lista de todos os protocolos.
protocol_name-protocols
-version

Mostrar versão.
-buildconf

Mostrar a configuração de compilação, uma opção por linha.

-formats

Mostrar formatos disponíveis (incluindo dispositivos).

-demuxers

Mostrar demuxers disponíveis.

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 2/9
25/11/2023, 07:08 ffplay Documentação
-muxers

Mostrar muxers disponíveis.

-devices

Mostrar dispositivos disponíveis.

-codecs

Mostrar todos os codecs conhecidos pela libavcodec.

Observe que o termo 'codec' é usado em toda esta documentação como um atalho para o que é mais corretamente chamado de
formato de fluxo de bits de mídia.
-decoders

Mostrar decodificadores disponíveis.

-encoders

Mostrar todos os codificadores disponíveis.

-bsfs

Mostrar filtros de fluxo de bits disponíveis.

-protocols

Mostrar protocolos disponíveis.

-filters

Mostrar filtros libavfilter disponíveis.

-pix_fmts

Mostrar formatos de pixel disponíveis.

-sample_fmts

Mostrar formatos de amostra disponíveis.

-layouts

Mostrar nomes de canais e layouts de canal padrão.

-dispositions

Mostrar disposições de fluxo.

-colors

Mostrar nomes de cores reconhecidos.

-sources device[,opt1=val1[,opt2=val2]...]

Mostrar fontes detectadas automaticamente do dispositivo de entrada. Alguns dispositivos podem fornecer nomes de origem
dependentes do sistema que não podem ser detectados automaticamente. Não se pode presumir que a lista retornada esteja
sempre completa.
ffmpeg -sources pulse,server=192.168.0.4
-sinks device[,opt1=val1[,opt2=val2]...]

Mostrar coletores detectados automaticamente do dispositivo de saída. Alguns dispositivos podem fornecer nomes de coletor
dependentes do sistema que não podem ser detectados automaticamente. Não se pode presumir que a lista retornada esteja
sempre completa.
ffmpeg -sinks pulse,server=192.168.0.4
-loglevel [flags+]loglevel | -v [flags+]loglevel

Defina o nível de log e os sinalizadores usados pela biblioteca.

O prefixo opcional pode consistir nos seguintes valores: flags

''repeat

Indica que a saída de log repetida não deve ser compactada na primeira linha e a linha "Última mensagem repetida n vezes" será
omitida.
''level

Indica que a saída do log deve adicionar um prefixo a cada mensagem linha. Isso pode ser usado como uma alternativa à
coloração de toras, por exemplo, ao despejar o Registre-se no arquivo. [level]

Os sinalizadores também podem ser usados sozinhos adicionando um prefixo '+'/'-' para definir/redefinir um único sinalizar sem
afetar outros ou alterar . Quando configuração de ambos e , um separador '+' é esperado entre o último valor e antes .
flagsloglevelflagsloglevelflagsloglevel

loglevel é uma cadeia de caracteres ou um número que contém um dos seguintes valores:
read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 3/9
25/11/2023, 07:08 ffplay Documentação
''quiet, -8

Não mostrar nada; calar-se.

''panic, 0

Mostrar apenas erros fatais que podem levar o processo a falhar, como uma falha de asserção. Isso não é usado atualmente para
nada.
''fatal, 8

Mostrar apenas erros fatais. Estes são erros após os quais o processo absolutamente não pode continuar.
''error, 16

Mostrar todos os erros, incluindo aqueles que podem ser recuperados de.
''warning, 24

Mostrar todos os avisos e erros. Qualquer mensagem relacionada a possivelmente Eventos incorretos ou inesperados serão
mostrados.
''info, 32

Mostrar mensagens informativas durante o processamento. Isso é além de avisos e erros. Esse é o valor padrão.
''verbose, 40

O mesmo que , exceto mais detalhado. info

''debug, 48

Mostrar tudo, incluindo informações de depuração.

''trace, 56

Por exemplo, para habilitar a saída de log repetida, adicione o prefixo e defina como : levelloglevelverbose
ffmpeg -loglevel repeat+level+verbose -i input output

Outro exemplo que permite a saída de log repetida sem afetar a corrente estado do prefixo do sinalizador ou : levelloglevel
ffmpeg [...] -loglevel +repeat

Por padrão, o programa registra em stderr. Se a coloração for suportada pelo terminal, as cores são usadas para marcar erros e
avisos. Coloração de toras pode ser desabilitado definindo a variável de ambiente ou pode ser configuração forçada a variável de
ambiente . AV_LOG_FORCE_NOCOLORAV_LOG_FORCE_COLOR
-report

Despejar a linha de comando completa e a saída de log para um arquivo nomeado no atual diretório. Este arquivo pode ser útil
para relatórios de bugs. Também implica . program-YYYYMMDD-HHMMSS.log-loglevel debug

Definir a variável de ambiente para qualquer valor tem o mesmo efeito. Se o valor for uma sequência ':'-separated key=value,
estes opções afetarão o relatório; Os valores de opção devem ser escapados se contêm caracteres especiais ou o delimitador de
opções ':' (consulte o Seção "Cotação e fuga" no manual ffmpeg-utils). FFREPORT

As seguintes opções são reconhecidas:

file

definir o nome do arquivo a ser usado para o relatório; é expandido para o nome do programa, é expandido para um carimbo de
data/hora, é expandido para uma planície %p%t%%%
level

Defina o nível de detalhamento do log usando um valor numérico (consulte ). -loglevel

Por exemplo, para gerar uma saída de um relatório para um arquivo nomeado usando um nível de log de (alias para nível de
log): ffreport.log32info
FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

Erros na análise da variável de ambiente não são fatais e não serão aparecem no relatório.
-hide_banner

Suprima o banner de impressão.

Todas as ferramentas FFmpeg normalmente mostrarão um aviso de direitos autorais, opções de compilação e versões de
biblioteca. Essa opção pode ser usada para suprimir a impressão essas informações.
-cpuflags flags (global)

Permite configurar e limpar sinalizadores de cpu. Esta opção destina-se para testes. Não o use a menos que você saiba o que está
fazendo.
ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 4/9
25/11/2023, 07:08 ffplay Documentação
Os sinalizadores possíveis para essa opção são:

''x86

''mmx
''mmxext
''sse
''sse2
''sse2slow
''sse3
''sse3slow
''ssse3
''atom
''sse4.1
''sse4.2
''avx
''avx2
''xop
''fma3
''fma4
''3dnow
''3dnowext
''bmi1
''bmi2
''cmov
''ARM

''armv5te
''armv6
''armv6t2
''vfp
''vfpv3
''neon
''setend
''AArch64

''armv8
''vfp
''neon
''PowerPC

''altivec
''Specific Processors

''pentium2
''pentium3
''pentium4
''k6
''k62
''athlon
''athlonxp
''k8
-cpucount count (global)

Substituir a detecção da contagem de CPU. Esta opção destina-se para testes. Não o use a menos que você saiba o que está
fazendo.
ffmpeg -cpucount 2
-max_alloc bytes

Definir o limite de tamanho máximo para alocar um bloco no heap por ffmpeg's família de funções malloc. Tenha extrema
cautela ao usar esta opção. Não use se você não entender toda a consequência de fazê-lo. O padrão é INT_MAX.

3.3 AVOpções
Essas opções são fornecidas diretamente pela libavformat, libavdevice e bibliotecas libavcodec. Para ver a lista de AVOptions
disponíveis, use a opção. Eles são separados em duas categorias: -help

generic

Essas opções podem ser definidas para qualquer contêiner, codec ou dispositivo. Opções genéricas estão listados em opções
AVFormatContext para contêineres/dispositivos e em Opções AVCodecContext para codecs.
private

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 5/9
25/11/2023, 07:08 ffplay Documentação
Essas opções são específicas para o contêiner, dispositivo ou codec fornecido. Privado opções são listadas em seus
contêineres/dispositivos/codecs correspondentes.

Por exemplo, para gravar um cabeçalho ID3v2.3 em vez de um ID3v2.4 padrão em: um arquivo MP3, use a opção privada do
MP3 Muxer: id3v2_version
ffmpeg -i input.flac -id3v2_version 3 out.mp3

Todos os AVOptions de codec são por fluxo e, portanto, um especificador de fluxo devem ser anexados a eles:
ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

No exemplo acima, um fluxo de áudio multicanal é mapeado duas vezes para saída. A primeira instância é codificada com codec
ac3 e bitrate 640k. A segunda instância é reduzida para 2 canais e codificada com codec aac. Uma taxa de bits de 128k é
especificada para ele usando índice absoluto do fluxo de saída.

Nota: a sintaxe não pode ser usada para booleano AVOptions, use /. -nooption-option 0-option 1

Nota: a antiga maneira não documentada de especificar AVOptions por fluxo por v/a/s pendente para o nome das opções agora
está obsoleto e será removido em breve.

3.4 Principais opções

-x width

Forçar a largura exibida.

-y height

Forçar a altura exibida.

-fs

Inicie no modo de tela cheia.

-an

Desative o áudio.
-vn

Desative o vídeo.
-sn

Desative as legendas.
-ss pos

Busque . Note que na maioria dos formatos não é possível buscar Exatamente, assim buscará o ponto de busca mais próximo de
. posffplaypos

pos deve ser uma especificação de duração de tempo, veja (ffmpeg-utils)a seção Duração do tempo no manual ffmpeg-utils(1).
-t duration

Reproduza segundos de áudio/vídeo. duration

duration deve ser uma especificação de duração de tempo, veja (ffmpeg-utils)a seção Duração do tempo no manual ffmpeg-
utils(1).
-bytes

Buscar por bytes.

-seek_interval

Defina o intervalo personalizado, em segundos, para a busca usando as teclas esquerda/direita. O padrão é 10 segundos.
-nodisp

Desative a exibição gráfica.

-noborder

Janela sem bordas.

-alwaysontop

Janela sempre em cima. Disponível em: X11 com SDL >= 2.0.5, Windows SDL >= 2.0.6.
-volume

Defina o volume de inicialização. 0 significa silêncio, 100 significa nenhuma redução de volume ou amplificação. Valores
negativos são tratados como 0, valores acima de 100 são tratados como 100.
-f fmt

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 6/9
25/11/2023, 07:08 ffplay Documentação
Formato de força.
-window_title title

Definir título da janela (o padrão é o nome do arquivo de entrada).

-left title

Defina a posição x para a esquerda da janela (o padrão é uma janela centralizada).

-top title

Defina a posição y para a parte superior da janela (o padrão é uma janela centralizada).
-loop number

Loops de reprodução de filmes <número> vezes. 0 significa para sempre.

-showmode mode

Defina o modo de exibição a ser usado. Os valores disponíveis para são: mode

''0, video

mostrar vídeo
''1, waves

mostrar ondas de áudio

''2, rdft

mostrar banda de frequência de áudio usando RDFT ((Inverso) Real Discrete Fourier Transform)

O valor padrão é "vídeo", se o vídeo não estiver presente ou não puder ser reproduzido "rdft" é selecionado automaticamente.

Você pode percorrer interativamente os modos de exibição disponíveis por pressionando a tecla w.
-vf filtergraph

Crie o filtergraph especificado por e use-o para Filtre o fluxo de vídeo. filtergraph

filtergraph é uma descrição do gráfico de filtro a ser aplicado a o fluxo, e deve ter uma única entrada de vídeo e um único vídeo
saída. No gráfico de filtro, a entrada é associada ao rótulo e a saída ao rótulo. Veja o FFMPEG-Filters Manual para obter mais
informações sobre o FilterGraph sintaxe. inout

Você pode especificar esse parâmetro várias vezes e percorrer o especificado filtergraphs junto com os modos show
pressionando a tecla w.
-af filtergraph

filtergraph é uma descrição do gráfico de filtro a ser aplicado a o áudio de entrada. Use a opção "-filters" para mostrar todos os
filtros disponíveis (incluindo fontes e pias).
-i input_url

Ler. input_url

3.5 Opções avançadas

-stats

Imprima várias estatísticas de reprodução, em particular mostrar o fluxo duração, os parâmetros do codec, a posição atual no
fluxo e o desvio de sincronização de áudio/vídeo. Ele é mostrado por padrão, a menos que o o nível de log é menor que . Sua
exibição pode ser forçada manualmente especificando esta opção. Para desativá-lo, você precisa especificar . info-nostats
-fast

Otimizações não compatíveis com especificações.

-genpts

Gerar pts.
-sync type

Definir o relógio mestre para áudio (), vídeo ( ) ou externo (). O padrão é áudio. O O relógio mestre é usado para controlar a
sincronização de áudio e vídeo. A maioria dos meios de comunicação os jogadores usam o áudio como relógio mestre, mas em
alguns casos (streaming ou alto transmissão de qualidade) é preciso mudar isso. Esta opção é principalmente usado para fins de
depuração. type=audiotype=videotype=ext
-ast audio_stream_specifier

Selecione o fluxo de áudio desejado usando o especificador de fluxo fornecido. O fluxo os especificadores são descritos no
capítulo Especificadores de fluxo. Se esta opção não é especificado, o "melhor" fluxo de áudio é selecionado no programa do
fluxo de vídeo já selecionado.

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 7/9
25/11/2023, 07:08 ffplay Documentação
-vst video_stream_specifier

Selecione o fluxo de vídeo desejado usando o especificador de fluxo fornecido. O fluxo os especificadores são descritos no
capítulo Especificadores de fluxo. Se esta opção não é especificado, o fluxo de vídeo "melhor" é selecionado.
-sst subtitle_stream_specifier

Selecione o fluxo de legendas desejado usando o especificador de fluxo fornecido. O fluxo os especificadores são descritos no
capítulo Especificadores de fluxo. Se esta opção não é especificado, o "melhor" fluxo de legendas é selecionado no programa do
Fluxo de vídeo ou áudio já selecionado.
-autoexit

Saia quando o vídeo terminar de ser reproduzido.

-exitonkeydown

Saia se alguma tecla for pressionada.

-exitonmousedown

Saia se algum botão do mouse for pressionado.

-codec:media_specifier codec_name

Força uma implementação de decodificador específica para o fluxo identificado por , que pode assumir os valores (áudio),
(vídeo) e legenda. media_specifieravs
-acodec codec_name

Forçar um decodificador de áudio específico.

-vcodec codec_name

Forçar um decodificador de vídeo específico.

-scodec codec_name

Forçar um decodificador de legendas específico.

-autorotate

Gire automaticamente o vídeo de acordo com os metadados do arquivo. Habilitado por padrão, use para desabilitá-lo. -
noautorotate
-framedrop

Solte quadros de vídeo se o vídeo estiver fora de sincronia. Habilitado por padrão se o mestre relógio não está definido para
vídeo. Use esta opção para habilitar a queda de quadros para todos fontes de relógio mestre, use para desativá-lo. -noframedrop
-infbuf

Não limite o tamanho do buffer de entrada, leia o máximo de dados possível do entrada o mais rápido possível. Habilitado por
padrão para fluxos em tempo real, onde os dados pode ser descartado se não for lido a tempo. Use essa opção para habilitar
buffers infinitos para todas as entradas, use para desativá-lo. -noinfbuf
-filter_threads nb_threads

Define quantos threads são usados para processar um pipeline de filtro. Cada gasoduto produzirá um pool de threads com esses
muitos threads disponíveis para paralelo processamento. O padrão é 0, o que significa que a contagem de threads será
determinado pelo número de CPUs disponíveis.
-enable_vulkan

Use o renderizador vulkan em vez do renderizador interno SDL. Depende de libplacebo.

-vulkan_params

Configuração vulkan usando uma lista de = pares separados por ":". keyvalue
-hwaccel

Use a decodificação acelerada HW. Habilitar essa opção habilitará o renderizador vulkan automaticamente.

3.6 Durante o jogo

q, ESC

Renunciar.
f

Alterne tela cheia.

p, CEP

Pausa.
m

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 8/9
25/11/2023, 07:08 ffplay Documentação
Alternar mudo.
9, 0
/, *

Diminuir e aumentar o volume, respectivamente.

um

Ciclo de canal de áudio no programa atual.

em

Canal de vídeo do ciclo.

t

Canal de legendas do ciclo no programa atual.

c

Programa de ciclos.
em

Filtros de vídeo de ciclo ou modos de exibição.

s

Passo para o próximo quadro.

Pausar se o fluxo ainda não estiver pausado, passo para o próximo vídeo enquadrar e pausar.
esquerda/direita

Buscar para trás/para frente 10 segundos.

para baixo/para cima

Buscar para trás/para frente 1 minuto.

página para baixo/página para cima

Procure o capítulo anterior/próximo. ou se não houver capítulos Buscar para trás/para frente 10 minutos.
clique com o botão direito do mouse

Procure a porcentagem no arquivo correspondente à fração de largura.

Clique duas vezes com o botão esquerdo do mouse

Alterne tela cheia.

4 Ver também
ffmpeg-all, ffmpeg, ffprobe, ffmpeg-utils, ffmpeg-scaler, ffmpeg-resampler, ffmpeg-codecs, ffmpeg-bitstream-filters, ffmpeg-
formats, ffmpeg-devices, ffmpeg-protocols, ffmpeg-filters

5 Autores
Os desenvolvedores do FFmpeg.

Para obter detalhes sobre a autoria, consulte o histórico do projeto no Git (https://git.ffmpeg.org/ffmpeg), por exemplo,
digitando o comando no diretório fonte do FFmpeg ou navegando no repositório online em https://git.ffmpeg.org/ffmpeg. git
log

Os mantenedores dos componentes específicos são listados no arquivo na árvore do código-fonte. MAINTAINERS

Este documento foi gerado em 24 de novembro de 2023 usando makeinfo.

Hospedagem fornecida pela telepoint.bg

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffplay.html 9/9