Framecoder is an open source application for Windows enabling fast manual coding of video frames, for example for labeling Regions Of Interest (ROIs) during mobile eye tracking experiments.
The best way to get framecoder is to download the latest release from GitHub.
Alternatively, the most recently built experimental version of framecoder can be found on AppVeyor. Download it, unzip to a nice location, and run
Framecoder expects a folder of frames per video with the
.jpg file extension. Via
File > Open subject folder all images that are to be coded for a specific video can be loaded into the session. Alternatively, videos can be split into frames directly by using
File > Convert video to frames.
The folder name is used as the values in the
Subject column for the exported csv.
The radio buttons and checkboxes can be used to code the frames. For quick usage, each data entry control is associated with a shortcut key (1-5). For example, pressing the
1 key on the keyboard will toggle the first checkbox. The next and previous frames can be selected using the right and left arrow keys.
File > Export to csv a semicolon-separated data file with all the codings can be exported to the disk. The data file will look somewhat like so:
Additionally, an entire session can be saved and loaded to the custom
Framecoder Session (.fcs) file format using
File > Save session and
File > Load session, so you can save your work and continue where you left off.
Advanced: Custom coding
By editing the text file
assets/config.yaml in the framecoder folder before startup, custom data entry controls can be added to the data entry fields. Only checkboxes, radiobuttons, and text fields are supported. The shortcuts can also be edited here. Custom coding will be saved in the
.fcs framecoder session file upon saving.
Building framecoder from source
Framecoder is written in
.NET. Dependencies are managed via
- Install Visual Studio 2017 (later versions probably work too!)
- Clone / download this repository
- Build the project using Visual Studio
.exewill be generated in the
We gather no data whatsoever from you