Appendix

This page is available in

Appendix

AVS Audio Converter XML Formatting

Example of AVSAudioConverterPro.xml file for conversion to MP3:

<?xml  version="1.0"  encoding="utf-8"?>
<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <inputFiles>
      <file>D:\Audio\audiofile1.wav</file>
      <file>D:\Audio\audiofile2.wav</file>
   </inputFiles>
   <inputFolders>
      <folder>.\Examples</folder>
      <filter>*.wav</filter>
      <includeSubfolders>false</includeSubfolders>
   </inputFolders>
   <outputFolder>%MYDOCUMENTS%\AVS4YOU\AVSAudioConverter</outputFolder>
   <merge>
      <makeMerge>false</makeMerge>
      <outputFileName>Untitled</outputFileName>
      <pauseMs>0</pauseMs>
   </merge>
   <audiobook>
      <createAudiobook>false</createAudiobook>
      <title>Title</title>
      <author>Author</author>
      <artist>Artist</artist>
      <coverFile>D:\Audio\cover.jpg</coverFile>
      <split>
         <mode>1</mode>
         <chapters>0</chapters>
         <time>00:00:00</time>
         <pauseDetection>false</pauseDetection>
      </split>
   </audiobook>
   <multithreadConversion>true</multithreadConversion>
   <autostartConversion>true</autostartConversion>
   <minimizeForm>false</minimizeForm>
   <replaceFileAndDir>true</replaceFileAndDir>
   <priority>3</priority>
   <finalAction>2</finalAction>
   <openOutputFolder>true</openOutputFolder>
</conversion>

The following tags and their parameters are available for AVS Audio Converter XML syntax:

conversion

The main output file parameters:

profiles - name of the XML file without extension with audio profiles which can be found in the %%Program Files%\AVSAudioConverterPro\profiles folder.
GUID - GUID of the needed profile taken from the profiles XML file.

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
</conversion>

[Back to Top]

conversion > inputFiles > file

The path to the input file(s).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <inputFiles>
      <file>D:\Audio\audiofile1.wav</file>
      <file>D:\Audio\audiofile2.wav</file>
   </inputFiles>
</conversion>

[Back to Top]

conversion > inputFolders

The path to the folder for the input file(s). The following subcategories are available here:

inputFolders > folder - the path to the folder where the input files are placed.
inputFolders > filter - the mask of the input files to be converted separated with semicolon.
inputFolders > includeSubfolders - either include the subfolders or not (possible values: true/false or 1/0).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <inputFolders>
      <folder>D:\Video\</folder>
      <filter>*.wav</filter>
      <includeSubfolders>false</includeSubfolders>
   </inputFolders>
</conversion>

[Back to Top]

conversion > outputFolder

The path to the folder for the output file(s).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <outputFolder>D:\Audio</outputFolder>
</conversion>

[Back to Top]

conversion > merge

Either split the output files into several ones or merge them in one. The following subcategories are available here:

merge > makeMerge - either merge the output files into one file or not (possible values: true/false or 1/0).
merge > outputFileName - the name for the output merged audio file.
merge > pauseMs - pause between the files in milliseconds (possible values: 0-5000).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <merge>
      <makeMerge>false</makeMerge>
      <outputFileName>Untitled</outputFileName>
      <pauseMs>0</pauseMs>
   </merge>
</conversion>

[Back to Top]

conversion > audiobook

Audiobook parameters in case you create one out of audio files. The following subcategories are available here:

audiobook > createAudiobook - either create audiobook or not (possible values: true/false or 1/0).
Note: if you select to create an audiobook use the AB_M4B_Profile or AB_MP3_Profile profile group name and the appropriate CLSID.
audiobook > title - audiobook title.
audiobook > author - audiobook author name.
audiobook > artist - audiobook artist name.
audiobook > coverFile - audiobook cover image file path.

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <audiobook>
      <createAudiobook>false</createAudiobook>
      <title>Title</title>
      <author>Author</author>
      <artist>Artist</artist>
      <coverFile>D:\Audio\cover.jpg</coverFile>
   </audiobook>
</conversion>

[Back to Top]

conversion > audiobook > split

Either split audiobook into chapters or not. The following subcategories are available here:

split > mode - split mode (possible values for MP3: 0 - disable split mode, 1 - split into N chapters, 2 - split by hh::mm:ss time; possible values for M4B: 1 - create chapters at the beginning of files, 2 - create N chapters, 3 - split by hh::mm:ss time).
split > chapters - number of chapters for MP3 mode 1 or M4B mode 2.
split > time - time (hh:mm:ss) for MP3 mode 2 and M4B mode 3.
split > pauseDetection - either use pause detection while splittin the audiobook into chapters or not (possible values: true/false or 1/0).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <audiobook>
      <split>
         <mode>1</mode>
         <chapters>0</chapters>
         <time>00:00:00</time>
         <pauseDetection>false</pauseDetection>
      </split>
   </audiobook>
</conversion>

[Back to Top]

conversion > multithreadConversion

Either use multithreading which allows converting several files at once during the conversion or not (possible values: true/false or 1/0).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <multithreadConversion>true</multithreadConversion>
</conversion>

[Back to Top]

conversion > autostartConversion

Either automatically start the conversion at the program startup or not (possible values: true/false or 1/0).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <autostartConversion>true</autostartConversion>
</conversion>

[Back to Top]

conversion > minimizeForm

Either minimize the application window to taskbar at the program startup or not (possible values: true/false or 1/0).

Note: this parameter is ignored if the autostartConversion is set to false.

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <minimizeForm>false</minimizeForm>
</conversion>

[Back to Top]

conversion > replaceFileAndDir

Either automatically permit the program to replace files and folders in the output folder without the warning dialog or not (possible values: true/false or 1/0).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <replaceFileAndDir>true</replaceFileAndDir>
</conversion>

[Back to Top]

conversion > priority

Priority of threads in process (possible values: 1 - highest, 2 - above normal, 3 - normal, 4 - below normal).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <priority>3</priority>
</conversion>

[Back to Top]

conversion > finalAction

The application behavior after the conversion is finished (possible values: 1 - do nothing, 2 - close application, 3 - shutdown PC).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <finalAction>2</finalAction>
</conversion>

[Back to Top]

conversion > openOutputFolder

Either automatically open the folder containing output files upon the conversion end or not (possible values: true/false or 1/0).

<conversion profiles="MP3_Profile" name="Best Quality" CLSID="{209D61A7-17B3-49be-BAA1-D9DCEACA082B}">
   <openOutputFolder>true</openOutputFolder>
</conversion>

[Back to Top]