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.
- peak
-
Set peak mode(s).
Available modes can be cumulated (the option is a
flag
type). Possible values are:- none
-
Disable any peak mode (default).
- sample
-
Enable sample-peak mode.
Simple peak mode looking for the higher sample value. It logs a message for sample-peak (identified by
SPK
). - true
-
Enable true-peak mode.
If enabled, the peak lookup is done on an over-sampled version of the input stream for better peak accuracy. It logs a message for true-peak. (identified by
TPK
) and true-peak per frame (identified byFTPK
). This mode requires a build withlibswresample
.
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 -