***
*** Teachmaster 5 on Linux (64 bit) ***
***

This document describes how to run Teachmaster on Linux Ubuntu.

Name of the executable file: teachmaster5

***
*** Step 1: Install SQLite database client library ***
***

Teachmaster uses the database "SQLite". If the necessary database library
is missing, you get the following error message:

Database error
Can not load SQLite client library "libsqlite3.so". Check your installation.

In order to install the necessary database library, enter on the command line:

sudo apt install libsqlite3-dev

***
*** Step 2 (optional): Install libcanberra ***
***

"libcanberra" is a library for generating event sounds. If the library
is missing and you start Teachmaster on a command line, you get a
warning like this:

Gtk-Message: 20:54:18.981: Failed to load module "canberra-gtk-module"

In order to install the libcanberra library, enter on the command line:

sudo apt install libcanberra-gtk-module

***
*** Step 3 (optional): Install audio library bass ***
***

Teachmaster uses the audio library "bass" for playing sounds. You have
to make sure that this library is installed if you want to play sounds.
If you don't want to play sounds, Teachmaster runs fine without having
this library installed.

You can download the audio library "bass" here:
http://www.un4seen.com/download.php?bass24-linux

Assuming you have unpacked the zip file in the directory "Downloads"
within your home directory, you have to enter the following four commands
on the command line:

cd ~/Downloads/bass24-linux/libs/x86_64/
sudo cp libbass.so /usr/local/lib
sudo chmod a+rx /usr/local/lib/libbass.so
sudo ldconfig

Explanation:

Line 1: go to the directory with the 64 bit library
Line 2: copy the library file to the lib directory
Line 3: make the library file readable and executable
Line 4: update the shared libraries information

***
*** Additional information ***
***

If the following error occurs

./teachmaster5: error while loading shared libraries:
libgdk-x11-2.0.so.0: cannot open shared object file: No such file or directory

you are probably using KDE or other GUI toolkits but not GTK.
With the command

sudo apt install libgtk2.0-0

you can install GTK additionally.

***
*** Stefan Meyer ***
*** stefan@teachmaster.de ***
***
