Code Monkey home page Code Monkey logo

feva's Introduction

Table of Contents

FEVA

Fast Event Video Annotation, FEVA, is a video annotation tool with streamlined interaction techniques and a dynamic interface that makes labeling tasks easy and fast. FEVA focuses on speed, accuracy, and simplicity to make annotation quick, consistent, and straightforward.

Details of the tool, design choices, and comparison with other tools are in our Paper on Arxiv

Feva

Description:

Video Annotation is a crucial process in computer science and social science alike. Many video annotation tools (VATs) offer a wide range of features for making annotation possible. We conducted an extensive survey of over 59 VATs and interviewed interdisciplinary researchers to evaluate the usability of VATs. Our findings suggest that most current VATs have overwhelming user interfaces, poor interaction techniques, and difficult-to-understand features. These often lead to longer annotation time, label inconsistencies, and user fatigue. We introduce FEVA, a video annotation tool with streamlined interaction techniques and a dynamic interface that makes labeling tasks easy and fast. FEVA focuses on speed, accuracy, and simplicity to make annotation quick, consistent, and straightforward. For example, annotators can control the speed and direction of the video and mark the onset and the offset of a label in real time with single key presses. In our user study, FEVA users, on average, require 36% less interaction than the most popular annotation tools (Advene, ANVIL, ELAN, VIA, and VIAN). The participants (N=32) rated FEVA as more intuitive and required less mental demand. You can learn more about the FEVA in our website https://www.snehesh.com/feva.

Prerequisite:

  1. Python 3.5.x or later : Tested and verified. While this code should work with any Python version, some dependencies packages may break compatibility. Please file an issue if you find that FEVA has issues running with a particular python version.

  2. Windows, Mac and Ubuntu: Tested and verified. While it should work with any system that can run python (specifically Flask package) and runs Chrome browser, FEVA should run. If you have any issues, please file an issue or do a pull request with a fix.

  3. FEVA only supports Google Chrome browser. I tested it with Firefox and Safari a couple of times and they do not work well.

This installation assumes that you have all the prerequisite requirements met.

  1. Clone this repo.
  2. Then from your terminal (command prompt on Windows), go into the repo folder cd feva
  3. On Ubuntu or Macs, run setup.sh (This will download ffmpeg, install python dependency packages, and creates needed folders)

If all of these run without any errors, your FEVA is ready to use.

  1. To run FEVA, type python3 feva.py
  2. Then go to your browser and load URL: http://localhost:8000 (If your computer has the port 8000 firewalled, you can specify the port number when starting FEVA, here is an example with port as 5000: python feva.py --port 5000. Then you'd load http://localhost:5000.

Tutorial

You can watch a quick start guide video here: Coming soon.

Citation

If you use this tool or code in your research, please cite our work:

@article{shrestha2023feva,
  title={FEVA: Fast Event Video Annotation Tool},
  author={Shrestha, Snehesh and Sentosatio, William and Peng, Huiashu and 
           Fermuller, Cornelia and Aloimonos, Yiannis},
  journal={arXiv preprint arXiv:2301.00482},
  year={2023}
}

feva's People

Contributors

sneheshs avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

feva's Issues

Invalid project error

I am trying to create new project on FEVA to get started with a sample data. I see Invalid Project error on localhost html page, and then I found in the \static\data folder a folder for the project that I was trying to create that includes also 4 files (2 .avi files, 1 .gif file, 1.dat file) . I can not see the video in the annotation tool to start annotating. The system is Ubuntu 20.04 and I use python 3.5.2 under a conda environment, and the browser is chrome.

how to use feva

I successfully opened the web page, but I don't know how to use it

Any tutorials/user guide available?

Looks like a cool project, but there are no currently available guides for how to use the tool (either in tutorial or text form): will one be released soon?

Audio misalignment

The audio track display is not always aligned with the video. This cause major confusion during annotation.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.