EBU R128 scanner filter. This filter takes an audio stream as input and outputs
it unchanged. By default, it logs a message at a frequency of 10Hz with the
Momentary loudness (identified by M
), Short-term loudness (S
),
Integrated loudness (I
) and Loudness Range (LRA
).
The filter also has a video output (see the video option) with a real time graph to observe the loudness evolution. The graphic contains the logged message mentioned above, so it is not printed anymore when this option is set, unless the verbose logging is set. The main graphing area contains the short-term loudness (3 seconds of analysis), and the gauge on the right is for the momentary loudness (400 milliseconds).
More information about the Loudness Recommendation EBU R128 on http://tech.ebu.ch/loudness.
The filter accepts the following options:
- video
-
Activate the video output. The audio stream is passed unchanged whether this option is set or no. The video stream will be the first output stream if activated. Default is
0
. - size
-
Set the video size. This option is for video only. For the syntax of this option, check the "Video size" section in the ffmpeg-utils manual. Default and minimum resolution is
640x480
. - meter
-
Set the EBU scale meter. Default is
9
. Common values are9
and18
, respectively for EBU scale meter +9 and EBU scale meter +18. Any other integer value between this range is allowed. - metadata
-
Set metadata injection. If set to
1
, the audio input will be segmented into 100ms output frames, each of them containing various loudness information in metadata. All the metadata keys are prefixed withlavfi.r128.
.Default is
0
. - framelog
-
Force the frame logging level.
Available values are:
- info
-
information logging level
- verbose
-
verbose logging level
By default, the logging level is set to info. If the video or the metadata options are set, it switches to verbose.
Examples
-
Real-time graph using ffplay, with a EBU scale meter +18:
ffplay -f lavfi -i "amovie=input.mp3,ebur128=video=1:meter=18 [out0][out1]"
-
Run an analysis with ffmpeg:
ffmpeg -nostats -i input.mp3 -filter_complex ebur128 -f null -