opensoundcontrol

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #go #linux #docker #awesome #cli #awesome-list #vue #pytorch #openai #mcp

opensoundcontrol

(★ 32)

Open Sound Control (OSC) support with EMOTIV Brainwear

opensoundcontrol Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Emotiv Open Sound Control (OSC)

Here are guidelines and some examples to use OSC with EMOTIV Brainwear&reg;.

## Prerequisites

* [Download and install](https://www.emotiv.com/developer/) the EMOTIV App and EmotivBCI
* Get a EmotivBCI license from https://www.emotiv.com/emotiv-bci/osc/
* install python-osc: `pip install python-osc`

## How to receive data from EmotivBCI-OSC

1. Connect to an Emotiv headset on EmotivBCI with a training profile.

2. Go to **Open Sound Control (OSC)** tab in EmotivBCI, choose **Sending Mode**, add **IP** and **Port** number.

Choose **Data streams**, then Click **Start** button to start streaming.

## Emotiv OSC Packets Format

**Data Type** : float32 - 32-bit big-endian IEEE 754 floating point number

**OSC Packets** : The contents of an Emotiv OSC packet is an OSC Bundle with each of detection types output (Facial Expressions,  Mental Commands, Performance Metrics). An OSC bundle contains multiple **OSC Messages**, with each of messages is an action from the detection types.
				  
**OSC Address Patterns** :

```
/=== Facial Expressions - Eyes
Neutral:     /fac/eyeAct/neutral
Look left:   /fac/eyeAct/lookL
Look right:  /fac/eyeAct/lookR
Blink:       /fac/eyeAct/blink
Wink left:   /fac/eyeAct/winkL
Wink right:  /fac/eyeAct/winkR

/=== Facial Expressions - Upper Face
Neutral:       /fac/uAct/neutral
Furrow brows:  /fac/uAct/frown
Raise brows:   /fac/uAct/surprise

/=== Facial Expressions - LowerFace
Neutral:      /fac/lAct/neutral
Clench teeth: /fac/lAct/clench
Laugh:        /fac/lAct/laugh
Smile:        /fac/lAct/smile
Smirk left:   /fac/lAct/smirkLeft
Smirk right:  /fac/lAct/smirkRight

//=== Mental Commands
Neutral:                   /com/neutral
Push:                      /com/push
Pull:                      /com/pull
Left:                      /com/left
Right:                     /com/right
Lift:                      /com/lift
Drop:                      /com/drop
Roate left:                /com/rotateLeft
Rotate right:              /com/rotateRight
Rotate clock wise:         /com/rotateClockwise
Rotate counter clock wise: /com/rotateCounterClockwise
Rotate Forwards:           /com/rotateForwards
Rotate reverse:            /com/rotateReverse
Disappear:                 /com/disappear

//=== Performance Metrics
Attention:         /met/att
Interest:          /met/int
Relaxation:        /met/rel
Stress:            /met/str
Excitement:        /met/exc
Engagement:        /met/eng
VisualAttention:   /met/visualAttention
CognitiveStress:   /met/cognitiveStress
AuditoryAttention: /met/auditoryAttention
```

**Data Value Range**

Facial Expressions, Mental Commands and Performance Metrics actions have a default value range (0, 1)

Value : -1 is used for Performance Metrics when an action is inactive.

opensoundcontrol

opensoundcontrol Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

opensoundcontrol

opensoundcontrol Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README