Qt Installation (All platforms)

For all platforms, download Qt. Choose version 5.9.7. Newer code has been tested with version 5.12.2.

Tips:

1. Make sure you download the opensource version.
2. Make sure to install the compiler options for your platform (see below).
3. Make sure to install Qt Creator (recommended).
4. Make sure to install sources and debugging information for Qt (recommended).

Platform-specific instructions

Linux (Ubuntu)

Most of the code has been tested in Ubuntu 18.04. Newer code has been tested in 20.04. Both versions should work and are supported.

Install the following packages:

1. sudo apt-get install git (to pull the Trodes repo from Bitbucket)

2. sudo apt-get install chrpath (used during the build + installation process)

3. sudo apt-get install mesa-common-dev libglu1-mesa-dev. (Note that this may not actually be necessary; if you are using a graphics card and installed its driver, then OpenGL is probably set up already. Many manufacturers such as Nvidia have implemented OpenGL for their hardware, so installing the appropriate driver will pull in the necessary dependencies).

4. sudo apt-get install libpulse-dev (needed for audio)

5. sudo apt-get install libgstreamer-plugins-base0.10-0 (optional, for camera module)

Mac

1. Install Homebrew. Then execute brew install git

2. Go to Apple's developer website. Search for Xcode. Download and install that as well as Xcode Command Line Tools. Then from the top menu, Xcode->Preferences->Locations. Select the appropriate kit for the Command Line Tools.

Windows

1. Recommended: Select mingw32. This will install a shell that sets up the Qt build environment, so you won't have to worry about adding qmake to a PATH environment variable.

2. Alternatively, you can install one of the msvc pre-built packages if you really want 64 bit, but you will have to do some additional things to get Trodes to compile. Don't worry, it's not terribly difficult to do. It's mostly changing variable length arrays to conform to the features that the Microsoft C++ compiler will support. Next, install the Microsoft Visual Studio version that matches the Qt package version you selected (example: install Qt msvc2017 and then Microsoft Visual Studio Community 2017). We also recommend you install Qt's jom executable to parallelize the compilation process.