25/11/2023, 07:10 ffprobe Documentação

ffprobe Documentação Foco de linh

Ajuda a mante
leitura realçand
Índice linhas

1 Sinopse
Foco em uma l
ffprobe [options] input_url
Traduzir

2 Descrição português

ffprobe coleta informações de fluxos multimídia e as imprime em moda legível por humanos e máquinas. Traduzir a pági

Por exemplo, ele pode ser usado para verificar o formato do contêiner usado por um fluxo multimídia e o formato e o tipo de cada fluxo de mídia contido
nele.

Se uma url for especificada na entrada, o ffprobe tentará abrir e Examine o conteúdo da URL. Se a URL não puder ser aberta ou reconhecida como um
arquivo multimídia, um código de saída positivo é retornado.

Se nenhuma saída for especificada como saída com ffprobe irá gravar para stdout. o

ffprobe pode ser empregado tanto como um aplicativo autônomo ou em combinação com um filtro textual, que pode ter mais desempenho processamento
sofisticado, por exemplo, processamento estatístico ou plotagem.

As opções são usadas para listar alguns dos formatos suportados pelo ffprobe ou para especificar quais informações exibir e para definir como ffprobe vai
mostrar isso.

A saída ffprobe foi projetada para ser facilmente analisável por um filtro textual, e consiste em uma ou mais seções de um formulário definido pelo
selecionado writer, que é especificado pela opção. output_format

As seções podem conter outras seções aninhadas e são identificadas por um nome (que pode ser compartilhado por outras seções) e um exclusivo nome.
Veja a saída do . sections

As tags de metadados armazenadas no contêiner ou nos fluxos são reconhecidas e impresso no correspondente "FORMATO", "STREAM" ou
"PROGRAM_STREAM" secção.

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
read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 1/10
25/11/2023, 07:10 ffprobe Documentação
#stream_id or i:stream_id

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

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.

-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.

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 2/10
25/11/2023, 07:10 ffprobe Documentação
-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:

''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

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 3/10
25/11/2023, 07:10 ffprobe Documentação
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 ...

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)

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 4/10
25/11/2023, 07:10 ffprobe Documentação
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

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

-f format

Forçar o formato a ser usado.

-unit

Mostrar a unidade dos valores exibidos.

-prefix

Use prefixos SI para os valores exibidos. A menos que a opção "-byte_binary_prefix" seja usada, todos os prefixos são decimais.
-byte_binary_prefix

Forçar o uso de prefixos binários para valores de byte.

-sexagesimal

Use o formato sexagesimal HH:MM:SS. MICROSSEGUNDOS para valores de tempo.

-pretty

Prettify o formato dos valores exibidos, ele corresponde ao opções "-unit -prefix -byte_binary_prefix -sexagesimal".
-output_format, -of, -print_format writer_name[=writer_options]

Defina o formato de impressão de saída.

writer_name Especifica o nome do gravador e especifica as opções a serem passadas para o gravador. writer_options

Por exemplo, para imprimir a saída no formato JSON, especifique:

-output_format json

Para obter mais detalhes sobre os formatos de impressão de saída disponíveis, consulte o Seção de escritores abaixo.
-sections

Imprima a estrutura das seções e as informações da seção e saia. A saída não deve ser analisado por uma máquina.
-select_streams stream_specifier

Selecione apenas os fluxos especificados pelo . Este afeta apenas as opções relacionadas a fluxos (por exemplo, , , etc.).
stream_specifiershow_streamsshow_packets

Por exemplo, para mostrar apenas fluxos de áudio, você pode usar o comando:
ffprobe -show_streams -select_streams a INPUT

Para mostrar apenas pacotes de vídeo pertencentes ao fluxo de vídeo com índice 1:
ffprobe -show_packets -select_streams v:1 INPUT
-show_data

