WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg

Embed Size (px)

Citation preview

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    1/10

    Version 1.0

    Copyright 2006 2009

    http://www.winff.org

    Convert your videos quic!y" e#si!y" #nd #!! #t once with $in%% #nd %%&peg.

    'ntroduction

    WinFF is a graphical user interface for the command line video converter FFmpeg. It runsFFmpeg from the command line. So, you just pick your files, and, it does the rest.

    WinFF doesn't actually convert any video files. It just runs FFmpeg. Therefore, It will convert

    any video file that FFmpeg will convert. onversely, if FFmpeg will not convert the file, then WinFFwill not either.

    WinFF is free software! you can redistri"ute it and#or modify it under the terms of the $%&$eneral u"lic (icense as pu"lished "y the Free Software Foundation, either version ) of the (icense,

    or any later version. opies of the latest and previous source code archives are availa"le at WinFF.org.

    WinFF is distri"uted in the hope that it will "e useful, "ut WIT*+&T %- W%T-/

    without even the implied warranty of 01*%T2I(IT- or FIT%1SS F+ TI&(

    &+S1. See the $%& $eneral u"lic (icensefor more details.

    FFmpeg is a separate project, not connected to WinFF. 3FFmpeg is a complete, cross4platform

    solution to record, convert and stream audio and video. It includes li"avcodec 4 the leading audio#video

    codec li"rary.5 FFmpeg is a Trademark of Fa"rice 2ellard, originator of the FFmpeg project. FFmpeg

    is free software and is licensed under the ($( or $(. Specifically in the case of versions of FFmpegpackaged with WinFF, FFmpeg is licensed under the $(. omplete FFmpeg documentation and

    sources are availa"le http!##ffmpeg.org#

    http://www.gnu.org/licenses/gpl.htmlhttp://ffmpeg.org/http://ffmpeg.org/http://www.gnu.org/licenses/gpl.html
  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    2/10

    (sing $in%%

    1. )he %i!e *ist

    2. +dd/,e&ove Videos

    -. utput et#i!s

    . !#y Video

    . 3t#rt Converting

    6. +ddition#! ptions

    4. 5enus

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    3/10

    )he %i!e *ist: The list of files to "e converted

    )he +dd uttonadds files to the list. )he ,e&ove uttonremoves the highlighted files from the list. )he e!ete 7eyalso removes the highlighted files from the list.

    )he C!e#r uttonclears the list of files to "e converted.

    utput et#i!s:

    Convert )o: hoose the category of the format to convert to. evice reset:hoose the specific format to convert to. utput %o!der: Where to put the converted video files. -ou may add#remove#edit the presets "y choosingEdit Presetsfrom the file menu.

    6See 8diting resetsfurther in the this document7

    )he !#y utton:plays the highlighted file.

    The play "utton is a good test for conversion. With e8ceptions, if FFplay will not playthe file, FFmpeg will not convert it.

    licking on the playing video will seek to the percentage in file corresponding to thefraction of width that was clicked from left to right.

    While laying the following keys are availa"le!9 and 1S : ;uit.

    F : toggles Fullscreen. and S1 : ause.

    : cycle audio channel.

    < : cycle video channel.

    T : cycle su"titles.W4 Show audio waves.

    (eft#ight : Seek "ackward#forward => seconds.

    &p#?own 4 Seek "ackward#forward = minute.

    +ddition#! ptions: ommon options for most video conversions

    Video itr#te:The default video "itrate if not specified is @>>k"#s. The video "itrate isspecified in k"#s. So, ABC would "e ABC k"#s.

    Video %r#&e ,#te: Frames per second of the output video.Video 3ie: The siDe is the height and width of the output video. For e8ample! E>B8B>is the standard siDe for %TS ?

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    4/10

    +ddition#! Co&nd *ine #r#&eters: For advanced users.

    This allows you to specify any legal FFmpeg options 2eware of specifying one that is specified already in the additional options. n e8ample! 34ss >>!>=!>>5 would seek to = minute into the video "efore converting

    lease see the FFmpeg ?ocumentation for a complete list of options

    Convert utton: Starts the conversion process.

    uns FFmpeg on the files in the file list in a shell#command window. FFmpeg will tell you the reasons it failed, or it will show the num"er of seconds the

    current file completed.

    If FFmpeg fails you can most likely find a way to convert your file "y googling for3FFmpeg5 and the type of video file.

    ress the ause key to pause the script. ress any key to resume. ress the 9 key to ;uit encoding the current file, and continue on to the ne8t one.

    %i!e 5enu

    '&port reset:Imports presets from a WFF file 8;it:closes the program

    8dit 5enu

    resets:+pens the reset 1ditor. references:+pens the references.

    ptions 5enu

    +ddition#! ptions:Shows the dditional +ptions isp!#y C5 *ine:?isplays the script to "e run instead of converting. #use on %inish:auses the script at the end of conversion

    3hutdown on %inish! Shuts down the computer when finished converting

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    5/10

    8diting resets

    The presets editor is open "y choosing 3resets5 from the 1dit menu. +nce open you will seethe list of presets. licking a reset will fill the "o8es "elow with the selected preset's information.

    reset =#&e: This is an internal name used in the 8ml file.

    It must follow all the rules of an J0( tag name. %amely, one word, only letters and num"ers. If the preset name is the same as another preset the e8isting preset will "e replaced

    "y the current information.

    reset *#e!:This is the la"el shown in the list of presets shown on the main window

    It may contain any characters you wish. It should "e descriptive. "out B> characters ma8 visi"le. 18tra will "e shown as 3...5

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    6/10

    reset Co&nd *ine #r#&eters: This is the FFmpeg parameters for the preset.

    The params will "e specified after 34i inputfile5 and "efore the output filename. Spacing of params should "e the same as if the were typed into the command line. Spacing "efore and after the params will "e handled automatically ?o not specify the input or output file names.

    18isting resets are great e8amples.

    reset 8;tension: The file e8tension of the output files.

    This also specifies the container format for the file. &se 34f 3 in the params to force a particular format.

    reset C#tegory: The ategory for the reset to "e shown in.

    To create a new category, just type a new name. To use an e8isting category, enter the category.

    +dd/(pd#te utton: adds or updates the current preset -ou will "e asked to confirm the addition or update. +nce a preset is add it will "e availa"le in the main window "ut is not saved to disk

    until the S

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    7/10

    references

    >ener#! references

    The ef#u!t irectoryis the directory that will "e set as the destination directory at start up. If,e&e&er *#stis checked then WinFF will remem"er the destination directory from the last time it

    was ran.

    5u!tithre#dingfor dual core processors uses FFmpeg's 4threads @ parameter. It work on some

    codecs "ut not all and the codecs it works on is various in Windows and (inu8.

    riorityis the priority for the FFmpeg process when converting. Setting to high will use all

    resources availa"le to get done faster. Setting the riority to Idle will only convert when the computer

    is doing nothing. In (inu8 a user is not allowed to set a priority higher than normal. So setting the

    priority to high will have no effect, unless WinFF is ran as root, which is not advisa"le.

    references %or $indows ?

    First things first! If WinFF is running under Windows the (inu8#&ni8 ta" is completely non4

    functional. ?on't worry a"out screwing anything up, cause it just won't happen.

    )he p#th to %%&peg.e;eis the full path to ffmpeg. Such as!

    3!Krogram FilesKWinFFKwinff.e8e5

    -ou may change this to any location you have installed FFmpeg.e8e. If you leave this "lank, WinFFwill automatically revert to the location of WinFF.e8e and assume FFmpeg.e8e is in the same directory.

    )he p#th to ffp!#y.e;efunctions e8actly like the path to ffmpeg.e8e, e8cept it should point toffplay.e8e.

    (se C

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    8/10

    The #th to %%p!#yfunctions e8actly like the path to FFmpeg, e8cept it should point to

    FFplay.

    The )er&in#!to &se is the full path to the terminal you wish to use. WinFF defaults to Jterm

    as almost all J4windows systems have Jterm installed. +n ?e"ian#&"untu "ased systems, WinFF use

    the 84term4emulator sym"olic link. -ou may use any terminal you like "y specifying it's full path here.For e8ample, to use $nome4terminal under &"untu, you could specify this to "e 3#usr#"in#gnome4

    terminal5, and specify the Terminal +ptions as 3485 instead of 34e5. To use Jterm under Slackware,

    this should "e 3#usr#J==C#"in#8term5.

    The )er&in#! ptionscan "e anything you like, "ut must include as the last option, the option

    to e8ecute the remainder of the command line. gain for e8ample, Jterm uses 34e5, and $nome4Terminal uses 3485.

    %urther ,e#ding

    For more in depth information on the FFmpeg command line please see

    http!##ffmpeg.org#ffmpeg4doc.html. It contains the entire list of options and formats the can "e set usingFFmpeg. $oogling for FFmpeg and the format will give you some e8amples. lso e8isting presets will

    give you some good e8ample of what should "e specified.

    http://ffmpeg.org/ffmpeg-doc.htmlhttp://ffmpeg.org/ffmpeg-doc.html
  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    9/10

    Credits

    $ritten y 5#tthew $e#therford

    ei#n #nd (untu #c#ges y #u! >evers+ddition#! rogr#&ing y '#n 3tofferg

    q.

    ui!ds of %%&peg p#c#ged with $in%% #re fro& ,#&iro #!!o.

    )h#ns to:

    Chris id&e#d for scripting ide#s.

    =ei! evers.

    %rench tr#ns!#tion y Chop!#ir.

    >ern tr#ns!#tion y 7#i 8vers.

    't#!i#n tr#ns!#tion y ,oerto oriotti.

    o!ish tr#ns!#tion y 5#rcin )ryus.ortuguese tr#ns!#tion y *ouis )orr#o.

    3eri#n )r#ns!#tion y redr#g )osevic

    3p#nish tr#ns!#tion y VBctor #ese.

    )r#dition#! Chinese tr#ns!#tion y Chung u.

    )urish tr#ns!#tion y 8&re 8r#n.

    )h#ns to #!! the (sers

  • 7/27/2019 WinFF.en Convert your videos quickly, easily, and all at once with WinFF and FFmpeg.

    10/10

    $in%%http://www.winff.org

    Convert your videos quic!y" e#si!y" #nd #!! #t once with $in%% #nd %%&peg.

    Copyright of this docu&ent:

    2009 5#tthew $e#therfordttDiggtt.co&

    er&ission is gr#nted to copy" distriute #nd/or &odify this docu&ent under the

    ter&s of the >=( %ree ocu&ent#tion *icense" Version 1.- or #ny !#ter version

    pu!ished y the %ree 3oftw#re %ound#tionE with no 'nv#ri#nt 3ections" no %rontF

    Cover )e;ts" #nd no #cFCover )e;ts. + copy of the !icense shou!d e found with

    this docu&ent. 'f you did not ot#in the !icense" it c#n e found #t

    http://www.gnu.org/!icenses/fd!.ht&!.

    mailto:[email protected]://www.gnu.org/licenses/fdl.htmlmailto:[email protected]://www.gnu.org/licenses/fdl.html