Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Neurosky Mindstream - System tray app to stream EEG data
Java Shell
tree: e3ae3541e5

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


# Author: Eric Blue
# 	url   =
#   email = ericblue76 (at) gmail (dot) com
# Project: Neurosky Mindstream - System tray app to stream EEG data 


Mindstream is a simple java-based system tray app that streams EEG brainwave data from NeuroSky 
devices (MindWave,MindSet).  The app interfaces to NeuroSky devices using the ThinkGear Socket 
protocol (connecting on localhost:13854), retrieves data in JSON Format, and can "stream" to 
other applications.  Mindstream can save the following data:

	* Focus levels 
		- attention
		- meditation
	* EEG values
		- delta
		- theta
		- lowAlpha
		- highAlpha
		- lowBeta
		- highBeta
		- lowGamma
		- highGamma
	* Headset signal strength
		- poorSignalLevel

Streaming functions will include:

    * Saving EEG data to a CSV File
    * Listen on a socket and replay data from localhost:13854 
    	- allowing other applications to connect
    * Broadcast to a URL - supporting POST/M-POST and streaming real-time data
    	- future use? Processing Javascript version of the Neurosky BrainWave Visualizer

Currently there is no installer.  You can download the source and/or binary distribution:
the primary executable (mindstream.jar) is located in the dist directory.  There are 
helper scripts to execute loading the app ( for Linux/Mac and mindstream.bat
for Windows).  Both scripts simply execute ( java -Djava.ext.dirs=lib -jar dist/mindstream.jar).
[Current Status]

- Alpha state
- Streaming only supports writing to a CSV file
- Tested on Linux and Windows with Java 1.6 and the MindWave headset

[Change Log]

- 07/24/11 - (v1.0) Initial release
- 12/04/11 - (v1.01) Fixed issue reported with saving CSV file (Thanks to Pei Yin) and added some exception handling messages
Something went wrong with that request. Please try again.