title
Products            Buy            Support Forum            Professional            About            Codec Central
 
Command Line Encoding with dBpoweramp Music Converter

Conversions can be instigated efficiently from the command-line perfect for back-end encoding controlled from other programs / web scripts.

In-house Scripting License: A dBpoweramp Reference license is required for each PC & concurrent CLI encoder. For example 1 PC handles CLI encoding, it is a dual cpu system and 2 CLI converters are used side by side, 2 Reference licenses are required.

Supplied as part of another Program:  Email your requirements

C:\>"c:\program files\illustrate\dBpoweramp\coreconverter.exe" -infile="c:\afile.wav" -outfile="c:\outfile.mp3" -convert_to="mp3 (Lame)" -V 2

dBpoweramp Music Converter (C) 2013 Illustrate Ltd

Encoding: mp3 (Lame)
Audio Source: c:\afile.wav
Audio Destination: c:\outfile.mp3

0%-----------25%-----------50%-----------75%-----------100%
***********************************************************

Writing ID Tags: Done
Conversion completed in 13.6 seconds x20 realtime encoding

C:\>

CLI Music Converter

All conversions are handled by CoreConverter.exe, this program can be found in C:\Program Files\Illustrate\dBpoweramp\ or C:\Program Files\dBpoweramp\

Required:

-infile="filename"       // specifies input file to convert from, can be '-' for standard input
-outfile="filename"     // specifies output file
-convert_to="Wave"    // Codec converting to

Optional:

-priority="low" "high" "idle"   // sets converter priority, default is normal
-silent                                // only outputs errors only to StdErr
-errorfile="filename"             // errors written to filename (otherwise StdErr), note this file will be zero bytes if no errors

-noidtag                             // do not try to write any id tags
-tag="element=value"          // specify an ID tag, example -tag="artist=Madonna" use {qt} to put a quote " in the final string
-tag="element1=value1"
-processor="n"                   // allies to a processor (on multi-cpu system), where n is 1=CPU1 2=CPU2, etc
-dspeffect1="name=cmdline"  // a DSP effect (see example below, important as " in the DSP effect command line are replaced with {qt} )

std input:

When using '-' for input filename the audio must be supplied 'raw' (no headers) to the stdin pipe, specify the parameters as follows:

-sourcefreq="44100"           // stdin frequency
-sourcechannels="2"           // stdin channels
-sourcebits="16"                // stdin bit depth
-sourcelength="1000"        // stdin source file length in mili-seconds
-sourceisfloat                    // stdin source is IEEE floating point (requires R14.4 or newer)

Pipes used when CLI encoding:

[StdIn] used only when input filename is "-"
[StdOut] shows info to the user (also info from codecs), output is ANSI
[StdError] all error messages, output is ANSI

...followed by Codec Compression CLI, this is specific to each encoder, see the help file for the encoder for CLI details (Start >> Programs >> dBpoweramp Music Converter >> Help >> Codecs)

Example encoding:

CoreConverter.exe -infile="z:\AFile.wav" -outfile="z:\Outfile.mp3" -dspeffect1="Bit Depth=-depth={qt}32 float{qt}" -dspeffect2="Graphic Equalizer= -EQ={qt}50, 50, 45, 45, 40, 40, 35, 35, 30, 30, 25, 25, 20, 20, 80, 80, 120, 120{qt}" -dspeffect3="Volume Normalize="-mode={qt}peak{qt} -maxamp={qt}100{qt} -desiredb={qt}-.1{qt}" -convert_to="mp3 (Lame)" -V 6

To obtain the correct DSP effect command line, open CD Ripper, create a new profile. Add the desired DSP effects and close CD Ripper. Run regedit.exe and browse to:

HKCU\Software\Illustrate\dBpoweramp\CDRipper\Profiles\{profilename}

The correct CLI for all DSP effects will be shown under DSPEffects