Mostrar dados de carga útil, como um despejo hexadecimal e ASCII. Juntamente com o , ele irá despejar os dados dos pacotes. Juntamente com o , ele
despejará os extradados do codec. -show_packets-show_streams

O dump é impresso como o campo "dados". Pode conter novas linhas.

-show_data_hash algorithm

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 5/10
25/11/2023, 07:10 ffprobe Documentação
Mostrar um hash de dados de carga útil, para pacotes com e para codec extradata com . -show_packets-show_streams
-show_error

Mostrar informações sobre o erro encontrado ao tentar sondar a entrada.

As informações de erro são impressas dentro de uma seção com o nome "ERROR".
-show_format

Mostrar informações sobre o formato de contêiner da multimídia de entrada riacho.

Todas as informações de formato de contêiner são impressas em uma seção com nome "FORMAT".
-show_format_entry name

Como , mas só imprime a entrada especificada do informações de formato de contêiner, em vez de todas. Esta opção pode ser dada mais do que uma vez,
então todas as entradas especificadas serão mostradas. -show_format

Essa opção foi preterida, use em vez disso. show_entries

-show_entries section_entries

Defina a lista de entradas a serem exibidas.

As inscrições são especificadas de acordo com o seguinte sintaxe. contém uma lista de entradas de seção separados por . Cada entrada de seção é composta
por uma seção nome (ou nome exclusivo), opcionalmente seguido por uma lista de entradas locais a essa seção, separada por . section_entries:,

Se o nome da seção for especificado, mas for seguido por nenhum , todos as entradas são impressas na saída, juntamente com todas as entradas Seções.
Caso contrário, apenas as entradas especificadas na seção local A lista de entradas é impressa. Em particular, se for especificado, mas A lista de entradas
locais está vazia, então nenhuma entrada será mostrada para essa seção. ==

Observe que a ordem de especificação das entradas de seção local é não honrado na saída, e a ordem de exibição usual será Retidos.

A sintaxe formal é dada por:

LOCAL_SECTION_ENTRIES ::= SECTION_ENTRY_NAME[,LOCAL_SECTION_ENTRIES]
SECTION_ENTRY ::= SECTION_NAME[=[LOCAL_SECTION_ENTRIES]]
SECTION_ENTRIES ::= SECTION_ENTRY[:SECTION_ENTRIES]

Por exemplo, para mostrar apenas o índice e o tipo de cada fluxo e o PTS tempo, tempo de duração e índice de fluxo dos pacotes, você pode especificar O
argumento:
packet=pts_time,duration_time,stream_index : stream=index,codec_type

Para mostrar todas as entradas na seção "format", mas apenas o codec digite na seção "fluxo", especifique o argumento:
format : stream=codec_type

Para mostrar todas as tags nas seções de fluxo e formato:

stream_tags : format_tags

Para mostrar apenas a tag (se disponível) no fluxo Seções: title

stream_tags=title
-show_packets

Mostrar informações sobre cada pacote contido na multimídia de entrada riacho.

As informações de cada pacote individual são impressas dentro de um seção com o nome "PACKET".
-show_frames

Mostrar informações sobre cada quadro e legenda contidos na entrada fluxo multimídia.

As informações de cada quadro único são impressas dentro de um seção com nome "FRAME" ou "SUBTITLE".
-show_log loglevel

Mostrar informações de registro do decodificador sobre cada quadro de acordo com o valor definido em , (consulte ). Esta opção requer . loglevel-
loglevel-show_frames

As informações de cada mensagem de log são impressas em um seção com o nome "LOG".
-show_streams

Mostrar informações sobre cada fluxo de mídia contido na entrada fluxo multimídia.

Cada informação de fluxo de mídia é impressa em uma seção dedicada com o nome "STREAM".
-show_programs

Mostrar informações sobre programas e seus fluxos contidos na entrada fluxo multimídia.

Cada informação de fluxo de mídia é impressa em uma seção dedicada com o nome "PROGRAM_STREAM".
-show_chapters

