node package manager
We need your input. Help make JavaScript better: Take the 2017 JavaScript Ecosystem survey »


Cylon.js For Neurosky Mindwave Mobile

Cylon.js ( is a JavaScript framework for robotics, physical computing, and the Internet of Things (IoT).

This repository contains the Cylon.js adaptor/driver for the Neurosky Mindwave Mobile EEG (

Want to use Ruby on robots? Check out our sister project Artoo (

Want to use the Go programming language to power your robots? Check out our sister project Gobot (

Build Status Code Climate Test Coverage

How to Install

$ npm install cylon cylon-neurosky

How to Use

This example displays the Attention and Meditation data reading sent by the Mindwave Headset:

var Cylon = require('cylon');
  connections: {
    neurosky: { adaptor: 'neurosky', port: '/dev/rfcomm0' }
  devices: {
    headset: { driver: 'neurosky' }
  work: function(my) {
    my.headset.on('attention', function(data) {"attention:" + data);
    my.headset.on('meditation', function(data) {"meditation:" + data);

How to Connect


In order to allow Cylon.js running on your Mac to access the Mindwave, go to "Bluetooth > Open Bluetooth Preferences > Sharing Setup" and make sure that "Bluetooth Sharing" is checked.


Connecting to the Mindwave from Ubuntu or any other Linux-based OS can be done entirely from the command line using Gort commands. Here are the steps:

Find the address of the Mindwave, by using:

$ gort scan bluetooth

Pair to Mindwave using this command (substituting the actual address of your Mindwave):

$ gort bluetooth pair <address>

Connect to the Mindwave using this command (substituting the actual address of your Mindwave):

$ gort bluetooth connect <address>


You should be able to pair your Mindwave using your normal system tray applet for Bluetooth, and then connect to the COM port that is bound to the device, such as COM3.


We're busy adding documentation to Please check there as we continue to work on Cylon.js.

Thank you!


For our contribution guidelines, please go to .

Release History

For the release history, please go to .


Copyright (c) 2013-2015 The Hybrid Group. Licensed under the Apache 2.0 license.