Description of AVS Video Converter command line keys

The AVSVideoConverter program accepts optional command line parameters.
These can be useful to experienced users and for automation.

Usage:
    AVSVideoConverter.exe -h
    AVSVideoConverter.exe /h
    AVSVideoConverter.exe -?
    AVSVideoConverter.exe /?
        - show console help.

    AVSVideoConverter.exe [videofile1] [videofile2] ... [videofileN]
        - run application and add input videofiles.

    AVSVideoConverter.exe -a configurationXML
    AVSVideoConverter.exe /a configurationXML
        - run application in automatic mode with parameters from configuration XML.

Example:
C:\Program Files\AVS4YOU\AVSVideoConverter\AVSVideoConverter.exe -a "D:\AVSVideoConverter.xml"


Specification of configuration XML - description of tags

    <conversion>
        profiles              - group name for needed profile;
                                name of XML file (without extension) with
                                profiles in directory \AVSVideoConverter\profiles -
                                required attribute.
        name                  - name of needed profile (from XML file) -
                                optional attribute (not necessary).
        GUID                  - GUID of needed profile (from XML file) -
                                required attribute.
    <inputFiles>
        <file>                - path for input files.
    <inputFolders>
        <folder>              - path for input folders.
        <filter>              - filter for input files: file extensions separated by
                                semicolon, for example, "*.*" (all files), "*.avi"
                                (AVI only), "*.avi;*.mp4" (AVI and MP4 only), "DVD" for
                                DVD disc folders or "BD" for Blu-Ray disc folders.
        <includeSubfolders>   - add files from subdirectories or not (true/false or 1/0).
    <outputPath>              - path for output directory (for split or DVD/BD)
                                or output file (for merge).
    <split>
        <makeSplit>           - make split or not (true/false or 1/0).
        <mode>                - split mode
                                (1 - Batch Mode,
                                 2 - Split by Chapters (not supported now),
                                 3 - Limit File Size).
        <size>                - size for mode 3 (in megabytes).
    <inputAspectCorrection>
        <mode>                - mode of input video aspect correction
                                (1 - Original, 2 - 4:3, 3 - 16:9,
                                 4 - Width:Height, 5 - Custom).
        <wValue>              - Width value for mode 5 (1...3840).
        <hValue>              - Height value for mode 5 (1...3840).
    <outputAspectCorrection>
        <mode>                - mode of output video aspect correction
                                (1 - Original, 2 - No Correction;
                                 for DVD: 1 - 4:3, 2 - 16:9;
                                 for Blu-Ray: 1 - 16:9).
        <cropScale>           - crop scale value for mode 1 (0...100).
    <flashPlayerFLV>
        <createPlayer>        - create flash player for FLV or not (true/false or 1/0).
        <template>            - name of template for player.
        <autostartPlayback>   - autostart video playback or not (true/false or 1/0).
        <loopPlayback>        - loop video playback or not (true/false or 1/0).
    <saveFileDateTime>        - save file modification date and time or not
                                (true/false or 1/0).
    <autostartConversion>     - autostart conversion or not (true/false or 1/0).
    <minimizeForm>            - minimize application to taskbar or not (true/false or 1/0);
                                this parameter is ignored if autostartConversion = false.
    <showAdvanced>            - show panel with advanced options or not
                                (true/false or 1/0).
    <replaceFileAndDir>       - automatically permit to replace files and
                                folders without warning dialog or not (true/false or 1/0).
    <priority>                - priority of threads in process
                                (1 - Highest, 2 - Above Normal,
                                 3 - Normal, 4 - Below Normal);
                                this option is actual only for current application
                                work session and does not change the "Priority"
                                option in Settings.
    <finalAction>             - final action after conversion
                                (1 - Do Nothing, 2 - Play Sound,
                                 3 - Close Application, 4 - Shutdown PC).
    <openOutputFolder>        - automatically open output folder after conversion
                                or not (true/false or 1/0); may be actual for finalAction
                                1, 2, 3.


