Install staej on Ubuntu

Preparation

You are expected to have a working user interface as provided by the Ubuntu installer in normal installation. I've tested these instructions on a fresh installation of Ubuntu 18.04 "Bionic Beaver" from the official website. Note that it did now work on a Live boot. Note that it did not work for me on Ubuntu 18.04 for Windows 10 and probably wouldn't work on a Ubuntu Server installation either for the same reason. You may need the Ubuntu Media package, though in my testing there was no need to install it explicitly.

Installation

# Get the latest GTK3 and update the repos
sudo add-apt-repository ppa:gnome3-team/gnome3-staging
sudo add-apt-repository ppa:gnome3-team/gnome3
sudo apt update
sudo apt dist-upgrade

# Fetch other repo depends
sudo apt-get -y install libgtk-3-0 gir1.2-gtk-3.0 python3 python3-gi python3-gi-cairo gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad ipython3 python-gst-1.0

# Fetch python depends from the PIP
sudo apt-get -y install python3-pip
pip3 install peewee
sudo pip3 install matplotlib

# Fetch staej from the git repository
git clone https://github.com/DAud-IcI/staej.git

Configuration

There are 3 ways to set up staej ordered by quickest to most time consuming. Please pick whichever applies to you!

A - If you have a prepared staej distribution

You should have a staej.zip file that contains a staej folder. Assuming that you are in the folder containing this zip file.

mkdir -p ~/.config
unzip staej.zip -d ~/.config

B - If you have the staej.sqlite database file and the associated JIGSAWS distributions

mkdir -p ~/.config/staej/tasks
cp staej.sqlite ~/.config/staej
# ensure the file has read-write access: chmod +rw ~/.config/staej/staej.sqlite

Then copy the AVI files from the JIGSAWS archives to their respective folder in the ~/.config/staej/tasks/[task_name]/video/ structure, for example: ~/.config/staej/tasks/Knot_Tying/video/Knot_Tying_B001_capture1.avi

C - If you only have the official JIGSAWS files

See this command to learn about importing using enter-staej.py:

python3 enter-staej.py --help

If you want to import all three of the original JIGSAWS archives you can do it like this:

python3 enter-staej.py --db path_to_jigsaws/{Knot_Tying,Needle_Passing,Suturing}.zip

Execution

You can launch staej now. If you create a shortcut or launcher script, make sure the working directory is the staej folder before launching main.py

cd staej
python3 main.py

Screenshot of staej running in uncostumized Bionic Beaver