Mostrar informações sobre capítulos armazenados no formato.

Cada capítulo é impresso dentro de uma seção dedicada com o nome "CAPÍTULO".
-count_frames

Conte o número de quadros por fluxo e relate-o no seção de córrego correspondente.

-count_packets

Conte o número de pacotes por fluxo e relate-o no seção de córrego correspondente.

-read_intervals read_intervals

Leia somente os intervalos especificados. deve ser um sequência de especificações de intervalo separadas por ",". buscará o ponto de partida do intervalo, e
Continue lendo a partir disso. read_intervalsffprobe

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 6/10
25/11/2023, 07:10 ffprobe Documentação
Cada intervalo é especificado por duas partes opcionais, separadas por "%".

A primeira parte especifica a posição inicial do intervalo. Pois é interpretada como uma posição absoluta, ou como um deslocamento relativo do posição
atual se for precedida pelo caractere "+". Se este primeiro parte não é especificada, nenhuma busca será realizada ao ler este intervalo.

A segunda parte especifica a posição final do intervalo. Interpreta-se como uma posição absoluta, ou como um deslocamento relativo da corrente posição se
for precedida pelo caractere "+". Se o deslocamento especificação começa com "#", é interpretado como o número de pacotes a serem lidos (não incluindo
os pacotes de liberação) do intervalo começar. Se nenhuma segunda parte for especificada, o programa será lido até que o fim da entrada.

Observe que a busca não é precisa, portanto, o intervalo real começa ponto pode ser diferente da posição especificada. Além disso, quando um a duração do
intervalo é especificada, a hora de término absoluta será computada adicionando a duração ao ponto de início do intervalo encontrado ao buscar o arquivo,
em vez do valor inicial especificado.

A sintaxe formal é dada por:

INTERVAL ::= [START|+START_OFFSET][%[END|+END_OFFSET]]
INTERVALS ::= INTERVAL[,INTERVALS]

Seguem-se alguns exemplos.

Procure o tempo 10, leia os pacotes até 20 segundos após a busca encontrada ponto, em seguida, procurar posicionar (1 minuto e trinta
segundos) e leia os pacotes até a posição . 01:3001:45
10%+20,01:30%01:45
Leia apenas 42 pacotes depois de procurar posicionar : 01:23
01:23%+#42
Leia apenas os primeiros 20 segundos desde o início:
%+20
Leia do início até a posição: 02:30
%02:30
-show_private_data, -private

Mostrar dados privados, ou seja, dados dependendo do formato do elemento mostrado particular. Essa opção está habilitada por padrão, mas talvez seja
necessário desabilitá-la para usos específicos, por exemplo, ao criar saída XML compatível com XSD.
-show_program_version

Mostrar informações relacionadas à versão do programa.

As informações de versão são impressas em uma seção com nome "PROGRAM_VERSION".

-show_library_versions

Mostrar informações relacionadas a versões de biblioteca.

As informações de versão de cada biblioteca são impressas em uma seção com nome "LIBRARY_VERSION".
-show_versions

Mostrar informações relacionadas a versões de programas e bibliotecas. Este é o equivalente a definir ambos e opções. -show_program_version-
show_library_versions
-show_pixel_formats

Mostrar informações sobre todos os formatos de pixel suportados pelo FFmpeg.

As informações de formato de pixel para cada formato são impressas em uma seção com o nome "PIXEL_FORMAT".
-show_optional_fields value

Alguns gravadores, como JSON e XML, omitem a impressão de campos com valores inválidos ou não aplicáveis, enquanto outros escritores sempre os
imprimem. Esta opção permite controlar este comportamento. Os valores válidos são /, / e /. O padrão é . always1never0auto-1auto
-bitexact

Força a saída bitexata, útil para produzir uma saída que não é dependente na compilação específica.
-i input_url

Ler. input_url
-o output_url

Gravar saída em . Se não for especificado, a saída será enviada para stdout. output_url

