FFgui User Guide


Table of Contents

1. Overview
2. Installation
2.1. FFmpeg
2.2. Files
3. User Interface
3.1. Destination
3.1.1. Projects
3.1.2. Encoding Templates
3.2. Edit
3.2.1. Sources
3.2.2. Edition
3.2.3. Parts
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. Overview

FFgui is a graphical user interface for the FFmpeg tool. FFgui helps you to convert video to all the format supported by FFmpeg.

FFgui takes advantage of the concat demuxer 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

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.

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.

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 ...

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