Building From Source

This guide will cover how to make changes (bug fixes + more API integrations) to Lab Remote and compile using Visual Studio. If you don't have any changes to implement, it is highly recommended to download the latest pre-compiled version from the Releases page.

Trial Status Messages

The status message that pops up is generated by a separate executable, GaMATrialStatus.exe, generated from GaMATrialStatus.py and compiled using the pyinstaller (not included). It was written and tested in python 3.8 and requires the external python library pyxdf to open and parse xdf files.

Run pip install pyxdf pyinstaller to install these libraries.

Editing & Compiling GaMATrialStatus.py

The python script is set up to print status strings to stdout, which is then read by Lab Remote and used to update the status window. The current implementation tries to open the file for 10 seconds, then gives up.

Once you've completed your changes to GaMATrialStatus.py, run pyinstaller --onefile GaMATrialStatus.py from the command line. The complete executable can then be found in the dist directory. Move this executable to the root folder for Lab Remote.

To ensure it works, run GaMATrialStatus.exe test.xdf from the command line, and you should see your expected status message.