Example of AVSVideoConverter.xml file for conversion to MP4:

<?xml version="1.0" encoding="utf-8"?>
<conversion profiles="mp4profiles" name="PC - Normal Quality" GUID="DAC093C7-87A8-4574-A439-95168CED8AE4">
    <inputFiles>
        <file>.\Examples\videofile1.avi</file>
        <file>.\Examples\videofile2.avi</file>
    </inputFiles>
    <inputFolders>
        <folder></folder>
        <filter>*.avi</filter>
        <includeSubfolders>false</includeSubfolders>
    </inputFolders>
    <outputPath>%MYDOCUMENTS%\AVS4YOU\AVSVideoConverter\</outputPath>
    <split>
        <makeSplit>true</makeSplit>
        <mode>1</mode>
        <size>0</size>
    </split>
    <inputAspectCorrection>
        <mode>1</mode>
        <wValue>0</wValue>
        <hValue>0</hValue>
    </inputAspectCorrection>
    <outputAspectCorrection>
        <mode>1</mode>
        <cropScale>0</cropScale>
    </outputAspectCorrection>
    <flashPlayerFLV>
        <createPlayer>false</createPlayer>
        <template>Wood</template>
        <autostartPlayback>false</autostartPlayback>
        <loopPlayback>false</loopPlayback>
    </flashPlayerFLV>
    <saveFileDateTime>false</saveFileDateTime>
    <autostartConversion>true</autostartConversion>
    <minimizeForm>false</minimizeForm>
    <showAdvanced>false</showAdvanced>
    <replaceFileAndDir>true</replaceFileAndDir>
    <priority>3</priority>
    <finalAction>3</finalAction>
    <openOutputFolder>true</openOutputFolder>
</conversion>


See other examples of configuration XMLs in \Examples folder.
You can run special batch BAT-files for the application work demonstration.

For <file>, <folder> and <outputPath> tags next names and environment
variables are supported:
    .\                   - current directory;
    ..\                  - parent directory;
    %APPDATA%            - Application Data directory of current user;
    %COMMONPROGRAMFILES% - "Program Files\Common Files" directory;
    %LOCALAPPDATA%       - "AppData\Local" directory of current user;
    %MYDOCUMENTS%        - "Documents" / "My Documents" directory of current user;
    %MYMUSIC%            - "Music" / "My Music" directory of current user;
    %MYPICTURES%         - "Pictures" / "My Pictures" directory of current user;
    %MYVIDEOS%           - "Videos" / "My Videos" directory of current user;
    %PROGRAMFILES%       - "Program Files" directory;
    %SYSTEMDRIVE%        - the drive upon which the system directory was placed;
    %SYSTEMROOT%         - the Windows directory;
    %TEMP%               - directory for temporary files ("Temp" directory of current user);
    %TMP%                - directory for temporary files ("Temp" directory of current user);
    %USERPROFILE%        - directory of current user profile;
    %WINDIR%             - the Windows directory.


Program generates next files in folder %APPDATA%\AVS4YOU\AVSVideoConverter:
* AVSVideoConverter.log - log-file with description of operations performed
  by application and occurred errors;
* AVSVideoConverter.rpt - report-file with recording the result of each
  conversion task and occurred error;
* ConversionProgress.rpt - report-file with current value of progress for
  current conversion task (0% ... 100%).

The status of current conversion process can be detected using files
AVSVideoConverter.rpt and ConversionProgress.rpt.


Format of AVSVideoConverter.rpt:

[Application name and version]

[Date and time of report creation]

[Conversion result]
[ERROR]

[Date and time of report closing]


Variants of conversion result:
* NOT STARTED
* INTERRUPTED
* FAILED
* SUCCEEDED
If conversion result is NOT STARTED or FAILED, there is the description
of ERROR in next line(s).