4 Escritores
Um gravador define o formato de saída adotado pelo , e será usado para imprimir todas as partes da saída. ffprobe

Um escritor pode aceitar um ou mais argumentos, que especificam as opções adotar. As opções são especificadas como uma lista de = pares, separados por
":". keyvalue

Todos os escritores suportam as seguintes opções:

string_validation, sv

Defina o modo de validação de cadeia de caracteres.

Os seguintes valores são aceitos.

''fail

O gravador falhará imediatamente no caso de uma cadeia de caracteres inválida (UTF-8) sequência ou ponto de código é encontrado na entrada. Isso é
especialmente Útil para validar metadados de entrada.
''ignore

Qualquer erro de validação será ignorado. Isso resultará em possivelmente Saída quebrada, especialmente com o gravador JSON ou XML.

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 7/10
25/11/2023, 07:10 ffprobe Documentação
''replace

O gravador substituirá sequências UTF-8 inválidas ou pontos de código por A cadeia de caracteres especificada com o . string_validation_replacement

O valor padrão é ''. replace

string_validation_replacement, svr

Definir sequência de substituição para usar no caso é definido como ''. string_validationreplace

Caso a opção não seja especificada, o gravador assumirá o vazio string, ou seja, removerá as sequências inválidas da entrada Strings.

Segue-se uma descrição dos escritores atualmente disponíveis.

4.1 Padrão
Formato padrão.

Imprima cada seção no formulário:

[SECTION]
key1=val1
...
keyN=valN
[/SECTION]

As tags de metadados são impressas como uma linha no FORMAT, STREAM ou PROGRAM_STREAM seção e são prefixados pela cadeia de caracteres
"TAG:".

Segue-se uma descrição das opções aceites.

nokey, nk

Se definido como 1, especifique não imprimir a chave de cada campo. Valor padrão é 0.
noprint_wrappers, nw

Se definido como 1, especifique para não imprimir o cabeçalho e o rodapé da seção. O valor padrão é 0.

4.2 Compacto, CSV

Formato compacto e CSV.

O escritor é equivalente a , mas suporta padrões diferentes. csvcompact

Cada seção é impressa em uma única linha. Se nenhuma opção for especificada, a saída terá o formato:
section|key1=val1| ... |keyN=valN

As tags de metadados são impressas no "formato" ou "fluxo" correspondente secção. Uma chave de marca de metadados, se impressa, é prefixada pela
cadeia de caracteres "tag:".

Segue-se a descrição das opções aceites.

item_sep, s

Especifique o caractere a ser usado para separar campos na linha de saída. Deve ser um único caractere imprimível, é "|" por padrão ("," for o escritor). csv
nokey, nk

Se definido como 1, especifique não imprimir a chave de cada campo. Seu padrão valor é 0 (1 para o escritor). csv
escape, e

Defina o modo de escape a ser usado, padrão como "c" ("csv" para o gravador). csv

Ele pode assumir um dos seguintes valores:

Execute a fuga do tipo C. Cordas contendo uma nova linha (''), carro return (''), uma guia (''), um feed de formulário (''), a fuga caractere ('') ou o caractere
separador de item são escapados usando a fuga modelada em C, de modo que uma nova linha é convertida para o sequência '', um retorno de carro para '', ''
para '' e o separador é convertido em ''. \n\r\t\f\SEP\n\r\\\SEP\SEP
csv

Execute a fuga semelhante ao CSV, conforme descrito em RFC4180. Strings contendo uma nova linha (''), uma ficha de transporte (''), uma aspa dupla (''),
ou estão entre aspas duplas. \n\r"SEP
none

Não dê como escapar.

print_section, p

Imprima o nome da seção no início de cada linha se o valor for , desabilite-o com o valor definido como . O valor padrão é . 101

4.3 plano
Formato plano.

