You will learn#
- what
E_FFMPEG_MISSINGcovers; - the order in which the product looks for FFmpeg and ffprobe;
- how to fix it on a binary install, with your own build and in the container.
The idea#
Import and export need FFmpeg and ffprobe, run as separate processes. The product reports E_FFMPEG_MISSING when it finds none that works, when the one you named in VUKEM_VIDEO_FFMPEG is unusable, or when the build lacks a required encoder, filter or muxer (details.missing lists them). Editing, the timeline and the text views work without it.
The search order is fixed: VUKEM_VIDEO_FFMPEG and VUKEM_VIDEO_FFPROBE first, then the FFmpeg next to the program, then the PATH. When you set VUKEM_VIDEO_FFMPEG and it fails, the product does not fall back to another one, because you asked for that binary. ffprobe is taken from the same directory as ffmpeg.
Quick start#
- Run
vukem-video doctor --full. Theffmpeg.binarycheck shows the path and version it found, or the error. - If none is found, install FFmpeg 9 and make sure
ffmpegandffprobeare on thePATH, or set both variables to absolute paths of files. - Run
vukem-video doctor --fullagain: the version, the licence class and the H.264 encoder should show.
export VUKEM_VIDEO_FFMPEG=/opt/ffmpeg/bin/ffmpeg
export VUKEM_VIDEO_FFPROBE=/opt/ffmpeg/bin/ffprobe
vukem-video doctor --fullThe container image carries a pinned LGPL FFmpeg and needs nothing; see FFmpeg, codecs and licences for its source and how to verify it.
Common mistakes#
- A relative path or a directory in
VUKEM_VIDEO_FFMPEG: it is refused at start-up as an invalid path. - Setting the variable in a shell and starting the server from a service manager or a desktop shortcut, which do not see it. Set it where the server starts.
- An FFmpeg that is much older than 9: a version below 7 is reported as old, and an encoder or filter may be missing. Another version is otherwise accepted with a warning.
- Using a GPL or non-free build in something you distribute. The check classifies the licence from the configure line; see the licence page.
- Expecting the error to name the encoder. A missing H.264 encoder is a different code: No H.264 encoder works.