Tacty

Tacty is an open source integrated tactile interaction analysis toolkit.

Features

Available:

• Extract map area from the input video.
• Calibrate color tracking hues and tolerances.
• Multiple shape classifiers (Hu Moments, AI Classifier).
• Data cleanup (outlier detection, interpolation).
• .csv and .xslx export for the movement data, as well as a dedicated GazePlotter exporter.

Planned:

• Heatmap export.
• Background removal.
• Areas of interest.

Install

Windows

1. Download the latest .exe file from the release page.
2. Follow the steps in the installer.
3. Run the application from your Dekstop or Start Menu.

Linux

1. Ensure your distribution supports AppImages.
2. Download the latest .AppImage file from the releage page.
3. Double click the file to run the application.

MacOS

1. Download the latest .dmg file from the release page.
2. Double click the file and drag it into your Applications folder.
3. Run it from your Applications folder or Launchpad.

Warning

While I try my best to support MacOS, I don't personally own any Apple devices. I test it occasionally on borrowed hardware, but please be patient if you encounter any issues.

Build and contribute

Running the app

This repository uses uv to manage Python dependencies. Once installed, you can use:

uv sync # installs Python and dependencies
uv run tacty # run the app

Production builds

For the production build we use pyside6-deploy which makes use of Nuitka to compile Python code to C for better efficiency.

uv run pyside6-deploy -c ./pysidedeploy-windows.spec # windows build
uv run pyside6-deploy -c ./pysidedeploy-linux.spec # linux build

This produces the directory dist/tacty.dist, which includes all required files for the current platform. To bunde these we use the Inno Setup Installer for Windows and appimagetool for Linux. More information can be found by looking at .github/workflows/release.yml.

Contributing

As of now, pull requests are not enabled. This is due to university rules around the fact that this is my BSc. thesis, which requires all code to be mine. After submitting the thesis they will be opened.