Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

OpenBCI framework

OpenBCI is a platform for Brain Computer Interfaces. This software contains tools which allow you to build a complete Brain Computer Interface based on EEG, and perform some experiments collecting EEG and other biomedical data signals.

These tools are:

  • tools for communication with some EEG hardware (TMSi, Braintronics, and openEEG)
  • tools for displaying and storing the EEG (and other biomedical time series) signal
  • tools for creating "bindings" or "use scenarios" for some 3rd party software for performing psychological experiments (e-prime, psychopy, visionEGG). This means, that if you prepare an experiment in some of mentioned software, you will be able to perform this experiment, and store the EEG data, with necessary tags using OpenBCI.


From packages

On certain Ubuntu versions OpenBCI can be installed from packages available at

From git

Download OpenBCI source code:

$ cd ~
$ git clone

Now run script to configure OpenBCI locally. When asked, answer 'y' to install binaries inside ~/bin directory:

$ cd ~/openbci/scripts
$ ./obci_local activate ../../openbci

Running OpenBCI from source requires globally installed Azuk-Multiplexer and may require amplifier drivers. It's highly recommended to install this software from precompiled packages available at


Following programs are available from command line:

  • obci - main OpenBCI script
  • obci_gui - OpenBCI scenario selector GUI
  • obci_tray - tray application
  • obci_local - script for configuring local copy of OpenBCI (can be used to configure OpenBCI when openbci-core package is not installed)


OpenBCI is licensed under the terms of the GNU GPL version 3.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see