How to use E.M. Total Video Converter Command Line
SDK
E.M. Total Video Converter
Command Line is a online video converter SDK
which offers a technical solution to convert any video
format online under command line (CLI mode) and
server side environments, it supports Windows and Linux
server side (via Wine) . E.M. Total Video Converter
Commnand Line SDK convert most video files (such as FLV,
SWF, AVI, WMV, MP4, 3GP, MPG, MPEG2, RMVB,
MOV, MP3, DV, AAC, and so on) and YouTube to
Ipod, iPhone, PSP, Zune, Xbox, PS3, 3gp, mp4, swf, flv,
DVD, VCD, etc.) online. Total Video Converter Commnand
Line SDK can aslo convert all video files to Adobe
Flash Video online. with E.M. Total Video Converter
Command Line SDK, you can build your own online video
sharing site easily, just like YouTube, Yahoo Video, MSN
Video and many other popular online video sharing
websites. Functions of video resizing, combining,
trimming are also the advantages belonging to E.M. Total
Video Converter Commnand Line SDK. To help you edit
video as your own demands, E.M. Total Video Converter
Commnand Line SDK has integrated many other useful
functions, like: adding subtitles, watermark to video
and generating static or animated thumbnail image for
the video.
E.M. Total Video Converter
Commnand Line SDK Demo provides you a complete and creative
online video sharing solution for video uploading and sharing,
especially a perfect solution for building your own
online video sharing site just like YouTube, Yahoo
Video, MSN Video and many other
popular online video sharing web site. It does the best to meet your personal or business needs of video
hosting, and can be applied to Web servers,
blogs, forums and other interactive areas.
To help you building your own online video hosting site,
we also provide YouTube clone script and the full
source code of a demo video hosting site written in PHP
with detailed documents and tutorials. With the pages you can upload video and convert almost all
popular formats of video to Adobe Flash Video (FLV) format
and other video formats or Pocket Player (like iPod,
iPhone, PSP etc. ) easily.
You can also do advanced video editing, batch conversion,
quality control and other tasks with CGI or any other
server-side scripting language.
Tutorials
How to convert video via command line parameters
This chapter tells you how to use
TVCC control the properties of converted
Flash Video such as dimension, frame rate, bit rate, etc.
via command-line parameters.
Table of Content
Usage of Total Video Converter Command
Line SDK
-
Please make sure you have installed Total Video Converter Command line
SDK successfully.
-
Run the Total Video Converter Command Line Version on
CLI (console mode).
-
Enter the TVCC Command line: TVCC -f inputfile [options]
-o outputfile
See the illustration
of below.
The following table is the detailed description of the command line parameters
and options.
Command Line Parameters
|
inputfile |
The
full path of the input video file. |
|
outputfile |
The
full path of the output .flv file. |
|
-h |
Show
the usage of Total Video Converter Command line. |
|
-v |
Show
the version of Total Video Converter Command line. |
|
-ff |
input files by text file mode. such as: "-ff multifile.text" |
|
-i |
Show
the information of the input video file. such as "TVC -f
C:\test.mp4 -i" |
|
-fsv |
input
slideshow pictures by text file mode, such as: "-fsv C:\picturce.txt" |
|
-fsa |
input
slideshow background music by text file mode, such as: "-fsa
C:\aduio.txt" |
|
-o |
output file, such as: "-o C:\output.flv" |
|
-pi |
Output settings using ini filename, such as: "-pi flv.ini", it
is optional |
|
-pn |
Output settings using profile name in ini file , such as: "-pn
Flash video normal quality". it must be matched with "-pi"
|
|
-tf |
encoding file start time, Format hh:mm:ss.0.1s such as:
-tf 00:02:53 |
|
-td |
encoding file duration, Format
hh:mm:ss.0.1s, such as: -tf 01:0:0 |
|
-ds |
Open
file with system directX |
|
-atds |
Auto
open file with system directX |
|
-vfilter |
Usage: -vfilter plugin-type -f <plugin-files>
[plugin-options] |
|
plugin-type |
usage |
|
subtitle |
syntax: |
-vfilter "subtile -f<subtile-files>" |
|
options |
-f |
supported subtitle file type: srt, sub, ssa, smi, psb,txt, idx, usf,
xss, etc. note: subtitle file name must be contained with"< >" |
|
sample |
-vfilter "subtile -f<C:\subtile.srt>" |
|
watermark |
syntax: |
-vfileter "watermark -f<watermark-files>" |
|
options |
-f |
the
input watermark file, surpported formats: jpg, png, gif |
|
-x |
X-axis of the watermark showed on the movie |
|
-y |
Y-axis of the watermark showed on the movie |
|
-d |
duration of watermark show |
|
-i |
the
interval of watermark show |
|
-a |
the
transparency of watermark, the range is(0, 255) |
|
sample |
-vfilter "watermark -f<C:\subtile.srt> -x 20 -y 20 -d 3 -i 2 -a
125" |
|
-thumbnail |
gernerate thumbnail while converting
|
|
uasge |
-thumbnail "-fo <thumbnail file name> -t timepoint -s w x h" |
|
options |
-fo |
output thumbnail file name, must be contained with"<>" |
|
-t |
timepoint of thumbnail gererated, optional, the formats is
hh:mm:ss |
|
-s |
size
of output thumbnail, optional, default is "160x120" |
|
sample |
-thumbnail "-f <c:\outputthumb.jpg> -t 0:5:22 -s 120x80" |
|
-i |
get
media file information, such as: "-f <c:\test.mp4> -i" |
|
-di |
print
the detail error information while converting |
|
-acodec |
output audio encoder, such as: -acodec mp3 |
|
-ab |
output audio bitrate, such as: -ab 128 |
|
-as |
output audio sample rate, such as: -as 44100 |
|
-ac |
output audio chanel,(1,2) |
|
-av |
volume, the range is (0, 255) |
|
-da
|
disable audio |
|
-vcodec
|
output video encoder, such as: -vcodec xvid |
|
-vb
|
output video bitrate, such as: -vb 500 |
|
-vf |
output video frame rate, such as: -vf 29.97 |
|
-vs |
output video size, such as: -vs 320x240 |
|
-aspcet
|
video
aspect ratio, 4:3 or 16:9, such as: -aspcet 16:9 |
|
-cropl |
crop
the left, such as: "-cropl 20", it means crop 20 pixels on the
left |
|
-cropr |
crop
the right, such as: "-cropr 20", it means crop 20 pixels on the
right |
|
-cropt |
crop
the top, such as: "-cropt 20", it means crop 20 pixels on the
top |
|
-cropb |
crop
the bottom, such as: "-cropb 20", it means crop 20 pixels on the
bottom |
|
-padl |
fill
the left, such as: "-padl 20", it means fill 20 pixels to the
left |
|
-padr
|
fill
the right, such as: "-padr 20", it means fill 20 pixels to the
right |
|
-padt
|
fill
the top, such as: "-padt 20", it means fill 20 pixels to the
top |
|
-padb |
fill
the bottom, such as: "-padb 20", it means fill 20 pixels to the
bottom |
|
-spt |
the
time of each picture be showed on the slideshow, such as:
"-st 2", it means every picture will durate 2 seconds when
showing. |
|
-set
|
the
time of slideshow effect when two pictures switch |
|
-sw |
width
of slideshow, such as: "-sx 720" |
|
-sh |
height of slideshow, such as: "-sh 480" |
|
-sfr |
the
framerate of slide show, such as: "-sfr 20" |
|
The following is a few samples.
Samples
Samples 1: Create a Flash Video with default settings. Because
we did not specify the ini filename and profile name, the program will encode
the flv video with the default value: dimension will use the source video value,
C:\TVC>CMDTVC -f E:\TestVideo\01.mp4 -o E:\OutputFiles\target.flve
|
Samples 2: Create a Flash Video with specifid ini
filename and profile name, and set vide size to 720x480
C:\TVC>CMDTVC -f E:\TestVideo\01.mp4 -fi flv.ini -pn Flash video normal
quality \
-vs 720x480 -o E:\OutputFiles\target.flve |
Sample 3: Create a Flash Video, set the dimension of output
video to 320x240, video bit rate to 330 Kbps, and with stereo audio.
CC:\TVC>CMDTVC
-f E:\TestVideo\01.mp4 -vs 320x240 -vb 330 -ac 2 \
-o
E:\OutputFiles\target.flve
|
Sample 4: combile two media files with default settings.
CC:\TVC>CMDTVC
-f E:\TestVideo\01.mp4 -f E:\TestVideo\01.rmvb \
-o
E:\OutputFiles\combine.flve
|
Sample 5: combile two or more media files into one file by text file (the text
file contains media file name list) with default settings.
CC:\TVC>CMDTVC
-ff E:\combine.txt -o E:\OutputFiles\combine.flve
|
Sample 6: Create
slideshow by input picture list file(a text file
contains picture file name list) and input music list file(a text file contains
music file name list), with default settings.
CC:\TVC>CMDTVC
-fsv E:\pictrue.txt -fsa E:\music.txt -o E:\OutputFiles\combine.flv
|
Sample 7: Create slideshow
from input picture list file(a text file
contains picture file name list), input music list file(a text file contains music
file name list), and set slideshow dimension to 320x240, set the time per picture
showed as 5 seconds , set pictrues switch time as 2 seconds.
CC:\TVC>CMDTVC
-fsv E:\pictrue.txt -fsa E:\music.txt -spt 5 -set 2 \
-o
E:\OutputFiles\slideshow.flve
|
Sample 8: Create a flash video and add a subtitle to the video.
Note:the filter content must be surrounded by quote
marks and the subtile file must be contained by "< >" marks.
CC:\TVC>CMDTVC
-f E:\test.mp4 -vfilter "subtitle -f <E:\TestVideo\srttest.srt>"
\
-o
E:\OutputFiles\mp4subtile.flve
|
Sample 9: Create a flash video and merge a gif picture
to the video as watermark. and set the watermark X-axis to 20, Y-axis to 20,
duration to 3 seconds, interval to 2 seconds, transpency to 125
Note:the filter content must be surrounded by quote
marks and the watermark file name must be contained by "< >" marks.
C:\TVC>CMDTVC
-f E:\test.mp4 -vfilter "watermak -f <E:\watermark.gif> -x 20 -y 20
\
-d 3
-i 2 -a 125" -o E:\OutputFiles\mp4watermark.flve
|
Sample 10: Create a flash video and
generate a thumbnail at 0:1:25, the thumbnail dimension is 160x120
C:\TVC>CMDTVC
-f E:\test.mp4 -thumbnail "watermak -f <E:\watermark.gif> -x 20 -y 20
\
-d 3
-i 2 -a 125" -o E:\OutputFiles\mp4watermark.flve
|
Note:the filter content must be surrounded by quote
marks and the watermark file must be contained by "< >" marks.
The Output and Exit Code of the Program
When you run the program from the Windows console or execute it in another
application, the program will print certain information to the STDOUT. You can
catch the STDOUT in your application to get desired information from the program
at run-time.
Output
If the input video file is a valid video file and can be encoded, the program
will print the following information to the STDOUT in turn:
-
File Name
-
Format
-
Duration
-
Start Time
-
Bit rate
-
Audio Information
-
Video Information
-
Conversion Progress
The following is an example:
C:\TVC>CmdTVC -f
E:\TestVideo\1.mp4 -o test.flv
File Name: E:\TestVideo\1.mp4
Format: mov,mp4,m4a,3gp,3g2,mj2
Duration: 00:11:57.7
Start Time: 0.000 s
Bit rate: 356 kbit/s
Video: mpeg4, yuv420p, 320x240 [PAR 1:1 DAR 4:3]
Audio: libfaad, 48000 Hz, stereo
Video: mpeg4, yuv420p, 320x240 [PAR 1:1 DAR 4:3]Audio: libfaad, 48000
Hz, stereo
|
-
File Name: Print input media file name
-
Format: Print the format of input media file;
-
Duration: Print the length of the input video. The format is
hh:mm:ss.0.1s.
-
Start Time: Print the video start time point.
-
Video: Print the Video Codec Name, PIX FMT, Video Dimension
-
Audio: Print the Audio Codec Name, Audio Sample Rate, Audio Channels
-
Percent: Print the size of converted and print the conversion progress
in percent periodically. The percent of 100% means the conversion is
accomplished and the program has terminated automatically.
If the input video file is not a valid video file, or the file can not be
encoded correctly, the program will print one line of error message to the
STDOUT and then terminate. The error message starts with the text by a
description of the error reason. For example, when you type the following
command in the console (assume "test.mpg" does not exist):
CC:\TVC>CmdTVC -f
test.mp4 -o test.flv
open the input file test.mp4 error
Could not find input stream matching output stream #0.0 |
Exit Code
The program may exit with the following exit codes. You can check the exit
code to know if the conversion is finished successfully or not.
|
Exit Code |
Description |
|
0 |
Conversion is finished
successfully.
|
|
-1 |
Conversion failed. |
|
-2 |
The 15-day trial version
of the program has expired. |
|
How to
register Total Video Command Line Version
If you want to purchase
Total Video Converter Command Line Version, you can
visit
https://www.plimus.com/jsp/buynow.jsp?contractId=1695190
to order the full version of Total Video Converter
Command line, after you ordered, you will receive a
license file called "key.dat" . please copy
the file "key.dat" to your Total Video
Converter Command Line author floder.
Total Video Converter
supports reading the following file formats:
Video Formats:
Convert from Real Video Rmvb (.rm,.rmvb)
Convert from MPEG4 (.mp4)
Convert from 3gp (.3gp, 3g2)
Convert from Game Psp (.psp)
Convert from MPEG1 (.mpg, mpeg)
Convert from MPEG2 PS (.mpg, mpeg, vob)
Convert from MPEG2 TS (DVB Transport Stream)
Convert from DIVX (.divx)
Convert from Ms ASF (.asf, .wmv)
Convert from Ms ASF (.asf, .wmv)
Convert from Ms AVI (.avi)
Convert from Macromedia Flash video FLV (.flv)
Convert from Apple Quicktime (.mov)
Convert from FLIC format (.fli, .flc)
Convert from Gif Animation (.gif)
Convert from DV (.dv)
Convert from Matroska (.mkv)
Convert from ogm (.ogm)
Convert from Video Formats Dx9 Directshow can open
Audio Formats:
Convert from CD audio (.cda)
Convert from MPEG audio (.mp3, mp2)
Convert from Ms WAV (.wav)
Convert from Ms WMA (.wma)
Convert from Real Audio (.ra)
Convert from OGG (.ogg)
Convert from Amr audio (.amr)
Convert from AC3 (.ac3)
Convert from SUN AU format (.au)
Convert from Macromedia Flash embedded audio (.swf)
Convert from Audio Formats Dx9 Directshow can open
Total Video Converter
Command Line supports generating the following file
formats:
Video Formats:
Convert to MPEG4(.mp4)
Convert to 3gp(.3gp, 3g2)
Convert to Game Psp (.psp)
Convert to MPEG1 (.mpg, mpeg)
Convert to NTSC, PAL DVD mpeg and Burn to DVD disc
Convert to NTSC, PAL SVCD mpeg and Burn to SVCD disc
Convert to NTSC, PAL VCD mpeg and Burn to VCD disc
Convert to Ms Mpeg4 AVI (.avi)
Convert to Divx AVI (.avi)
Convert to Xvid AVI (.avi)
Convert to H264 AVI (.avi)
Convert to Mjpeg AVI (.avi)
Convert to HuffYUV AVI (.avi)
Convert to Swf Video (.swf)
Convert to Flv Video (.flv)
Convert to Gif Animation (.gif)
Convert to Mpeg4 Mov (.mov)
Convert to Apple Quicktime (.mov)
Convert to DV (.dv)
Convert to WMV (.wmv)
Convert to HD Mpeg TS (.ts)
Convert to ASF (.asf)
Audio Formats:
Convert to MPEG audio(.mp3, mp2)
Convert to Ms WAV (.wav)
Convert to Ms WMA (.wma)
Convert to OGG (.ogg)
Convert to Amr audio (.amr)
Convert to AC3 (.ac3)
Convert to SUN AU format (.au)
Convert to m4a (mp4 audio)
Convert to aac (aac audio)
Convert to mmf (mmf audio)
Convert to Flac (flac audio)
Supports
We are happy to help you with any technical problems you may
encounter with our software. However, we can't help you with certain issues such as
information on how to program, or any other issues not related directly to the
workings of our software.
Contact Information
EffectMatrix Web site: http://www.effectmatrix.com
Technical support e-mail: emtvcc@google.com
Copyright 2008 EffectMatrix Inc. ALL RIGHTS RESERVED
|
