EducationalTestingService / Confero

Eye-tracking, Screen and Event Capturing System for Windows. A web application running on a separate PC allows for real time monitoring of the users actions.
GNU General Public License v3.0
9 stars 1 forks source link
eye-tracking psychology-experiments python windows

Confero Software Suite

Screen and User Event Capturing System for Windows.

http://educationaltestingservice.github.io/Confero/


The Confero Software Suite consists of two python applications and a web brower based UI:

Confero Track Features

Confero View Features:

Installation

Important: The following installation instructions must be followed for both the computer that will be used to run Confero Track, as well as the computer that will run the Confero Server and Confero View aplications.

The Confero software may be installed anywere on the computer. A convenient location is C:\Confero, which in most cases will allow all users on the computer to access Confero. Note that this also expose all the program files and data to all users. You may risk accidental deletions or misconfigurations. Decide your installation path according to your application.

In the remainder of the document we refer to the Confero root directory as CONFERO_ROOT. In the above example, CONFERO_ROOT = c:\ .

The document assumes you are installing from a distribution package (distro), in the form of a ZIP or an EXE file.

Python Package Dependancies (if needed)

If you are installing from a distribution package (either as a ZIP file or an EXE file), all the dependencies should have been included. Skip this section.

The following python packages must be installed in the python distribution being used to run Confero Application Suite. All packages must be for Python 2.7 32-bit (even if Windows is 64bit)

Eye Tracker Client Library (if needed)

This is only necessary if you are using an eye-tracker that is not currently included in the distribution (EyeLink or Tobii remote series)

If using an eye tracker, ensure any dependencies specific to the eye tracker being used have been installed. See the docs for the eye tracker being used with iohub for more details: http://www.isolver-solutions.com/iohubdocs/iohub/api_and_manual/device_details/eyetracker.html#eye-tracking-hardware-implementations

Install these programs first

The following programs should be installed and configured before running Confero.

Screen Capturer Recorder

The setup program is included in the dependancies folder. Use the version of program provided. You need to installation only once on a computer, but the program may need to be set up for each user separately on the computer. Try to see if the recorded video or the mirrored video is scrambled. If so, repeat the set up process for each user on the computer.

To configure for a user:

  1. Log in to Windows as the User.
  2. Go to menu Start >> All Programs >> Screen Capturer Recorder >> configure >> configure by setting specific screen capture numbers. This will launch a DOS window, and it may take a few seconds to load.
  3. Follow the onscreen instruction to go through the process. Leave BLANK, not 0, for default values. The most important parameters are the size of the monitor, and which monitor to record if you have multiple monitors. To find out the specific numbers, use Control Panel >> Display or other programs to view the display setting.

Bonjour

Bonjour is used to automatically recognize and configure the IPs of the Track and View programs. Use the version provided; use either the 32bit or 64bit version depending on your Windows OS. You may need to reinstall it if you experience problems with Bonjour. No configuration is needed for Bonjour.

Configure Confero

Confero may be configured to run on a single computer or two computers. Following the following procedure for a minimal setup. If you need to adjust additional parameters, consult the Confero manual.

Single computer

Set up Confero Track:

Set up Confero View:

Two computers

UserMonitor Project Files

Download the latest version of the Confero Application Suite from it's github repo: https://github.com/isolver/UserMonitor/archive/master.zip

BELOW TEXT NEEDS UPDATING

Follow these steps to setup Confero for the first time:

  1. Unpack the master.zip archive to a location of your choice.
  2. Rename the folder that was unpacked from usermonitor-master to UserMonitor.
  3. Open the UserMonitor folder.
  4. Unpack the bin.zip file into the current directory. After unpacking bin.zip, there should be a bin folder in the top level UserMonitor directory.
  5. Install the dshow filters used for screen capturing by running the Setup Screen Capturer Recorder v0.10.0.exe installer found in the UserMonitor/ dependancies folder.
  6. Configure the Screen Capturer Recorder filter by running: Start->All Programs->Screen Capturer Recorder->configure by setting specific screen capture numbers. For each question asked, remove any text in the textbox field and continue, other than for the capture width and height settings, which should equal the pixel resolution of the monitor that will be used for screen capturing.
  7. Edit the /source/usermonitor/iohub_config.yaml as necessary.
  8. Edit the /source/usermonitor/app_config.yaml as necessary.

Usage

To start the UserMonitor Applications:

User Monitor Feedback and Control Application

From the computer being used to run the User Monitor Feedback and Control application, run the following python script from a command prompt:

python.exe /source/usermonitor/webserver/start.py

When the application starts, your web browser should automatiocally open running the User Monitor Feedback and Control Application web GUI. You can not use this application, until the data collection application has also been started (next step)

Data Collection Application

From the computer being used to run the data collection application, which is the computer the participant will be interacting with, run the following python script from a command prompt:

python.exe /source/usermonitor/datacollection/start.py

When the application starts the cmd window can be minimized.

Collecting Data

To learn how to use the User Monitor Feedback and Control Application GUI to control the Data Collection application, including openning and closing participant sessions and starting / stopping recording of data, please see the Help documentation available via the User Monitor Feedback and Control Application GUI.

License

GNU General Public License (GPL version 3 or any later version)

Contact: Gary Feng gary.feng@gmail.com