Eye Lab is an open-source tool to create eye-tracking usability tests. It started as a final undergraduate work for the Computer Engineering student Karine Pistili who made the prototype. The idea is to evolve it into a more complete and useful tool with the community's help.

The current version of the software allows users to create their usability sessions of a website, recording the webcam, screen, and mouse movements and use this information to find out where the user has been looking into the screen by using heatmaps.

The project consists of two parts, this repository contains the backend of the application, and the frontend can be found here. Install it as well to have the full application running.

• Python 3x

python3 -m venv venv

source venv/bin/activate

pip install -r requirements.txt

flask run

python -m venv venv

venv\Scripts\activate

pip install -r requirements.txt

flask run

conda create --name flask_env python=3.10

conda activate flask_env

pip install -r requirements.txt

flask run

• If you face issues running flask run, try:

  python -m flask run

• If Flask is not installed, install it manually:

  pip install flask

• On Windows, if venv\Scripts\activate doesn't work, run PowerShell as Administrator and enable scripts:

  Set-ExecutionPolicy Unrestricted -Scope Process

Anyone is free to contribute to this project. Just do a pull request with your code and if it is all good we will accept it. You can also help us look for bugs if you find anything that creates an issue. To see the full list of contributions, check out the ahead commits of the "develop" branch concerning the "main" branch. Full logs of the project development can be found in the Daily Work Progress file. Hoping to see your name in the list of contributors soon! 🚀

This software is under the MIT License.

Copyright 2021 Uramaki Lab