# Release Notes

## Cortex 4.8.39 - Feb 2026

* Bug fixes

## Cortex 4.8.32 - Jan 2026

* Support Firmware version 0.1.6.0 of MW20

## Cortex 4.8.24 -  Dec 2025

* Bug fixes and improvements for Cloud synchronization.

## Cortex 4.8.19 -  Nov 2025

* Support MN8 (since firmware version 0x27) and Flex headset on Ubuntu.

## Cortex 4.8.16 -  Oct 2025

* Support key simulation on EmotivBCI
* Add more explanation on error message when `exportRecord` fails.

## Cortex 4.8.10 -  Oct 2025

* Mental Command Sensitivity improvement,
* Bug fixes

## Cortex 4.8.8 -  Sep 2025

* Fix issue some users cannot download records from LABS to EmotivPRO.

## Cortex 4.8.0 -  Jul 2025

* Upgrade the core framework for BLE connection (Qt 6.8.3)
* Some minor bug fixes

## Cortex 4.7.11 -  Jul 2025

* Improve API error explanation.

## Cortex 4.7.10 -  Jun 2025

* Support marketing banner (internally).

## Cortex 4.7.3 -  May 2025

* Fix some cloud synchronization bugs related to records/subjects.

## Cortex 4.6.1 -  Mar 2025

* Hot fix MacOS security policy update.

## Cortex 4.6.0 -  Mar 2025

* Support for new EpocX firmware 740 with updated encryption method for improved security.

## Cortex 4.5.7 -  Feb 2025

* Hot fix for an issue related to the new developer license

## Cortex 4.5.6 -  Jan 2025

* Support the new developer license (for Consumer headsets)
* Bug fixes

## Cortex 4.5.3 -  Jan 2025

* Support MW20 headset (beta support, internal use only)
* Bug fixes

## Cortex 4.4.7 -  Dec 2024

* Data synchronization improvement: download records from latest to oldest

## Cortex 4.4.5 -  Nov 2024

* Bug fixes for data synchronization issue

## Cortex 4.4.2 -  Oct 2024

* Bug fixes for data synchronization issue, unexpected empty record issue
* Interpolate CQ data for MN8 when there is data lost

## Cortex 4.3.15 -  Sep 2024

* Hot fix for authentication issue on LABS/Builder webapp.

## Cortex 4.3.14 -  Sep 2024

* Authentication flow improvement

## Cortex 4.3.7 -  Aug 2024

* Bug fixes

## Cortex 4.3.5 -  Aug 2024

* Support upgrade firmware of Flex 2 via native Bluetooth connection

## Cortex 4.3.3 -  Jul 2024

* Improve firmware upgrading

## Cortex 4.3.0 - Jun 2024

* Support data sharing of organization
* Support Flex 2 via native Bluetooth connection
* Bug fixes

## Cortex 4.2.7 - Jun 2024

* Bug fix for extender firmware upgrade (from very old version)

## Cortex 4.2.4 - May 2024

* A hotfix for marker issue

## Cortex 4.2.1 - Apr 2024

* Cortex API usage tracking

## Cortex 4.2.0 - Apr 2024

* Time synchronization between different Emotiv headsets

## Cortex 3.8.0 - Jan 2024

* Support firmware version x2F06 of Flex headset.

## Cortex 3.7.8 - Jan 2024

* Improve headset setting feature for Flex
* Bug fixes

## Cortex 3.7.5 - Jan 2024

