Skip to content
Go to file

Latest commit


Git stats


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

Measuring Brainwaves

GitHub version

This is my project for Advanced Authentic Research (AAR). Follow the progress of this project on my blog. This project uses emokit which is an open source driver used to access the Emotiv Device raw data.

Extracting the Raw Data

  1. Download the repository
$ git clone
  1. Plug in your Emotiv's USB dongle.

  2. Find the Serial Number of the Emotiv by downloading HIDAPI.

$ git clone
$ cd hidapi
  1. In the HIDAPI go to the directory that corresponds to your operating system and run:
$ make -f Makefile-manual
  1. A hidtest file should be created in the same directory. Open the hidtest to run it. On linux, you must run this using sudo.

  2. The output should be a list of devices that are connected to the computer. Look at the Emotiv device information and copy the Serial Number.

  3. In the brianwaves project, go to the emokit directory.

$ cd emokit/python/emokit
  1. Open "" and paste the serial number on line 361 where it says:
  1. Run the "" file.
$ python
  1. If there are any dependencies that need to be installed used the "pip" command.
$ sudo pip install [missing dependency goes here]
  1. Install all dependencies until the following error is produced:
Traceback (most recent call last):
  File "", line 674, in <module>
  File "", line 432, in setup
  File "", line 537, in setup_darwin
    hidraw = hid.device(0x21a1, 0x0001)
  File "hid.pyx", line 45, in hid.device.__cinit__ (hid.c:1280)
  1. Turn on the Emotiv and try again. A succesful output should be printed:

These electrodes in the picture above represent certain parts of the brain shown here:

Displaying Data on an iOS Device

After extracting the Emotiv data, I sent the data as a JSON file to a local server. Then, I created an iOS app and used Alamofire to get request the data from the server. I created the app so that it would display the raw data on the iOS device. Here is what it looks like so far:

You can’t perform that action at this time.