Software modules to setup BCI experiments
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

This repo provides several software modules you can use to setup your own BCI experiments. We use these modules in our own experimental setups at Motorlab and we are releasing them so you can get a head start and not have to build your own modules from scratch which would take a long time.


  1. Install Dragonfly

  2. Several of the python modules require numpy, scipy, matplotlib and traits. The easist way to get these modules is to install Enthought's EPD_Free. You can find an installer for your operating system here (Note: EPD Free has been replaced with Canopy Express. It may work but we haven't switched to using it officially yet)

  3. Install PyQt from here. You need py2.7 version and make sure you install the one that matches your python build (32-bit or 64-bit)

  4. On Linux, scripts in tools folder use screen so make sure you have it installed (sudo apt-get install screen)



Clone the repository and set the following environment variables in a permanent place like .bashrc and make sure you export them:

  • Set BCI_ROOT to the where you placed your BCI folder
  • Set BCI_INCLUDE to ${BCI_ROOT}/message_definitions
  • Set BCI_COMMON to ${BCI_ROOT}/modules/Common
  • Set BCI_MODULES to ${BCI_ROOT}/modules
  • Set BCI_CONFIG to ${BCI_ROOT}/app_configs
  • Set BCI_DATA to ${BCI_ROOT}/data
  • Append ${BCI_INCLUDE} and ${BCI_COMMON}/python to PYTHONPATH environment variable

For reference, see in tools folder.


Use the installer which will also set all the necessary environment variables.

After Installation

To play with the example configuration in ${BCI_ROOT}/app_configs, run the following scripts from ${BCI_ROOT}/tools in the order shown below. Note that scripts for windows have .bat extensions while scripts for linux have .sh extensions

  1. start_message_manager
  2. start_quick_logger
  3. start_watcher
  4. start_app_starter
  5. start_appman_gui

When Appman GUI window pops up, select the configuration for your system, click START and the virtual experiment will start running.