Most functionality of Music Converter can be scripted:
conversions, reading / writing ID Tags and reading audio file
properties (such as bit rate, etc). Scripting can be controlled from any
COM aware programs, or a
program written in c++, .NET, Visual Basic scripting even web based
Scripting License: A dBpoweramp Reference license is
required for each PC & concurrent scripting object. For example 1 PC
handles scripting, it is a dual cpu system and 2 scripting objects are
used side by side, 2 Reference licenses are required.
Supplied as part of another Program:
Email your requirements.
Release 12 or newer of Music Converter is required, older versions of
Music Converter had a different scripting library, see the previous
version compatibility section.
Music Converter is
controlled through a COM object called dMCScripting. See examples
provided at the end of this section on how to access this object in
Source filename (note all
filenames must include a full path, ie c:\file.mp3).
Destination filename, existing file overwritten,
folders are not automatically created.
Note: Extension automatically added to ToFile on 32 bit
Windows, but not on 64 bit Windows
Audio format encoding to ( such as mp3 (Lame)
settings passing to encoder, see CoreConverter command line
Pass a filename, this file will receive any
conversion errors. If there are no errors this file will
remain 0 bytes. Pass "" if no error file is required.
DSP effects can also be activated, pass them
in CompressionCLI, see command line documentation.
BSTR *pTagElement, [out]
BSTR *pTagValue )
Read ID Tag from File: .ReadIDTag ([in]
Pass 0, 1, 2... until pTagElement returns ""
Returns Tag element, or "" when finished.
Returns Tag Value.
Note this method is not compatible with VBScripting, instead
Read ID Tag from File: .ReadIDTagElementValue ([in]
BSTR *pTagElementValue )
Pass 0, 1, 2... until pTagElementValue returns ""
Returns "Element: Value", or "" when finished.
Note requires dBpoweramp R13 or above.
Write ID Tag to File: .WriteIDTag ([in]
BSTR Element, [in]
BSTR Value )
Tag element to set, such as Artist.
Tag Value to set.
Show Compression Settings Dialog: .ShowSettings ([in]
BSTR InCompressionCLI, [out,
BSTR *OutCompressionCLI )
Existing compression settings
passing to setting page, from previous edit, pass "" first time.
Returns the user chosen compression CLI string, ready to be
passed to .Convert
Note does not function on 64 bit Windows
Read Audio Properties from File: .AudioProperties ([in]
BSTR *OutProps )
Returns a string containing audio properties.
Example scripting code for:
additional include files:
.NET Visual Basic
Host VB Script
Older scripting code written for older Music Converters will function
with these caveats:
Setting OggSettings, WMASettings, WaveSettings or Mp3Settings do not
alter settings for 12 (use new methods and pass the settings on a
conversion command line)
.VolumeNormalize, .PreserveTags, .DeleteSourceFiles no longer function
(tags are always preserved, to delete source or volume normalize use
DSPs on the conversion command line)
.GoConversion ( NoOptions, NoOverwrite, NoConversionFinished, NoError
Log are ignored