KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

python-emotiv

★ 134 Open GitHub ↗

A Python module to access Emotiv EPOC EEG headset on Linux.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Emotiv EPOC Python Interface
============================

Unmaintained as of January 2015
-------------

**Please do not e-mail me for questions about this project. I no longer develop it,
nor test or use it on Emotiv devices. I don't work in this field anymore. Thanks!**

python-emotiv is an open-source library to acquire data from Emotiv EPOC headset.
Although Emotiv recently provided 32-bit SDK for Linux, we have chosen
to use the reverse-engineered protocol as the code will be finally deployed
on a Raspberry Pi or BeagleBone Black ARM box.

The library uses libusb to detect and access the dongle instead of hidapi. The
udev rules create a /dev/emotiv\_epoc symlink in /dev tree, if you want to
directly read from that node, pass method="direct" when you create your EPOC
object.

Parts of the project are inspired from
[mushu](https://github.com/venthur/mushu) and
[emokit](https://github.com/openyou/emokit) which is the pioneer of the
reverse-engineered protocol.

Dependencies
============

* [pyusb](http://sourceforge.net/projects/pyusb) (Version >= 1.0)
* [pycrypto](https://www.dlitz.net/software/pycrypto)
* numpy
* scipy
* matplotlib (For data analysis scripts under utils/)
* BeagleBone Black GPIO (For SSVEP BCI in examples/)

[labstreaminglayer](https://code.google.com/p/labstreaminglayer)
================================================================

"labstreaminglayer is a system for the unified collection of measurement time series
in research experiments and handles both the networking, time-synchronization,
(near-) real-time access as well as optionally the centralized collection,
viewing and disk recording of the data."

python-emotiv has preliminary support in lsl/ folder to stream Emotiv EEG signals to
labstreaminglayer nodes.

Saving your data
================

utils.py contains a save_as_matlab() function to export the acquired signals
as a MATLAB file. This function saves the EEG data according to the
[FieldTrip](http://fieldtrip.fcdonders.nl)
specification to ease the process of analysing signals with FieldTrip.

Installation
============

Just run ```python setup.py install``` to install the module on your system.

Testing
=======

When you run emotiv/epoc.py as a standalone application, it will dump sensor data
to the terminal:

![Terminal screenshot](https://raw.github.com/ozancaglayan/python-emotiv/master/doc/sc_console.png)

Authors
=======

Ozan Çağlayan, Galatasaray University, Computer Engineering Dept.

python-emotiv

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README