Muse Port is an interface device that allows streaming of the data collected by Interaxon's brainwave-sensing Muse headband (http://www.choosemuse.com/) directly into Ableton Live. Five brainwave frequencies, three axes of accelerometer data, blink and jaw clench detection can all be graphed in real time along with your midi and audio recordings, as well as mapped to control any Live parameter.
To begin, get your headband connected via bluetooth and install the SDK available at https://sites.google.com/a/interaxon.ca/muse-developer-site/home. Don't worry about Muse Player or Muse Lab, Muse Port needs a UDP connection so just go to a command prompt and enter
muse-io --device-search Muse --osc osc.udp://localhost:5000 --preset 14 --dsp
As long as you haven't changed the name of your headband from the default 'Muse' and UDP port 5000 is available, data will be streaming into Muse Port once this goes through.
The current UDP port, remaining battery life and the connection quality of the four sensors are all displayed in the top portion of the device. If there are one or more flashing circles in the headband-shaped icon, adjust the Muse on your head until all four sensors are reading well.
Mouse over any of the numbered outputs along the bottom and a popup window will appear which displays a graph of the data streaming through it. Click along the wire leading to the numbered output to hold this popup in place. You may now select options in the popup itself.
Brainwave readings from the four sensors of the Muse can either be averaged as they arrive in the device or the highest can be used and the rest discarded.
Sometimes it can be useful to hone the range of the incoming data, in order to magnify its effect. If selected, the device will monitor readings and use only the highest and lowest it's seen to set the limits of the data stream, rather than the absolute full range of the sensor. The duration of this monitored history can be set via the Memory Span control in the settings.
Clicking and dragging anywhere else in the popup will change the scaling of the graph. Click again on the wire to allow the popup to close.
If you click on one of the numbered outputs itself a menu will appear. This menu displays all of the current mappings. Click 'Map New...' and then click on any enabled parameter anywhere in Live and it will be remote controlled by the data leaving the output. You can simultaneously map to up to four parameters per output. After a mapping has been assigned, you can click on its name in this menu to disconnect and remove it.
Any of the data outputs may also be mapped through the main audio channel of the device itself. Click on the triangle-shaped input on the left and a menu will appear which lists all of the available connections.
Alternatively, you may also map the actual audio signal passing through the device to any parameter you wish by clicking on the triangle-shaped output on the right.
Click on the Muse Port logo to open up the settings menu.
For parameters with Hone Range selected, the device will look this many seconds into the past when determining the limits of its output range.
Unlimited Memory Span
The Memory Span will be as long as the time from when this, or the individual parameter's Hone Range control was selected.
The most convenient way to record Muse data in Live is to automate the parameter in question, thereby graphing it right along with your audio or MIDI recording in the arrangement view track. However, this unconventional strategy has its drawbacks. Namely the undo history will be compromised as it will perpetually fill while recording, which can be quite resource intensive both in terms of RAM and disk usage. Use with caution.
Included in this download is a small companion device which generates midi notes based on an input stream. So for example, you could hone the range of the Relative Y-Axis Position output and send it to the Midi Generator to create a beat by nodding your head. Click here for the full description: https://sellfy.com/p/ns3f/.
These are Max for Live devices. They require Ableton Live 9.1 Suite or newer and at least a trial of Max/MSP 6.1 or newer, which can be downloaded from http://cycling74.com/downloads/. Older versions of Live and/or Max may work just as well, but there are no guarantees.
I'm always glad to hear feedback on my work! Please send any questions, issues or feature requests to [email protected] And if you make something cool with one of my devices I'd really like to hear it! If you want I can do what I can to send some traffic to it, especially if it's on soundcloud. Mine's https://soundcloud.com/to_the_sun.
Version 1.2 beta
Dear Muse Port patrons,
Since getting this device into working order, I've been using it while playing music to empirically search for correlations between recognizable brain wave signatures and things like steady rhythm, etc.. That being said, it wasn't until last week that I noticed that a new version of the SDK (SDKv3.0.x, see https://sites.google.com/a/interaxon.ca/muse-developer-site/release-notes/ ) has been available for about a month. The changes they made to the osc paths in this new version will render the Muse Port as you bought it inoperable. I've thrown together a version which will work with the latest SDK, and will also take advantage of some of the new measurements they added, such as absolute vs. relative brainwaves, as well as Concentration and Mellow scores (see https://sites.google.com/a/interaxon.ca/muse-developer-site/museio/osc-paths/osc-paths---v3-6-0#TOC-Experimental/ ).
This Version 1.2 is also included in this download as a separate file.
Please be aware that this version is strictly beta; you may notice a funky thing here or there, but all the original functionality should be intact. In addition if you click on the Muse Port logo you will see that streaming data (and therefore mapping it) must be turned on and is not on by default. Note that the five standard brainwaves report absolute values, whereas before they reported relative session values, and now there are five separate relative brainwave parameters which can be automated (graphed). The two experimental scores Concentration and Mellow can also be automated, and since version 1.2, they can be streamed in real time and therefore mapped to any parameter in Live. In the device they have taken the place of the 3rd and 5th outputs along the bottom. Previously these were the Alpha and Gamma outputs, from which Mellow and Concentration are derived, respectively. If you're savvy with Max for Live, you can access the data that is Retained In History by using a [coll ii-history] object; this is how I've been doing my experimentation.
Of course if you want to use the Muse Port version you purchased, you can always just install the old SDK (which is included in this download) and use it with that. If you have any questions please feel free to ask!
To the Sun