# Release Notes ## Cortex 4.8.47 - Apr 2026 * Bug fixes ## Cortex 4.8.44 - Apr 2026 * Bug fixes ## 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](/cortex-api/records/exportrecord.md) 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](/cortex-api/headset/controldevice.md)). * 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](/cortex-api/bci/readonly-profile.md). * See new update on [queryProfile](/cortex-api/bci/queryprofile.md) 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](/cortex-api/headset/syncwithheadsetclock.md) ## 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](/cortex-api/data-subscription.md) for details. * Cortex is now available for Raspberry Pi OS Check the [Getting Started](/cortex-api/master.md) 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](/cortex-api/data-subscription/data-sample-object.md#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](/cortex-api/data-subscription/data-sample-object.md#device-information). * The method [exportRecord](/cortex-api/records/exportrecord.md) 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](/cortex-api/records/exportrecord.md) * New parameters added to the method [queryRecords](/cortex-api/records/queryrecords.md) * Cortex is now available for Linux Ubuntu (Beta release) Check the [Getting Started](/cortex-api/master.md) 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](/cortex-api/data-subscription.md) 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](/cortex-api/master.md) 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](/cortex-api/records/updaterecord.md) * In the method [queryRecords](/cortex-api/records/queryrecords.md), you can now order the records by their **applicationId**. * New [warning](/cortex-api/warning-objects.md) code 112 and 113 Check the [Getting Started](/cortex-api/master.md) 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](/cortex-api/headset/headset-object.md) and the [Record object](/cortex-api/records/record-object.md) (EPOC X only) * New method added [updateHeadsetCustomInfo](/cortex-api/headset/updateheadsetcustominfo.md) to set the position of the headband (EPOC X only) * New field **customName** added in the [Headset object](/cortex-api/headset/headset-object.md) * Change in the result of the method [updateHeadset](/cortex-api/headset/updateheadset.md), new [warning](/cortex-api/warning-objects.md) added to get the result of this method * New label **overall** in the device information [sample object](/cortex-api/data-subscription/data-sample-object.md#device-information) ## Cortex 2.3.0 - December 2019 * New parameter **includeFlexMappings** added to the method [queryHeadsets](/cortex-api/headset/queryheadsets.md) * New field **lastLoginTime** added in the result of the method [getUserLogin](/cortex-api/authentication/getuserlogin.md) ## Cortex 2.2.1- October 2019 * New method added [configOptOut](/cortex-api/records/configoptout.md) * New parameter **connectionType** added to the method [controlDevice](/cortex-api/headset/controldevice.md) * New parameter **experimentId** added to the method [createRecord](/cortex-api/records/createrecord.md) * New [Warning](/cortex-api/warning-objects.md) added when the available space on the hard drive is too low * New [Warning](/cortex-api/warning-objects.md) added when the opt-out configuration changes * New label **isActive** in the performance metrics [sample object](/cortex-api/data-subscription/data-sample-object.md#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](/cortex-api/records/exportrecord.md) ## Cortex 2.1.0 - August 2019 * New methods added to manage the [Subjects](/cortex-api/subjects.md) ## 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](/cortex-api/connecting-to-the-cortex-api.md) 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](/cortex-api/authentication/requestaccess.md). The method [authorize](/cortex-api/authentication/authorize.md) doesn't accept "anonymous mode" anymore. You must provide a client id and client secret. See [Authentication](/cortex-api/authentication.md) for details. ### Headsets Call the method [controlDevice](/cortex-api/headset/controldevice.md) to connect a headset to Cortex. If the headset is not connected, then you can't create a session with this headset. See [Headsets](/cortex-api/headset.md) for details. ### Miscellaneous Some methods have been removed or renamed. | Method name in v1 | Equivalent in v2 | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | login, logout | See [getUserLogin](/cortex-api/authentication/getuserlogin.md) | | acceptLicense | The user must accept the EULA in EMOTIV App. You can call [getUserInformation](/cortex-api/authentication/getuserinformation.md) to check if the user already accepted the EULA or not | | controlBluetoothHeadset | See [controlDevice](/cortex-api/headset/controldevice.md) | | updateNote | See [updateRecord](/cortex-api/records/updaterecord.md) | The parameters and result format of some methods have changed. If you get an error when calling a method, please check its documentation. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://emotiv.gitbook.io/cortex-api/release-notes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.