AVS4YOU >> Appendix >> AVS Audio Converter XML Formatting

Powered by

Appendix
This page is available in English
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!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!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]

Please note that AVS4YOU programs do not allow you to copy protected material. You may use this software in copying material in which you own the copyright or have obtained permission to copy from the copyright owner.

AVS4YOU is a registered trademark of Online Media Technologies, Ltd., UK. Intel and Core 2 Duo are registered trademarks of Intel Corporation. AMD and Athlon X2 are registered trademarks of Advanced Micro Devices, Inc. Windows 10/8.1/8/7/XP/2003/Vista are registered trademarks of Microsoft Corporation. All other trademarks are the property of their respective owners.