FFgui User Guide - JavaLikeScript

directory ffgui.tabs.json The tabs configuration contains the FFmpeg arguments that will be displayed in the user interface. The arguments are grouped per tab.
24KB taille 1 téléchargements 261 vues
FFgui User Guide spyl

Table of Contents 1. Overview ....................................................................................................................... 2. Installation ..................................................................................................................... 2.1. FFmpeg .............................................................................................................. 2.2. Files ................................................................................................................... 3. User Interface ................................................................................................................ 3.1. Destination .......................................................................................................... 3.2. Edit .................................................................................................................... 3.3. Sources ............................................................................................................... 3.4. Console .............................................................................................................. 3.5. Arguments .......................................................................................................... 4. Miscellaneous ................................................................................................................. 5. How To ........................................................................................................................ 5.1. How to concatenate camcorder videos ...................................................................... 5.2. How to cut commercials from a video ...................................................................... 5.3. How to transcode a video ......................................................................................

1 1 1 1 2 2 2 3 3 3 3 4 4 4 4

1. Overview FFgui is a graphical user interface for the FFmpeg1 tool. FFgui helps you to convert video to all the format supported by FFmpeg. FFgui takes advantage of the concat demuxer2 to concatenate videos.

2. Installation There is no specific installation, just unzip the distribution in the folder you want.

2.1. FFmpeg When starting the application for the first time, you will be prompt for the FFmpeg executable.

2.2. Files The following are the main files

1 2

ffgui.exe

The application executable

ffgui.json

The configuration file contains the encoding templates and the FFmpeg home directory

ffgui.tabs.json

The tabs configuration contains the FFmpeg arguments that will be displayed in the user interface. The arguments are grouped per tab.

http://ffmpeg.org http://ffmpeg.org/ffmpeg-formats.html#concat

1

FFgui User Guide

3. User Interface This section presents the user interface

3.1. Destination The destination tab enables to select the name of the file that will be created. Additionaly you could manage the projects, the encoding templates and start the transcoding.

3.1.1. Projects A project contains the sources, the destination and the encoding configuration. A saved project could be loaded at a later time.

3.1.2. Encoding Templates An encoding template is a set of predefined values for FFmpeg. FFgui is provided with basic encoding templates. When loading an encoding template, the predefined values are loaded in the associated tab. For example loading the “ mp4” template will define the video codec as “ h263”. The other values are not modified enabling to mix different templates like audio and video. When saving an encoding template all the defined values are saved in the configuration file ffgui.json. When clearing the encoding template all the possible values are set to their default value. When deleting the encoding template the template is removed from the configuration file ffgui.json and cannot be loaded any more.

3.2. Edit The edit tab enables to concat the sources or part of the sources. If no parts have been selected then all the sources will be concatened. If there is only one source or only one part the video will be transcoded directly, without concatenation. The videos to concatenate must have the same codecs. If you use the copy codec then make sure that the originating sources share the same codecs.

3.2.1. Sources In the source panel you could add a new source or select an existing source for the edition by clicking on it.

3.2.2. Edition In the edition panel you could define the interval of the selection and add it to the selected part. An interval is defined by the start time and the stop time. If the start time is left empty then the source will be used from the beggining. If the stop time is left empty then the source will be used until the end. When editing an existing part it is possible to update or remove it.

2

FFgui User Guide

3.2.3. Parts In the part panel you could see all the selected part that will be concatenated after the encoding. It is possible to edit a part by clicking on it. For now it is not possible to change the part order.

3.3. Sources The source tab presents all the source available for the project. Each source can be played, probed or removed from the project using the respective buttons >, i and x. The source are played using ffplay, the timestamp is displayed in the top left corner. While playing, the following keys are available: escape:

Quit

f:

toggle full screen

p, space:

pause

s:

activate frame-step mode

left/right:

seek backward/forward 10 seconds

down/up:

seek backward/forward 1 minute

page down/page up:

seek backward/forward 10 minutes

mouse click:

seek to percentage in file corresponding to fraction of width

The source are probed using ffprobe the output of the ffprobe is displayed in the console tab.

3.4. Console The console tab diplays the output of the FFmpeg commands.

3.5. Arguments The argument tabs enables to define the encoding configuration for FFmpeg. The default argument tabs are Format, Audio and Video. It is possible to modify or add argument tab by editing the configuration file ffgui.tabs.json.

4. Miscellaneous FFgui caches all the video preview images in the directory %TEMP%\ffgui.tmp. Please consider delete it once a while. The command line is the following: ffgui --clean --project project_file --configuration configuration_file --destination destination_file --exitAfter --start source_file ...

3

FFgui User Guide

The File menu enables to import basic “Windows Live Movie Maker” project. Please do not expect this feature to work fine.

5. How To This section provides instructions to deal with common tasks

5.1. How to concatenate camcorder videos Videos recorded with the same camcorder use the same codecs. It is possible to concatenate them quickly and lossely. Starts by adding all the videos using the Add Source button. Probes the first source and look for the container format. Select the format in the Format tab. Select the copy codec for both video and audio. Optionally cut and select some parts out of the videos using the Edit tab. Select the destination filename. Start the job.

5.2. How to cut commercials from a video To write

5.3. How to transcode a video To write

4