Uma saída de forma livre onde cada linha contém uma chave explícita=valor, como "streams.stream.3.tags.foo=barra". A saída é shell escaped, por isso
pode ser diretamente incorporado em scripts sh, desde que o caractere separador seja um caractere alfanumérico ou um sublinhado (consulte a opção).
sep_char

read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 8/10
25/11/2023, 07:10 ffprobe Documentação
Segue-se a descrição das opções aceites.

sep_char, s

Caractere separador usado para separar o capítulo, o nome da seção, IDs e possíveis tags na chave de campo impressa.

O valor padrão é ''. .

hierarchical, h

Especifique se a especificação do nome da seção deve ser hierárquica. Se definido como 1 e se houver mais de uma seção na atual capítulo, o nome da
seção será prefixado pelo nome do capítulo. Um valor de 0 desabilitará esse comportamento.

O valor padrão é 1.

4.4 Isso
ESTE é o formato de saída.

Saída de impressão em um formato baseado em INI.

São adoptadas as seguintes convenções:

todas as chaves e valores são UTF-8

'' é o separador de subgrupo .
newline, '', '', '' e os seguintes caracteres são Escapou \t\f\b
'' é o personagem de fuga \
'' é o indicador de comentário #
'' é o separador chave/valor =
'' não é usado, mas geralmente analisado como separador de chave/valor :

Este escritor aceita opções como uma lista de = pares, separados por ''. keyvalue:

Segue-se a descrição das opções aceites.

hierarchical, h

Especifique se a especificação do nome da seção deve ser hierárquica. Se definido como 1 e se houver mais de uma seção na atual capítulo, o nome da
seção será prefixado pelo nome do capítulo. Um valor de 0 desabilitará esse comportamento.

O valor padrão é 1.

4.5 JSON
Formato baseado em JSON.

Cada seção é impressa usando notação JSON.

Segue-se a descrição das opções aceites.

compact, c

Se definido como 1 ativar saída compacta, ou seja, cada seção será impresso em uma única linha. O valor padrão é 0.

Para obter mais informações sobre JSON, consulte http://www.json.org/.

4.6 XML
Formato baseado em XML.

A saída XML é descrita no arquivo de descrição do esquema XML instalado no datadir FFmpeg. ffprobe.xsd

Uma versão atualizada do esquema pode ser recuperada no http://www.ffmpeg.org/schema/ffprobe.xsd url, que redireciona para o esquema mais recente
comprometido na árvore de código-fonte de desenvolvimento FFmpeg.

Observe que a saída emitida será compatível com o esquema somente quando não houver opções especiais de saída global (, , , etc.) são especificados.
ffprobe.xsdunitprefixbyte_binary_prefixsexagesimal

Segue-se a descrição das opções aceites.

fully_qualified, q

Se definido como 1, especifique se a saída deve ser totalmente qualificada. Inadimplência valor é 0. Isso é necessário para gerar um arquivo XML que pode
ser validado através de um arquivo XSD.
xsd_strict, x

Se definido como 1, execute mais verificações para garantir que a saída seja XSD dócil. O valor padrão é 0. Esta opção é definida automaticamente como 1.
fully_qualified

Para obter mais informações sobre o formato XML, consulte https://www.w3.org/XML/.

5 Código de tempo
ffprobe suporta extração de código de tempo:
read://https_ffmpeg.org/?url=https%3A%2F%2Fffmpeg.org%2Fffprobe.html 9/10
25/11/2023, 07:10 ffprobe Documentação
MPEG1/2 timecode é extraído do GOP, e está disponível no vídeo detalhes do fluxo (, consulte ). -show_streamstimecode
O timecode MOV é extraído da faixa tmcd, por isso está disponível no tmcd metadados de fluxo (, consulte ). -show_streamsTAG:timecode
Os timecodes DV, GXF e AVI estão disponíveis em metadados de formato (, ver ). -show_formatTAG:timecode

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

7 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%2Fffprobe.html 10/10