Tools for video summarization
=============================
Authors: Lukas Klicnar   (iklicnar@fit.vutbr.cz)
         Vitezslav Beran (beranv@fit.vutbr.cz)

Software for static camera video summarization. This package contains tools for two possible scenarios: The first one is to use a combination of provided tools with command line interface, the second choice is a desktop application with a graphical user interface.


Content
-------
bin                        - Binary files (without libraries)
src                        - All source files
src/FeatureExtractor       - Tool for video preprocessing (step before summarization)
src/SummarizationFramework - A summarization library used by all the provided tools
src/Summarizer-cli         - Summarization tool with command line interface
src/Summarizer-gui         - Summarization tool with graphical user interface


Requirements
------------
This application needs the following libraries to be compiled and it was tested with the exact versions stated in brackets (it will probably work with lower versions too when recompiled):

-OpenCV 2 (2.4.7)
-Qt 5 (5.3.2)


Installation
------------
This application is provided in the form of source code, so you have to compile it first. It is recommended to use MSVC12 compiler, since it was developed with its utilization. The GUI version can also be easilly compiled with Qt Creator IDE. The tool is platform-independent, it should work at least at Windows and Linux. Binaries  for Windows are also included, but without the necessary dynamic-linked libraries, you have to download them manually.


Usage
-----
Every tool has a built-in help with explanations of all parameters. To summarize a video sequence "video.avi" (with a command line interface tools), the following steps are necessary:

1) Video preprocessing - features extraction
   -run: FeatureExtractor.exe -v video.avi
   -output is a .csv file with extracted features (multiple features - indices 0..31)

2) Video summarization
   -run: Summarizer-cli.exe features.csv feature_index segment_length max_segments_count video.avi out_summarized_video.avi
   -output is a summary in "out_summarized_video.avi"

The GUI tool should be self-explanatory :)
