/Think-Tank

Train your concentration by controlling tanks with your mind!

Primary LanguageC#

Unity Muse Headband Muse Research Tools

Think Tank

alt icon

Train your concentration and lose yourself in this immersive telepathic co-op tank game!

Last updated November 5, 2017.
Working in Unity 2017.2.0f3.
Tested on Mac OS X Sierra Version 10.12.6
Requires Muse headband 2014 model, Muse-IO is not supported by Muse headband 2016.

Built With

  • Unity - Game engine and IDE for creating games!
  • Muse Headband - Brain sensing headband with electroencephalography (EEG) sensors.
  • Muse Research Tools - Muse-IO and Muse Lab for receiving and passing sensor data.

Minimum Requirements

  • Two 2014 Muse headbands (no icon on power switch)
  • Bluetooth for communicating with Muse headband

Getting Started

Download and Install Tools

Download and install the Muse SDK and Research Tools from here.

Setup Muse Listener

Turn on the Muse headbands by holding the power button until the LEDs are blinking (about 6 sec) and pair the headbands with your computer via bluetooth.

In terminal, head to the directory of your muse-io command line tool.
On a Mac, this is typically in Applications/Muse.
Run this command to start listening for data from your Muse headband:

muse-io --osc osc.tcp://127.0.0.1:5000 --device Muse-XXXX

Replace XXXX with the unique ID of your Muse headband. You can find this ID in the name of the headband when connecting to bluetooth.

Do this again with the other Muse headband, except replace the port "5000" with "5001". Your command will look like this (XXXX is the other device ID):

muse-io --osc osc.tcp://127.0.0.1:5001 --device Muse-XXXX

Visualize and Filter Data in Muse Lab

Open Muse Lab. On a Mac, you will find it at Applications/Muse/MuseLab.app

Select "OSC" in the dropdown menu in the top left.
Click on the "Incoming" tab.
Open a new TCP port at 5000.
Click on the "Outgoing" tab.
Add a new UDP port at 5005.

Select the following two channels in the box that appears to send the data:

  • /muse/elements/experimental/concentration
  • /muse/elements/jaw_clench

Open a new window of Muse Lab (this time navigate to the folder and open MuseLab.jar) and repeat the same steps.
The incoming TCP port is at 5001.
The outgoing UDP port is at 5006.


You can visualize the incoming data from either Muse by selecting "Visualizers" in the dropdown menu in the top left and creating a new Scrolling Line Graph.

Begin Game

Open Think Tank in Unity.
Open the "Main" scene in Scenes/Main.scene.
Press play and begin using the Muse headbands to control the tank!

The first Muse headband will control the movement of the tank.
Focus and concentrate to move the tank forward and clench your jaw to turn the tank clockwise.
The second Muse headband will control the gun of the tank.
Focus and concentrate to charge the weapon and clench your jaw to release the projectile.

Troubleshooting

If you can't find the ID of your Muse headband, run this command from the directory of your muse-io command line tool.

muse-io

This will automatically setup a listener on the default TCP port and tell you the ID of your Muse.

To be able to use multiple Muse headbands at once, you must manually input the target port and device ID.