Normalize Volume

Normalize audio using NodeJs and FFmpeg

API

await NormalizeVolume(input_file, output_file[, options])

input_file

Type: String
Full path to source video file

output_file

Type: String
Full path to future normalized video file

options

Type: Object

options.normalize

Type: Boolean
Default: true
Base on Loudness Normalization

options.volume

Type: Number
Default: 0.5
Number starts with 0. Volume 0 = muted, 2 = 200%. Ignored if normalize = true

options.ffmpeg_bin

Type: String
Default: ffmpeg
Path to FFmpeg binary file

options.convert_bin

Type: String
Default: convert
Path to ImageMagick Convert binary file

options.waveform

Type: Object
Default: null
Optional visualization of the normalization result. In short, it is a waveforms before and after normalization, merged together.

To customize waveform, use this options:

Option	Type	Default	What for?
image_before	String	output_file + '_before.png'
image_after	String	output_file + '_after.png'
image_comparison	String	output_file + '_comparison.png'
width	Number	400
height	Number	225
before_color	String	white	'before' waveform color
after_color	String	#ff00b3	'after' waveform color

options.silent

Type: Boolean
Default: true
Enables logging stdout / stderr data

@output

Type: Object

{
   "file": "z:\test_normalized.mp4",
   "waveform": "z:\test.mp4_comparison.png"
}

Usage

const NormalizeVolume = require('normalize-volume');

let options = {
   normalize: true, 
   waveform: { width: 1400, height: 225 },
   ffmpeg_bin: 'ffmpeg.exe', 
   convert_bin: 'convert.exe'
}

NormalizeVolume('z:\test.mp4', 'z:\test_normalized.mp4', options)
.then(result => {
   console.log(result);
})
.catch(err => {
   console.log(err);
})

Changelog

1.0.8:

• Now the Promise returns an error object { code, []errors } (in case an error occurred).