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.
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
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
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.
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 Copyright and GPL License
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 --------------------