Release Notes

    June 22, 2015: LibMuse-iOS 1.2.1

    Bug fix release.
    • Changes:
      • Fixed a bug that caused apps to get stuck in an infinite reconnect loop when a device went out of and back into range two or more times.
      • Fixed an issue where the notch frequency was not being properly set for European regions.
      • Fixed a couple of rare edge cases (one on a zero-length read from the OS, and the other on being notified of a Muse accessory being removed without first being added.)
      • Improved documentation in the example app.

    May 29, 2015: LibMuse for Android 1.3.0 and LibMuse for iOS 1.2.0

    This release contains 2 breaking changes, however both are minor.

    • Changes in both iOS and Android:
      • macAddress parameter was removed from addConfiguration method in Muse File Writer, because it's already a part of MuseConfiguration data struct (breaking change).
      • MuseFileWriterFactory was renamed to MuseFileFactory and 2 methods were added to it: for MuseFileReader creation and MuseFile creation (breaking change).
      • Added MuseFileReader, which will allow to read and playback muse files. There is a simple example on how to use in both Android and iOS example app. Look for playMuseFile method.
      • MuseFile interface was changed.
    • LibMuse for iOS:
      • ibmuse for iOS is distributed as a static library (libMuse.a file + Headers) and not as dynamic framework. This will allow you to support ios devices >= 7.0 and it should resolve code signing warning. See example App build settings for details on how to use libMuse.a in your project
      • minimum deployment target on iOS is 7.0 now
    • LibMuse for Android:
      • Fixed MuseFileWriter behaviour: now if file exists FileWriter will append new data at the end, before it erased the old data

    May 7, 2015: LibMuse for Android 1.2.1

    • Added for x86 architecture (it was not included in 1.2.0)
    • Properly populated batteryPercentRemaining in MuseConfiguration class
    • Changed type for batteryPercentRemaining from int to double
    • Improved documentation for getMuseConfiguration() and getMuseVersion() methods

    April 30, 2015: LibMuse for iOS 1.1.0 and LibMuse for Android 1.2.0

    • LibMuse for iOS:
      • support x86 architecture (allows to compile application with libmuse for iphonesimulator)
    • LibMuse for Android:
      • added FileWriter API
      • added Mellow and Concentrations packets
      • removed rename API from Muse class

    April 29, 2015: LibMuse for iOS 1.0.1

    •  Set IPHONEOS_DEPLOYMENT_TARGET to 8.0, as App store rejects applications with dynamic frameworks < 8.0

    April 28, 2015: LibMuse for iOS 1.0.0 

          First release! Features include:
    • Raw data: EEG, accelerometer, DRL/REF, Battery 
    • DSP data: jaw clench, eye blink, relative and absolute band powers, session score, mellow (experimental), concentration (experimental).
    • Muse Bluetooth connection handling
    • Works out of the box in Xcode

    March 18, 2015: LibMuse for Android 1.0.4 

    • Fixed minor issue in recovery mechanism in case of data error
    • Improved error logging in case of data error
    • Libmuse now notifies headband about host platform on every connect (this improves user experience if same headband is used on multiple devices with different apps)

    March 2, 2015: LibMuse for Android 1.0.2 

    • Fixed segfault which could happen onDestroy().
    • Reduced disconnection detection to 2.5 sec (was > 10 sec).
    • Methods connect(), execute() and runAsynchronously() do not throw exceptions anymore. Exceptions are properly handled inside the SDK.
    • Improved documentation 
    • Improved error handling.

    February 6, 2015: SDK Tools v3.4.1 & LibMuse for Android 1.0.1 

    MuseSDK broken into two components

      • MuseSDK separated into SDK Tools (MuseIO, MusePlayer, MuseLab) and LibMuse

      LibMuse for Android 1.0.1

      • Better error handling
      • Documentation improvements (added information about threading and exceptions)
      • Link C++ lib statically
      • Added new API to MuseManager class to allow to scan for Muse headbands which have custom names
      • Split libmuse and MuseSDK installers
      • Provided linux-x64 installer

      February 3, 2015: SDK Tools v3.4.0 

      LibMuse for Android 1.0.0

      January 30, 2015: SDK Tools v3.2.3 

      A quick release to help our Linux users...

        MuseIO 3.6.5

        • Linux - Bug fix to fix 100% CPU usage. 
        • Muse Elements - Fix to better detect "headband on".

        December 23, 2014: SDK Tools v3.2.2 

        Happy Holidays! This is a bug fix release of the SDK. 


        Muse-player 1.8.4

        • Fixed a hang at end of input when using OSC input (the file would complete processing, but at the end muse-player would sit there forever)
        • Fixed an occasional hang on Windows with Muse file input
        • Fixed control-C showing an exception
        • Fixed bug in MATLAB output for /muse/elements
        • Fixed crash with Unicode in MATLAB(HDF5) files
        • Only print output when stdout is a terminal, useful when running Muse-Player in the background

        Muse-IO 3.6.4

        • Fixed bug on Windows where 50hz/60hz EMI filter command-line option did not work

        December 17, 2014: SDK Tools v3.2.0 

        MusePlayer 1.8.0

        1) The MATLAB output format has been converted to Matlab File Format 7.3, which is form of HDF5. If you simply load the MATLAB output in MATLAB itself, you will not see or experience any difference from the previous MATLAB files we generated. However, this new format will allow your non-MATLAB programs(Python, C++, Java, etc) to easily parse the MATLAB file. In Python for example, you can simply import h5py and read the file, for example:

        import h5py
        # Load a file that has been saved as MATLAB from muse-player
        f = h5py.File('museplayer-matlab-output.mat','r')
        # “f” basically becomes a tree data structure at this point.
        # To show all the possible keys in the data structure:
        # Example of how to get all the raw EEG data

        2) Added the ability to do regular expression (regex) filtering when using the -i option. Examples:
        # Get the theta values for all 4 channels:
        muse-player -i '/muse/elements/.\*theta.\*'

        3) Added --version argument
        4) Better error message if port is in use
        5) Bug fixes

        Known issues: In MusePlayer for Linux, MATLAB output is not working for this release. 

        MuseLab 1.6.3

        Bug fix: Fixed horseshoe not working
        Bug fix: Muse-IO timestamps cause all messages to be annotations. Currently timestamps will be ignored when saving.

        MuseIO 3.6.3

        Bug fixes

        Nov 17, 2014: SDK Tools v3.0.2

        • MuseIO 3.6.2
          • Added back --dsp option for backward compatibility.
        • MuseLab 1.6.2
          • Fixed version number.
        • MusePlayer 1.6.0
          • No changes

        November 14, 2014: SDK Tools v3.0.1 

        • Installer
          • One click install! Removed all extra installation steps for muse-player. 
        • MusePlayer 1.6.0
          • Changes made to allow for all-in-one installer.
        • MuseIO 3.6.1
          • Added new algorithm for EEG band power session score.  This metric compares your current alpha/beta/etc against your historical average for that band. 
          • Added experimental algorithms "concentration" and "mellow". See documentation here.
          • dsp option is enabled by default now, use --no-dsp if you want to disable it. --dsp option is not present anymore (note: it was added back in the next release)
          • The paths are now considered a stable API.  Anything new that is in progress will be put into the /muse/experimental section first before it becomes part of the supported API.
        • MuseLab 1.6.2 (on release, this was incorrectly marked as 1.7.0)
          • Bug fix: Can't change EEG signal trace color
          • Bug fix: Horseshoe indicator not working
        • Misc
          • Revamp of documentation on the wiki. 

        August 12, 2014: SDK Tools v2.4.2 

        • Muse-Player 1.4.2
          • Fixed crash on Windows

        July 31, 2014: SDK Tools v2.4.0 

        • Muse-Player 1.4.0
          • Ability to play back huge files (8+ hours) - files are loaded incrementally now instead of completely loaded into memory at the start. 
          • Ability to record for long period of time (8+ hours) - files are incrementally saved instead of being written all at once at the end of the recording. 
          • Fixed bugs when piping output from display through "less".

        July 4, 2014: SDK Tools v2.2.0 

        • Added support for Linux
        • Installer
          • Brand new installer that makes the install process a bit easier. 
            • All platforms: automatically install Java if it is not already installed.
            • All platforms: automatically set the path to include Muse install directory.
            • Windows: Automatically install required Microsoft library without having to click through more dialog boxes.
          • New icons and graphics.
        • MuseIO 3.4.0
          • Renamed /muse/dsp/bandpowers to /muse/dsp/elements
          • Changed all double outputs to floats.  This only occurred in the dsp paths.
          • In the channel layout, LCH and RCH have been renamed MUSE_LEFT_AUX and MUSE_RIGHT_AUX. These values have been added to the Muse protobuf file format. 
          • Bug fix:
            • Layout channel names T9 and T10 were incorrectly labelled, they should be TP9 and TP10.
        • MusePlayer 1.2.0
          • Added ability to output CSV
          • Automatically do "as-fast-as-possible" when writing files.
          • Added ability to filter data.
          • Added ability to auto-skip gaps in data 
          • Added handling of DSP data from MuseIO
          • Bug fixes:
            • Fixed crash when using the --osc-timestamp with MuseIO
        • MuseLab 1.6.1
          • Bug fix: When recording from six channel Muse, only 4 channels were recorded. Fixed. 
        • Known Issues:
          • Muse-Player by default can only receive and transmit UDP messages, so you must change MuseIO and MuseLab accordingly.  On MuseIO, this would mean doing:
            • "muse-io --osc osc.udp://localhost:5000"

          June 24, 2014: SDK Tools v2.0.0

          • MuseIO 3.2.0
            • The first version of Muse Elements - our basic DSP package for developers:
              • Blink event
              • Jaw Clench event
              • Relative band powers for each channel: alpha, beta, gamma, theta, delta, and low frequencies
              • FFT for each channel
              • Proper fit indicator for each channel
              • Data quality indicator for each channel
            • Aligned MuseIO OSC messages and Muse file format v2.
            • TCP support
          • MuseLab 1.6.0
            • Headset indicator to indicate proper fit
            • Battery level indicator
            • Added support for TCP connections 
            • Recorded sessions now record to Muse file format version 2.
            • Stationary line graph improvements:
              • Allow user to mark ranges on the stationary line graph
              • Display title
              • Display legend
              • Ability to hide grid lines
              • Ability to choose number of grid lines
              • Exponential magnify area of line graph
              • Adjust position of magnification
              • Override master time 
            • Minor improvements
              • Individual changes to time in a visualizer are now loaded from config file
              • OSC incoming messages now have a right/left scrollbar
              • Position and strength are now saved for static line graph
          • MusePlayer 1.0.0
            • Supported inputs:
              • OSC network stream
              • OSC-replay file format
              • Muse file format v1
              • Muse file format v2
            • Supported outputs:
              • OSC network stream
              • OSC-replay file format
              • Muse file format v2
              • MATLAB
              • Print to screen
            • Options:
              • As fast as possible
          • OSC tools
            • "oscdump" and "oscsend" have been integrated into the installer for convenience

          April 10, 2014: SDK Tools v1.0 

          Our first release, containing the following:
          • MuseIO 3.0.0
          • MuseLab 1.4.0
          Supported platforms: Windows, MacOS