# O FFmpeg não é encontrado

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

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/troubleshooting/ffmpeg-missing/

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

```bash
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](/docs/self-hosting/ffmpeg-and-licences) 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](/docs/troubleshooting/no-encoder).

## Próximos passos

- [FFmpeg, codecs e licenças](/docs/self-hosting/ffmpeg-and-licences)
- [Uma importação falha](/docs/troubleshooting/import-fails)
