Installation Guide

Gestro is designed to be used on Linux PCs running the Ubuntu distribution. In particular, it was tested and found to be running perfectly on PCs running Ubuntu 18.04 LTS.

Prerequisites

• A PC running Ubuntu.
• A webcam.

Gestro requires the following tools and libraries to run (other versions are not tested):

• X11
• Qt 5
• OpenCV 4.5.5
• libasound2-dev
• Google Unit Test FrameWork

These required tools and libraries will be installed if you follow step 2 of the installation instructions below.

Installation Instructions

If permission is denied while trying to run any of the scripts, please enter the following Commands into the terminal and try running the script again, sudo chmod +x <script_name>.sh. For example, for the install_dependencies.sh, enter sudo chmod +x install_dependencies.sh into the terminal. 1. Download the latest release from our Github and extract the contents into the Home folder.

Note: Make sure the folder with the contents is named “Gestro”. If not, rename it to “Gestro”. Alternatively, launch a terminal and run:

git clone https://github.com/RandomGuy-coder/Gestro.git

2. Launch a terminal and enter the following commands into it to install the requirements:

cd ~/Gestro
sudo ./install_dependencies.sh

Note: If CMake version is found to be too low, please follow instructions here to update CMake. After updating CMake, make sure to close and reopen the terminal before starting from step 2 again.

3. Enter the following commands into the terminal to run the build script.

sudo chmod +x build.sh && sudo ./build.sh

If any of the following errors occured: >

This application failed to start because it could not find or load the Qt platform plugin "xcb" in "".

/usr/lib/qt5/bin/uic: error while loading shared libraries: libdouble-conversion.so.1: cannot open shared object file: No such file or directory

1. Run this command in the terminal:

   sudo apt-get install libxcb-xinerama0
   

   If the previous command said that libxcb-xinerama0 is already installed or the newest version, run this:

   sudo apt install --reinstall libxcb-xinerama0
   

2. Then, run this command:

   sudo apt install --reinstall libdouble-conversion1
   

3. Now, close and relaunch the terminal, then run the following commands:

   cd ~/Gestro && sudo ./build.sh