Streaming to a computer (LSL)#
Lab Streaming Layer (LSL) lets recording and analysis software on a computer receive
the live signal from a streaming headset over your local network. Tools that consume it
include LabRecorder, MNE-LSL, OpenViBE, BCI2000, MATLAB, and Python via pylsl. The
outlet is controlled from the Live signal viewer at More → Output → LSL outlet.
Turning the outlet on#
The LSL outlet is off by default — nothing is published to the network until you opt in. To turn it on, open the viewer, tap More → Output, and switch on LSL outlet. The choice is remembered for next time.
Warning
Switching the outlet on publishes that headset’s raw EEG to every LSL client on the network you are joined to, for as long as it streams — any client on that network can pick it up. Keep it off on shared or public networks, and turn it on only when you need it.
What is advertised#
While the outlet is on, the headset advertises a single stream that follows the BrainAccess Board LSL contract v1 — the same layout BrainAccess Board publishes (see LSL contract in the Board manual), so Board, LabRecorder, pyxdf and MNE read it without any BrainAccess-specific code.
Property |
Value |
|---|---|
Stream name |
|
Source ID |
The headset’s Bluetooth name, for example |
Type |
|
Sample rate |
The configured rate |
Sample format |
64-bit float |
Channels, in this order |
1. your active EEG channels; 2. one |
Types and units |
EEG: type |
Header: identity |
Manufacturer (Neurotechnology), model and exact hardware generation, the headset’s serial number, firmware and hardware versions, the app version ( |
Header: montage |
Reference and ground electrodes, the cap (name and 10-05 label scheme), the configured gain and bias, and per electrode the standard 10-05 position and the electrode hardware (dry, gold-plated, pad or pins) |
Header: other |
|
Note
The stream name, source ID and header carry the headset’s name, serial number and firmware version. Anyone on the network who can see the stream can read them.
Requirements#
The phone and the computer must be on the same Wi-Fi network / LAN, and that network must allow multicast and direct connections between clients (many guest and captive networks block this).
Keep the app running. Streaming continues with the screen off while the ongoing notification is present.
Data pushed to LSL is the raw signal — display filters do not apply.
Notes#
Each headset advertises its own name and serial number, so several headsets — even of the same model — are told apart by the stream name or source ID, and a stream can be traced to the physical headset from another computer.
Recorders reconnect by themselves. LSL recorders such as LabRecorder reconnect to a stream that comes back with the same name, source ID and channels, and keep writing the same file. The name and source ID come from the headset, so they never change; the app also keeps the channels whenever it can: stopping and starting the stream, running a contact check and returning to the stream, reconnecting the headset after a dropout and streaming again, and switching the outlet off and on all bring back the same stream. Closing and reopening the app brings back the same stream too. Changing the channel set in Config makes a different stream — start a new recording on the computer after that.
If sending to LSL fails, the app drops that packet and keeps the outlet. If it keeps failing, the app restarts the outlet with the same name, source ID and settings and tells you; the computer’s recording has a gap of about two seconds while it reconnects. Only if the restart also fails is the outlet switched off. A failure never changes your LSL outlet setting.
If the network drops out, receivers pause and resume when it returns. If a receiver stops getting data, toggle LSL outlet off and on again.
See also#
Live signal viewer — where the LSL outlet switch lives.
Connect a headset — bring a headset online before it can stream.
Recording — recordings also store the raw, unfiltered signal on the phone.