# FFmpeg, codecs e licenças

> Qual FFmpeg o produto inclui, como ele é encontrado e verificado, e quais são os termos de licença.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/self-hosting/ffmpeg-and-licences/

## O que você vai aprender

- qual compilação do FFmpeg a imagem traz (os arquivos de release e os instaladores não trazem nenhuma), e onde está o seu código-fonte;
- como o produto encontra um FFmpeg e recusa um arriscado;
- quais obrigações acompanham a compilação LGPL.

## A ideia

O Vukem Video executa o FFmpeg apenas como um **processo separado**. Ele nunca o vincula, e os pixels de um quadro são compostos em Go. O FFmpeg que a imagem de contêiner traz é uma compilação LGPL fixada do [BtbN FFmpeg-Builds](https://github.com/BtbN/FFmpeg-Builds), baixada pela sua URL exata e verificada por SHA-256 quando a imagem é construída. Ele é configurado sem `--enable-gpl` e sem `--enable-nonfree`, e a construção falha se qualquer um dos dois aparecer na linha de configuração. O produto não inclui nenhum componente GPL.

O fixador desta versão:

| Item | Valor |
| --- | --- |
| Versão do FFmpeg | `n9.0.2-39-g7adfbe40dc-20261031` |
| Tag da versão da compilação | [`autobuild-2026-10-31-12-59`](https://github.com/BtbN/FFmpeg-Builds/releases/tag/autobuild-2026-10-31-12-59) |
| Commit dos scripts de compilação | `5031c6f1082414e53688d39e521849905071070d` |
| Código-fonte correspondente do FFmpeg | [arquivo do código-fonte do FFmpeg](https://github.com/FFmpeg/FFmpeg/archive/7adfbe40dcde598f93a6963d2f7b22cd75202ccc.tar.gz) |

O texto da licença, a linha de configuração e esses links de código-fonte estão dentro da imagem, em `/usr/share/doc/vukem-video/ffmpeg/` (`LICENSE.txt`, `configure.txt` e `SOURCE.txt`). Os pacotes da base Debian estão listados com as suas licenças em `/usr/share/doc/vukem-video/base-image-packages.txt`.

## Como um FFmpeg é encontrado

A ordem é fixa:

1. `VUKEM_VIDEO_FFMPEG` e `VUKEM_VIDEO_FFPROBE`. Quando `VUKEM_VIDEO_FFMPEG` está definido e é inutilizável, o servidor informa `E_FFMPEG_MISSING`; ele nunca recorre a outro, porque você pediu aquele binário. Ambos precisam ser caminhos absolutos para arquivos.
2. O FFmpeg ao lado do programa (incluído).
3. O `PATH`.

O `ffprobe` vem do mesmo diretório do `ffmpeg`. O produto é testado no FFmpeg 9.0.2; outra versão é aceita com um aviso e uma versão abaixo de 7 é informada como antiga. Um codificador, filtro ou muxer necessário que esteja ausente é `E_FFMPEG_MISSING`.

A licença da compilação escolhida é classificada pela sua linha de configuração como `lgpl`, `gpl` ou `nonfree`. Uma compilação incluída precisa ser `lgpl`. A sua própria compilação pode ser GPL, o que é aceitável para o seu uso pessoal mas não para algo que você distribui, e o `libx264` só é usado se você definir `VUKEM_VIDEO_ALLOW_USER_X264=true`.

## Início rápido

```bash
vukem-video doctor --full
vukem-video doctor --verify
```

O `doctor --full` executa todas as verificações e imprime a versão do FFmpeg, a sua classe de licença e os codificadores H.264 encontrados. O `--verify` recalcula os digests do FFmpeg e dos auxiliares baixados. Ele só informa "matches the release" para o FFmpeg fixado (o da imagem, ou o par fixado que você coloca ao lado do programa); qualquer outro FFmpeg aparece como "your own build, not compared".

## Erros comuns

- Definir `VUKEM_VIDEO_FFMPEG` como um caminho relativo ou um diretório: recusado na inicialização como um caminho de FFmpeg inválido.
- Distribuir o seu próprio FFmpeg GPL dentro de uma imagem que você publica.
- Esperar que o FFmpeg consiga alcançar a rede. Ele nunca recebe um endereço de rede, e no Linux `VUKEM_VIDEO_SANDBOX=bwrap` faz o sistema operacional impor isso.

## Próximos passos

- [Codificadores e predefinições de exportação](/docs/guide/encoders-and-presets)
- [Verifique uma versão](/docs/self-hosting/verify-a-release)
