Skip to content
This repository has been archived by the owner on Feb 15, 2018. It is now read-only.

qdot/np_epoc

Repository files navigation

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
--------------------

About

Emotiv EPOC Headset External for Max/MSP

Resources

License

Unknown, GPL-2.0 licenses found

Licenses found

Unknown
LICENSE.txt
GPL-2.0
LICENSE_GPL.txt

Stars

Watchers

Forks

Packages

No packages published