Getting Started

This documentation contains guidance for developing applications with EMOTIV Cortex - the core piece of technology at EMOTIV which brings the brain computer interface to consumer.

The intended audience is anyone with some programming skills who wants to develop a third party application that interacts with an EMOTIV headset.

The Cortex API is built on JSON and WebSockets, making it easy to access from a variety of programming languages and platforms.

This documentation is for Cortex version 2.0 or above. It is not valid for Cortex version 1.x

Supported platforms

Currently, Cortex is supported on the following platforms:

  • Windows 10 v1607+ (64-bit only)

  • macOS 10.11 or above

Upcoming support will be added for the following platforms:

  • Windows 8.1 (64-bit only)

  • iOS

  • Android

  • Linux Ubuntu

You can download the latest version of Cortex on the EMOTIV website.

Cortex is not supported on Windows 7. Microsoft will end the support for Windows 7 in January 2020.

Supported headsets

Currently the following headsets are supported by Cortex:

Model

Firmware

Connection

EPOC

All

USB dongle

EPOC+

All

USB dongle, BTLE 4.0

EPOC Flex

All

USB dongle

Insight

All

USB dongle, BTLE 4.0

USB dongle refers to the USB receiver that comes with EPOC+. If you need additional one you can purchase it from the EMOTIV store.

Prerequisites

Create an EmotivID

As with other EMOTIV services, you are required to have an EmotivID account. You can create one on www.emotiv.com.

Create a Cortex App

You need to create the application ID and generate the corresponding client ID and client secret for your application in order to grant access to Cortex API.

  1. Login to www.emotiv.com

  2. Go to My Account Dashboard (https://www.emotiv.com/my-account/).

  3. Select Cortex Apps.

  4. Read the Developers EULA carefully and hit Accept only if you agree to all the terms and conditions. You cannot develop an application that works with Cortex if you do not agree to all of the terms.

  5. Type in the name of your new application - an application ID will be generated automatically in the form of com.{your-username}.{application-name}. Note that the app ID string must contain only alphanumeric characters (A-Z, a-z, 0-9), hyphens (-), and periods (.).

  6. Hit Register Application. A client ID and a client secret will be presented to you. Copy them to somewhere safe immediately as the client secret will ONLY BE SHOWN ONCE ON THIS SCREEN FOR SECURITY. If you lost it afterward you will have to generate a new application ID.

License

With a valid EmotivID you can already access to the basic data streams such as:

  • Motion data

  • Mental Commands

  • Facial Expressions

  • Performance Metrics (low-resolution, 0.1Hz)

  • Frequency bands

  • Contact quality

  • Battery level

A paid subscription will be required for data streams such as:

  • EEG data

  • Performance Metrics (high-resolution, 2Hz)

Visit https://www.emotiv.com/developer/ for more details.

The Cortex examples

To help you getting started with your application, EMOTIV provides basic examples in various programming languages. There are open source and hosted by Github at https://github.com/Emotiv/cortex-v2-example‚Äč

If you have difficulty with the Cortex API, you can also open an issue on this Github repository.

Next step

If you are upgrading your application from Cortex 1.x to Cortex 2.x, then please be aware that the Cortex API has significantly changed. Please read Changes from V1.x to V2.0.

If you are new to the Cortex API, then please start with Connecting to the Cortex API.