Command-line Parameters

NOTE: Because of a problem with interpreting the /Start command in VideoMach 5.15.1 please install the following version for use with command-line parameters: http://gromada.com/dl/videomach-5.11.1-setup.exe

VideoMach can perform automated conversions without human interaction. It can be called from an external application with certain parameters that tell it what to do. It's easy to write a text file with the commands below, and save it as "run-conversion.bat" for example (recommended extension is ".bat" for batch files). Then you can execute the task by double-clicking your bat file from File Explorer.

You can also create a desktop shortcut that runs VideoMach with the desired command-line parameters

To run a conversion periodically you can use Task Scheduler in Windows. When you run it click Action -> Create Basic Task and fill in the required fields. In the "Action" tab choose "Start a program". Under program/script locate videomach.exe on your disk (most likely "C:\Program Files (x86)\VideoMach\videomach.exe").

VideoMach supports the following command-line parameters:

Command Description
/OpenFile="media_file" Opens a file. You can use asterisks to open multiple files. To open all JPEG images from the "Images" folder pass this parameter:
/OpenFile="C:\Images\*.jpg"
/OpenSeq="first_file_in_the_sequence" Opens an image sequence.
/OpenProject="project_file" Opens a project. You can specify this parameter more than once to merge several projects into one (similar to using Project > Merge).
/OpenList="list_file" Opens files from the specified list file. Each line in the list contains one file name. Alternatively you can use the VFL file format which adds more parameters per each file.
/SaveOutput="output_audio_video_file" Specifies the output video and audio file. For example /SaveOutput="myvideo.avi".
/SaveVideo="output_video_file" Use it to save just video, or save audio and video to separate files. Not to be used with /SaveOutput.
/SaveAudio="output_audio_file" Use it to save just audio, or save audio and video to separate files. Not to be used with /SaveOutput.
/TempAvg Choose Temporal Average output mode.
/MatrixCols=number Specifies the number of columns in matrix (X axis).
/MatrixRows=number Specifies the number of rows in matrix (Y axis).
/MatrixPar Chooses parallel matrix output mode. If you set this parameter the output will be arranged in a matrix as when you choose Tools > Matrix > Parallel.
/MatrixSer Chooses serial matrix output mode. If you set this parameter the output will be arranged in a matrix as when you choose Tools > Matrix > Serial.
/Start Starts the conversion.
/Exit Exits VideoMach after conversion.
/Minimize Minimizes the main window during conversion.
/Key="license_key" Enter the license key for automated registration.
/User="user_name" Enter the user name for automated registration.
/Help or /? Show help about command-line options.
/Log Creates the execution log so you can trace errors in the command-line mode. This should be the first parameter in the command-line. Do not use it if you want to work in interactive mode, it can prevent some dialogs from appearing. To find out more about execution log click here.

Example 1:  Take an AVI and extract all of its pictures to a sequence of JPG images:

"C:\Program Files (x86)\VideoMach\videomach.exe" /openfile="c:\video\canyon.avi" /savevideo="c:\video\seq\canyon0001.jpg" /start /exit

This will generate a sequence of images named canyon0001.jpg, canyon0002.jpg, etc. Since we typed /Start the processing will start immediately. When the last image is saved the program will exit because we used the /Exit parameter.

Example 2: Open files from a textual list and create a compilation containing all input audio files:

"C:\Program Files (x86)\VideoMach\videomach.exe" /openlist="c:\audio\my_favorite_music.lst" /saveaudio="c:\audio\compilation.ogg" /start /exit

Example 3: Create a video out of images, with music:

"C:\Program Files (x86)\VideoMach\videomach.exe" /openseq="c:\video\simulation\anim0001.jpg" /openfile="c:\video\credits_animation.flc" /openfile="c:\audio\ambient_mix.mp3" /saveoutput="c:\video\presentation.mpg" /start /exit

Example 4: Create a complex video conversion task that includes video filters and specific audio/video codecs:

There are no command-line parameters for applying video filters or selecting a video codec, but there's a solution: project files. They can contain anything, from file lists, video filter lists, cropping, resizing, audio format, codecs and other parameters. Start VideoMach in interactive mode, set all the parameters you need and save them to a project files. You can even have several project files, some defining video effects, other defining output settings, etc. When projects are saved, you can easily load them from the command-line:

"C:\Program Files (x86)\VideoMach\videomach.exe" /openfile="c:\video\supersonic.avi" /openproject="c:\video\projects\settings.vmp" /saveoutput="c:\video\finalized.avi" /start /exit