Ir para o conteúdo

Solução de problemas

O FFmpeg não é encontrado

O que o E_FFMPEG_MISSING significa, como o produto procura o FFmpeg e como apontá-lo para um.

Última atualização:

O que você vai aprender#

  • o que o E_FFMPEG_MISSING cobre;
  • a ordem em que o produto procura o FFmpeg e o ffprobe;
  • como corrigir em uma instalação do binário, com a sua própria compilação e no contêiner.

A ideia#

A importação e a exportação precisam do FFmpeg e do ffprobe, executados como processos separados. O produto informa E_FFMPEG_MISSING quando não encontra nenhum que funcione, quando o que você indicou em VUKEM_VIDEO_FFMPEG é inutilizável, ou quando a compilação não tem um codificador, filtro ou muxer necessário (details.missing os lista). A edição, a linha do tempo e as visões de texto funcionam sem ele.

A ordem de busca é fixa: VUKEM_VIDEO_FFMPEG e VUKEM_VIDEO_FFPROBE primeiro, depois o FFmpeg ao lado do programa, depois o PATH. Quando você define VUKEM_VIDEO_FFMPEG e ele falha, o produto não recorre a outro, porque você pediu aquele binário. O ffprobe é tomado do mesmo diretório do ffmpeg.

Início rápido#

  1. Execute vukem-video doctor --full. A verificação ffmpeg.binary mostra o caminho e a versão que encontrou, ou o erro.
  2. Se nenhum for encontrado, instale o FFmpeg 9 e garanta que ffmpeg e ffprobe estejam no PATH, ou defina as duas variáveis com caminhos absolutos de arquivos.
  3. Execute vukem-video doctor --full de novo: a versão, a classe de licença e o codificador H.264 devem aparecer.
Terminal
export VUKEM_VIDEO_FFMPEG=/opt/ffmpeg/bin/ffmpeg
export VUKEM_VIDEO_FFPROBE=/opt/ffmpeg/bin/ffprobe
vukem-video doctor --full

A imagem de contêiner traz um FFmpeg LGPL fixado e não precisa de nada; veja FFmpeg, codecs e licenças para a sua origem e como verificá-lo.

Erros comuns#

  • Um caminho relativo ou um diretório em VUKEM_VIDEO_FFMPEG: é recusado na inicialização como um caminho inválido.
  • Definir a variável em um shell e iniciar o servidor por um gerenciador de serviços ou um atalho da área de trabalho, que não a enxergam. Defina-a onde o servidor inicia.
  • Um FFmpeg muito mais antigo que o 9: uma versão abaixo de 7 é informada como antiga, e um codificador ou filtro pode estar ausente. Outra versão é aceita com um aviso.
  • Usar uma compilação GPL ou não livre em algo que você distribui. A verificação classifica a licença pela linha de configuração; veja a página de licenças.
  • Esperar que o erro nomeie o codificador. A falta de um codificador H.264 é outro código: Nenhum codificador H.264 funciona.

Próximos passos#