Skip to content

Showvolume

Audio Video Single output Transform

Convert input audio volume to video output.

FFmpeg filter: showvolume — the official reference.

Add it to a graph. The explicit form works for every filter — bind it to its input and read the result from outputs():

$node = $video->addFilter(new Showvolume(…));
$result = $node->outputs()[0];

Shorthand. Single-output filters can skip the node — apply() returns the result stream directly:

$result = $video->apply(new Showvolume(…));

TODO — when this filter shines: what it’s the right tool for, what to reach for instead when it isn’t, and how it composes with neighbouring filters.

TODO — prose: how the filter actually works and what its key parameters mean (the explanation FFmpeg’s terse option help omits).

TODO — runnable PHP, with the equivalent ffmpeg CLI alongside.

TODO

TODO

ParameterTypeDefaultRange / valuesDescription
ratestring25—set video rate
bint10–5set border width
wint40080–8192set channel width
hint201–900set channel height
ffloat0.950–1set fade
cstringPEAK*255+floor((1-PEAK)*255)*256+0xff000000—set volume color expression
tbooltrue—display channel names
vbooltrue—display volume value
dmfloat00–9000duration for max value display
dmcstringorange—set color of the max value line
oShowvolumeOrientationhh, vset orientation
sint00–5set step size
pfloat00–1set background opacity
mShowvolumeModepp, rset mode
dsShowvolumeDisplayScalelinlin, logset display scale

FFmpeg also names these options (use the parameter shown above): r → rate.


Maps to FFmpeg’s showvolume filter. Verified against ffmpeg n7.1.1.

An Artisan Build project.

Built on FFmpeg — an independent binding, not affiliated with or endorsed by the FFmpeg project. Support FFmpeg.