Showfreqs

Audio Video Single output Transform

Convert input audio to a frequencies video output.

FFmpeg filter: showfreqs — 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 Showfreqs(…));
$result = $node->outputs()[0];

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

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

When to use it

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.

How to use it

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

Examples

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

Gotchas

TODO

See also

TODO

Parameters

Parameter	Type	Default	Range / values	Description
size	string	1024x512	—	set video size
rate	string	25	—	set video rate
mode	ShowfreqsMode	bar	line, bar, dot	set display mode
ascale	ShowfreqsAscale	log	lin, sqrt, cbrt, log	set amplitude scale
fscale	ShowfreqsFscale	lin	lin, log, rlog	set frequency scale
win_size	int	2048	16–65536	set window size
win_func	ShowfreqsWinFunc	hanning	rect, bartlett, hanning, hamming, blackman, welch, flattop, bharris, …	set window function
overlap	float	1	0–1	set window overlap
averaging	int	1	≥ 0	set time averaging
colors	string	red|green|blue|yellow|orange|lime|pink|magenta|brown	—	set channels colors
cmode	ShowfreqsCmode	combined	combined, separate	set channel mode
minamp	float	1.0E-6	1.1754943508223E-38–1.0E-6	set minimum amplitude
data	ShowfreqsData	magnitude	magnitude, phase, delay	set data mode
channels	string	all	—	set channels to draw

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

---

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