* Support EDF+/BDF+ file format, see [exportRecord](https://emotiv.gitbook.io/cortex-api/records/exportrecord) API.
* Bug fixes

## Cortex 3.7.2 - Dec 2023

* Improve timestamp algorithm for Flex.
* Bug fixes

## Cortex 3.7.1 - Nov 2023

* Update new certificate of the Cortex web socket server. The certificate before version 3.7.1 expires on Dec 9, 2023.
* Bug fixes

## Cortex 3.7.0 - Nov 2023

* Support Flex
* Upgrade the core framework for BLE connection.
* Upgrade to OpenSSL 3.0, TLS 1.2
* Improve data quality
* New device scanning workflow (see controlDevice with "refresh" command mentioned [here](https://emotiv.gitbook.io/cortex-api/headset/controldevice)).
* Performance enhancement and minor bug fixes

## Cortex 3.6.5 - Aug 2023

* Training profiles are now supported for only specific types of Emotiv headset. All training profiles created before 3.6.5 will become readonly profiles. 
  * See [Readonly training profile](https://emotiv.gitbook.io/cortex-api/bci/readonly-profile).
  * See new update on [queryProfile](https://emotiv.gitbook.io/cortex-api/bci/queryprofile) API.
* Bug fixes

## Cortex 3.5.6 - Jul 2023

* Attention detection will replace Focus detection
* Focus detection can still be found via `exportRecord` API with `includeDeprecatedPM` option.

## Cortex 3.5.5 - Jun 2023

* Save more data into database, even there is no record.

## Cortex 3.5.4 - Jun 2023

* Update export policy on EmotivPRO with records from EmotivPRO mobile.

## Cortex 3.5.3 - May 2023

* Support Xtrodes devices on EmotivPRO

## Cortex 3.5.2 - Apr 2023

* Roll back the core framework for BLE connection (since the new version in 3.5.0/3.5.1 is not really stable).
* Bug fixes

## Cortex 3.5.1 - March 2023

* Hotfix for BTLE connection.

## Cortex 3.5.0 - March 2023

* Improve timestamp correction algorithm.
* exportRecord() API will also export survey data in CSV format (along with JSON format).
* Upgrade the core framework for BLE connection.

## Cortex 3.4.2 - October 2022

* New system requirement on Raspberry Pi:
  * Raspberry Pi OS - Debian version 11 (Beta release, 32-bit)

## Cortex 3.4.1 - September 2022

* New system requirement on MacOS/Windows:
  * Windows 10 (64-bit) v1809+
  * macOS 10.14 Mojave or above

## Cortex 3.2 - January 2022

* Support the new [Insight 2.0](https://www.emotiv.com/insight/) headset

## Cortex 3.1.3 - December 2021

* Support macOS 12.1

## Cortex 3.1.1, 3.1.2 - December 2021

* Bug fixes on some instances where the database cannot be initialised properly

## Cortex 3.1 - December 2021

* New method added [syncWithHeadsetClock](https://emotiv.gitbook.io/cortex-api/headset/syncwithheadsetclock)

## Cortex 3.0.1 - November 2021

* No change in the Cortex API
* Bug fixes, make the Bluetooth connection more stable

## Cortex 3.0 - October 2021

* No change in the Cortex API
* EMOTIV App is now called [EMOTIV Launcher](https://emotiv.gitbook.io/emotiv-launcher/)
* Cortex 3.0 is not compatible with Windows 8. See the [system requirements](https://app.gitbook.com/@emotiv/s/system-requirements/cortex-api).

## Cortex 2.7.3 - August 2021

* Fixed the scaled value from Interest / Valance that may go out of range in some cases.
* Fixed Focus / Stress performance metrics with EPOC X.

## Cortex 2.7.2 - July 2021

* No change in the Cortex API

## Cortex 2.7.1 - May 2021

* It is now possible to run all the detections with an EPOC Flex headset. This requires a specific EEG sensor mapping. See [Data Subscription](https://emotiv.gitbook.io/cortex-api/data-subscription) for details.
* Cortex is now available for Raspberry Pi OS

Check the [Getting Started](https://emotiv.gitbook.io/cortex-api/master) page to see all the supported headsets and platforms.

## Cortex 2.7.0 - April 2021

* New data stream "eq" to get the EEG quality. See [Data sample object](https://emotiv.gitbook.io/cortex-api/data-subscription/data-sample-object#eeg-quality). Please read this [page](https://emotiv.gitbook.io/cortex-manual/setting_up_your_eeg_device/view_contact_quality_map/contact-quality-cq-vs.-eeg-quality-eq) to understand the difference between the contact quality and the EEG quality.
* New label "BatteryPercent" added to the "dev" data stream. See [Data sample object](https://emotiv.gitbook.io/cortex-api/data-subscription/data-sample-object#device-information).
* The method [exportRecord](https://emotiv.gitbook.io/cortex-api/records/exportrecord) is now available on iOS and Android

## Cortex 2.6.4 - March 2021

* Bug fixes
* No change in the Cortex API

## Cortex 2.6.3 - January 2021

* New parameters added to the method [exportRecord](https://emotiv.gitbook.io/cortex-api/records/exportrecord)
* New parameters added to the method [queryRecords](https://emotiv.gitbook.io/cortex-api/records/queryrecords)
* Cortex is now available for Linux Ubuntu (Beta release)

Check the [Getting Started](https://emotiv.gitbook.io/cortex-api/master) page to see all the supported headsets and platforms.

## Cortex 2.6.2 - December 2020

* Solve an issue on macOS 11, where EMOTIV headsets couldn't connect by Bluetooth.
* No change in the Cortex API

## Cortex 2.6.1 - November 2020

* No change in the Cortex API

## Cortex 2.6.0 - September 2020

* The sample rate of the data stream "dev" is now 2 hertz. See [Data Subscription](https://emotiv.gitbook.io/cortex-api/data-subscription) for details.
* macOS 10.12 Sierra is not supported anymore. In order to install Cortex 2.6.0 you must upgrade your Mac to macOS 10.13 High Sierra or above.

Check the [Getting Started](https://emotiv.gitbook.io/cortex-api/master) page to see all the supported headsets and platforms.

## Cortex 2.5.0 - June 2020

* Support the new [MN8](https://www.emotiv.com/workplace-wellness-safety-and-productivity-mn8/) headset
* Support for iOS and Android (Beta release, see the [announcement](https://www.emotiv.com/blog/beta-release-of-cortex-mobile/) for details)
* New parameter **title** added to the method [updateRecord](https://emotiv.gitbook.io/cortex-api/records/updaterecord)
* In the method [queryRecords](https://emotiv.gitbook.io/cortex-api/records/queryrecords), you can now order the records by their **applicationId**.
* New [warning](https://emotiv.gitbook.io/cortex-api/warning-objects) code 112 and 113 

Check the [Getting Started](https://emotiv.gitbook.io/cortex-api/master) page to see all the supported headsets and platforms.

## Cortex 2.4.0 - March 2020

* Support the new [EPOC X](https://www.emotiv.com/epoc-x/) headset
* New field **headbandPosition** added in the [Headset object](https://emotiv.gitbook.io/cortex-api/headset/headset-object) and the [Record object](https://emotiv.gitbook.io/cortex-api/records/record-object) (EPOC X only)
* New method added [updateHeadsetCustomInfo](https://emotiv.gitbook.io/cortex-api/headset/updateheadsetcustominfo) to set the position of the headband (EPOC X only)
* New field **customName** added in the [Headset object](https://emotiv.gitbook.io/cortex-api/headset/headset-object)
* Change in the result of the method [updateHeadset](https://emotiv.gitbook.io/cortex-api/headset/updateheadset), new [warning](https://emotiv.gitbook.io/cortex-api/warning-objects) added to get the result of this method
* New label **overall** in the device information [sample object](https://emotiv.gitbook.io/cortex-api/data-subscription/data-sample-object#device-information)

## Cortex 2.3.0 - December 2019

* New parameter **includeFlexMappings** added to the method [queryHeadsets](https://emotiv.gitbook.io/cortex-api/headset/queryheadsets)
* New field **lastLoginTime** added in the result of the method [getUserLogin](https://emotiv.gitbook.io/cortex-api/authentication/getuserlogin)

## Cortex 2.2.1- October 2019

* New method added [configOptOut](https://emotiv.gitbook.io/cortex-api/records/configoptout)
* New parameter **connectionType** added to the method [controlDevice](https://emotiv.gitbook.io/cortex-api/headset/controldevice)
* New parameter **experimentId** added to the method [createRecord](https://emotiv.gitbook.io/cortex-api/records/createrecord)
* New [Warning](https://emotiv.gitbook.io/cortex-api/warning-objects) added when the available space on the hard drive is too low
* New [Warning](https://emotiv.gitbook.io/cortex-api/warning-objects) added when the opt-out configuration changes
* New label **isActive** in the performance metrics [sample object](https://emotiv.gitbook.io/cortex-api/data-subscription/data-sample-object#performance-metric)

## Cortex 2.2.0 - September 2019

This version didn't introduce any change in the API.

## Cortex 2.1.1 - August 2019

* New method added [exportRecord](https://emotiv.gitbook.io/cortex-api/records/exportrecord)

## Cortex 2.1.0 - August 2019

* New methods added to manage the [Subjects](https://emotiv.gitbook.io/cortex-api/subjects)

## Changes from Cortex 1.x to Cortex V2.0

There are significant changes from Cortex API version 1.x to 2.0.

### WebSocket URL

To connect to Cortex 1.x, you used the url **wss\://emotivcortex.com:54321**\
In Cortex 2.0, you must use **wss\://localhost:6868**

See [Connecting to the Cortex API](https://emotiv.gitbook.io/cortex-api/connecting-to-the-cortex-api) for details.

### Authentication

In Cortex 2.0, the user must login with EmotivID through the EMOTIV App. So, the API doesn't have a **login** or **logout** method anymore.

Third party applications must be approved by the user before using the Cortex API. See the new method [requestAccess](https://emotiv.gitbook.io/cortex-api/authentication/requestaccess).

The method [authorize](https://emotiv.gitbook.io/cortex-api/authentication/authorize) doesn't accept "anonymous mode" anymore. You must provide a client id and client secret.

See [Authentication](https://emotiv.gitbook.io/cortex-api/authentication) for details.

### Headsets

Call the method [controlDevice](https://emotiv.gitbook.io/cortex-api/headset/controldevice) to connect a headset to Cortex. If the headset is not connected, then you can't create a session with this headset.

See [Headsets](https://emotiv.gitbook.io/cortex-api/headset) for details.

### Miscellaneous

Some methods have been removed or renamed.

| Method name in v1       | Equivalent in v2                                                                                                                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| login, logout           | See [getUserLogin](https://emotiv.gitbook.io/cortex-api/authentication/getuserlogin)                                                                                                                         |
| acceptLicense           | The user must accept the EULA in EMOTIV App. You can call [getUserInformation](https://emotiv.gitbook.io/cortex-api/authentication/getuserinformation) to check if the user already accepted the EULA or not |
| controlBluetoothHeadset | See [controlDevice](https://emotiv.gitbook.io/cortex-api/headset/controldevice)                                                                                                                              |
| updateNote              | See [updateRecord](https://emotiv.gitbook.io/cortex-api/records/updaterecord)                                                                                                                                |

The parameters and result format of some methods have changed. If you get an error when calling a method, please check its documentation.