← All projects
BCI/EEGIn progress

NeuroClient

An independent Rust client for the Emotiv Cortex v2 API, with a terminal dashboard and a Lab Streaming Layer bridge for real-time EEG.

RustEmotiv CortexEEG/BiosensorsLSLratatui
NeuroClient screenshot

A Rust workspace for working with Emotiv EEG headsets through the Cortex v2 WebSocket API.

  • neuroclient is a typed, asynchronous client library covering sessions, authentication and all nine data streams. Subscriptions return per-stream results, so a partial failure is visible instead of hidden in raw JSON.
  • neuroclient-tui is a ratatui terminal dashboard for real-time EEG and biosensor data. It can stream to Lab Streaming Layer (LSL) with self-describing channel metadata, for use in neuroscience pipelines. Windows binaries ship on GitHub Releases; other platforms build from source.

Formerly emotiv-cortex-rs

The project started as emotiv-cortex-rs, published as emotiv-cortex-v2. That package is frozen at 0.3.4. NeuroClient picks up from 0.4.0, and the repository includes a 0.3 to 0.4 migration guide.

How it's kept honest

  • CI denies all Clippy warnings, including pedantic lints, and enforces a test-coverage floor that only ever ratchets up.
  • cargo audit and cargo deny run on every pull request and gate releases.
  • Tests assert that tokens, client secrets and biosignal samples never reach log output.
  • End-to-end hardware testing has used an Emotiv Insight headset. Other models follow the documented protocol but haven't been validated on a device.

NeuroClient is independent and not affiliated with or endorsed by Emotiv, Inc. Dual-licensed MIT/Apache 2.0.