Skip to content

skyler-murray/Epoc.js

 
 

Repository files navigation

JavaScript framework for the Emotiv EPOC [WIP]

This framework provides an interface to access data from the Emotiv EPOC brain sensor using Node.js.

To use this framework, you're gonna need an EPOC / EPOC+ or Insight that you can buy here.

Originally based on the epocutils library by @StephaneAG

Status:

  • Refactored to use latest SDK (v3.5.0).

  • Cognitive actions should now be working.

How to Install

  • Download the Emotiv Community SDK v3.4.0 here and copy the edk.framework file (community-sdk > lib > Mac > edk.framework) to /Library/Frameworks (on Mac).

  • Either clone this repo and run

  npm install

or just run:

  npm install epocjs

How to Use

When writing a program, use either the connectToEmoComposer or connectToLiveData function to use the emulator or the data coming from the device.

Example of simple program:

  var Epoc = require('epocjs')();

  Epoc.connectToLiveData("<path to your profile file>", function(event){
    if(event.smile > 0){
      console.log('smiling')
    }
  })

or:

  var Epoc = require('epocjs')();

  Epoc.connectToEmoComposer(function(event){
    if(event.smile > 0){
      console.log('smiling')
    }
  })

The path to your user file should be something like this /Users/< username >/Library/Application Support/Emotiv/Profiles/< filename >.emu

Events


Smile

If the value is superior to 0, the headset is detecting that the user is smiling.

  if(event.smile > 0){
    // do something
  }

Looking Up / Down / Left / Right

The headset can detect the direction in which the user is looking:

  if(event.lookingUp > 0){
    // do something
  }

  if(event.lookingDown > 0){
    // do something
  }

  if(event.lookingLeft > 0){
    // do something
  }

  if(event.lookingRight > 0){
    // do something
  }

Blink

Detect if the user blinked:

  if(event.blink > 0){
    // do something
  }

Winking Left / Right

The headset can detect if the user is winking:

  if(event.winkingLeft > 0){
    // do something
  }

  if(event.winkingRight > 0){
    // do something
  }

Laugh

Detect if the user is laughing:

  if(event.laugh > 0){
    // do something
  }

Gyroscope

Detect changes in gyroscope data:

  if(event.gyroX){
    // do something
  }

  if(event.gyroX){
    // do something
  }

Cognitive Actions

Actions available:

  • push
  • pull
  • lift
  • drop
  • left
  • right
  • rotate left
  • rotate right
  • rotate clockwise
  • rotate counter clockwise
  • rotate reverse
  • disappear
  switch(cognitivAction){
    case 2:
      console.log('push')
      break;
    case 4:
      console.log('pull')
      break;
    case 8:
      console.log('lift')
      break;
    case 16:
      console.log('drop')
      break;
    case 32:
      console.log('left')
      break;
    case 64:
      console.log('right')
      break;
    case 128:
      console.log('rotate left')
      break;
    case 256:
      console.log('rotate right')
      break;
    case 512:
      console.log('rotate clockwise')
      break;
    case 1024:
      console.log('rotate counter clockwise')
      break;
    case 2048:
      console.log('rotate forwards')
      break;
    case 4096:
      console.log('rotate reverse')
      break;
    case 8192:
      console.log('disappear')
      break;
  }

Special Thanks

Thanks to Cam Swords for his help :)

License

Licensed under the MIT license.

About

Node.js addon for the Emotiv C++ SDK

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 42.8%
  • C++ 28.3%
  • Python 15.4%
  • Makefile 13.4%
  • JavaScript 0.1%