hemokit

Haskell library and tool suite for the Emotiv Epoc EEG, inspired by the Emokit code.

It currently only works on Linux and Windows - patches for other platforms are welcome, they should be trivial.

Download

Hemokit comes with example programs to

Note that we have to use sudo in most of the cases because the HIDAP-hidraw implementation reads directly from a device file.

hemokit-dump can print EEG data, format it as JSON, serve it via TCP or Websockets, and read from real devices and dump files.

Output EEG cumulative state for an automatically found device:
```
sudo hemokit-dump
```
Select one of many connected EEGs by serial number:
```
sudo hemokit-dump --serial SN...GM
```
Output only the data the device sends (no cumulative state), and format the output as JSON:
```
sudo hemokit-dump --mode packets --format json
```
The --format flag allows you to change the way the output is printed. The output of --mode state --format spaced is especially easy to work with.
Instead of from a real device, read data recorded to a file, and serve it via JSON over a TCP server on port 1234:
```
sudo cat /dev/hidraw1 > encrypted.dump  # Dump data to a file
sudo hemokit-dump --from-file encrypted.dump --serial SN...GM --serve 0.0.0.0:1234 --format json
```
Here you have to specify the serial since HIDAPI is not used to obtain it automatically.

If you prefer a Websockets server over a raw TCP server, use ws://0.0.0.0:1234 instead.
Output decrypted raw data to stdout:
```
sudo hemokit-dump --mode raw
```
Both print the data from the EEG and store the original data for later use:
```
sudo cat /dev/hidraw1 | tee >(hemokit-dump --from-file - --serial SN...GM --format json) > encrypted.dump
```
We use tee and shell process substitution to duplicate the data stream, and tell hemokit-dump to read from - (stdin).