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:\> |
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