coreav ffmpeg ARGS takes an ffmpeg command line in ffmpeg’s own syntax and runs it with CoreAV’s own writers, when it is a stream copy (-c copy) that CoreAV implements. It selects streams as ffmpeg does, with or without -map.
In a build with a decoder backend, it also runs a command line that encodes the video with
libx264, through coreav transcode. The build’s backends decode the video, and an x264 program encodes it, or an ffmpeg program built with libx264 when no x264 program is found. Strict-safe mode changes neither (what strict-safe mode covers).
Any other command line is refused in strict-safe mode, and goes to the real ffmpeg otherwise (strict-safe mode and the fallback). The outputs pass the job oracles on the fixtures in CI. The 0.1.0 bars on held-out files are not measured yet (the 0.1.0 release issue).
Examples
coreav ffmpeg prints nothing on success. It writes the output to a temporary file and moves it into place only when the whole job succeeded.
Use it in place of ffmpeg
A link namedffmpeg that points to coreav behaves as coreav ffmpeg with the whole argument list. Under that name, only COREAV_STRICT_SAFE=1 turns on strict-safe mode.
Options
coreav ffmpeg has no help text of its own. coreav ffmpeg --help is an informational query, which CoreAV does not implement: strict-safe mode refuses it, and otherwise it prints the real ffmpeg’s help through the fallback. The compatibility command’s design note lists the options it implements.