This repository has been archived by the owner. It is now read-only.
Emotiv EPOC Headset External for Max/MSP
Max C++
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
max
osx/EmotivNullDriver.kext/Contents
COMPILE.asciidoc
ChangeLog.txt
LICENSE.txt
LICENSE_GPL.txt
README.asciidoc
gpl.txt
np_epoc.flext.cpp
package.txt

README.asciidoc

np_epoc Max/MSP and Pd External

THIS PROJECT IS NO LONGER MAINTAINED

The code last commit on this project was in 2011, and both Max and the EPOC have changed quite a bit since then. I no longer have the resources nor hardware to continue maintenance of this project. The code is left here for archival purposes, but the repo is now readonly.

If someone decides to fork and restart this project, please let me know and I will add a reference to that repository.

Description

np_epoc is an external for either Max/MSP or Puredata to receive information from the Emotiv EPOC EEG. It should work with the Consumer, Research, and Special Edition EPOCs.

EPOC communication via Emokit:

Portability of source between Max and Pd is available thanks to flext

Emotiv EPOC Information

More information about the Emotiv EPOC can be found at

Installation

  • Put the .mxo(Mac)/.mxe(Windows) or .pd_[platform] file in a directory that Max/Pd will search for externals (Max: Options → File Preferences → Other Folders, Pd: Options → Paths)

  • Max: Put the .help (Max4) or .maxhelp (Max5) file in the max-help directory of your Max/MSP installation

Platform Specifics Issues

OS X

You will need to install the EmotivNullDriver.kext on OS X for software to be able to access the EPOC. To do this, copy the osx/EmotivNullDriver.kext directory to /System/Library/Extensions/. Once this is done, reboot.

This will blacklist the emotiv from the HID Manager so it can be read by Emokit. No telling what this will do in conjunction with the Emotiv OS X drivers, I haven’t tested that yet.

Licensing

np_epoc is covered under the GPL License due to Flext. If you can unwind it from flext somehow, consider it BSD.

np_epoc, Copyright 2010-2011 Kyle Machulis/Nonpolynomial Labs

flext source code are covered under the GPL v2 License. np_mindset is BSD, but since it’s based on flext, it’s GPL.

flext - C++ layer for Max/MSP and pd (pure data) externals
Copyright (C) 2001-2005 Thomas Grill

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 2
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, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

In the official flext distribution, the GNU General Public License is
in the file gpl.txt
--------------------