I have been successfully transmitting data from the OpenBCI GUI to Max/MSP via OSC with the Band Power and Average Band Power data types. I figured this out without too much trouble and have been creating interesting sonification patches reflective of the different brainwave types and channels. However, I am struggling to transmit the FFT data. I assume it's some syntax error with my OSC objects but I was hoping someone could help guide me through how this works. I know that I will end up with a large amount of data--125 bins per channel but when I transmit this data, I am almost entirely seeing empty bins.

[OSC-route /openbci/fft/ch0]
Should I be able to unpack the 125 bins from channel 0?
[unpack f f f f f f ...]

I might receive one channel of data with the read of something like "/bin124 0.01" in a message box but when I [pak] all of the bins into a message box, the "0.01" moves to the bin 0 string location as opposed to its original bin 124 location. Some channels have a few bins receiving data but again, almost entirely empty. I'm clearly missing something here with FFT data via OSC.

Thanks in advance for your help!

-S

@retiutut

I’m trying to run the GUI with Processing v4.4.10, but it’s not working.
Here are the errors that pop up:

I used to work with Processing 3.5.4, but it was crashing sometimes, so I wanted to update to see whether the problem could have been fixed.

Some details:

• Java environment has been updated.
• All the libraries of the Sketch have been copied into the Processing folder.
• Nothing change whether I run it as admin or not.
• I am on Windows 11.

Can someone help?

Thanks for the support!

#
# A fatal error has been detected by the Java Runtime Environment:
#
#  EXCEPTION_ACCESS_VIOLATION (0xc0000005) at pc=0x00007ffcc2bfc56c, pid=4916, tid=11172
#
# JRE version: OpenJDK Runtime Environment Temurin-17.0.6+10 (17.0.6+10) (build 17.0.6+10)
# Java VM: OpenJDK 64-Bit Server VM Temurin-17.0.6+10 (17.0.6+10, mixed mode, sharing, tiered, compressed oops, compressed class ptrs, g1 gc, windows-amd64)
# Problematic frame:
# C  [ig11icd64.dll+0x5fc56c]
#
# No core dump will be written. Minidumps are not enabled by default on client versions of Windows
#
# If you would like to submit a bug report, please visit:
#   https://github.com/adoptium/adoptium-support/issues
#

--------------- S U M M A R Y ------------

Command Line: -Djna.nosys=true -Djava.library.path=D:\Openbci\openbcigui_v6.0.0-beta.1_windows64\OpenBCI_GUI\lib OpenBCI_GUI

Host: Intel(R) Core(TM) i5-1035G1 CPU @ 1.00GHz, 8 cores, 11G, Windows 11 , 64 bit Build 22621 (10.0.22621.5415)
Time: Sun Sep 7 02:49:22 2025 Windows 11 , 64 bit Build 22621 (10.0.22621.5415) elapsed time: 349.273614 seconds (0d 0h 5m 49s)

--------------- T H R E A D ---------------

Current thread (0x0000021123fd6560): VMThread "VM Thread" [stack: 0x0000005161b00000,0x0000005161c00000] [id=11172]

Stack: [0x0000005161b00000,0x0000005161c00000], sp=0x0000005161bfe6b0, free space=1017k
Native frames: (J=compiled Java code, j=interpreted, Vv=VM code, C=native code)
C [ig11icd64.dll+0x5fc56c]

siginfo: EXCEPTION_ACCESS_VIOLATION (0xc0000005), reading address 0x00000000000357b8

Register to memory mapping:

RIP=0x00007ffcc2bfc56c ig11icd64.dll
RAX=0x000002113644fc88 points into unknown readable memory: 0x000000000097bb96 | 96 bb 97 00 00 00 00 00
RBX=0x000002113644faf0 points into unknown readable memory: 0x00000211254a4340 | 40 43 4a 25 11 02 00 00
RCX=0x000000000097b7a7 is an unknown value
RDX=0x000002112532cf80 points into unknown readable memory: 0x0000000000000000 | 00 00 00 00 00 00 00 00
RSP=0x0000005161bfe6b0 points into unknown readable memory: 0x00000211251d3590 | 90 35 1d 25 11 02 00 00
RBP=0x0000021136456c90 points into unknown readable memory: 0x00000211254a4340 | 40 43 4a 25 11 02 00 00
RSI=0x00000211364500c0 points into unknown readable memory: 0x0000021136456c90 | 90 6c 45 36 11 02 00 00
RDI=0x000002112b6a2e70 points into unknown readable memory: 0x0000000000000000 | 00 00 00 00 00 00 00 00
R8 =0x0000000000000014 is an unknown value
R9 =0x000002113644fbf8 points into unknown readable memory: 0x0000000000000000 | 00 00 00 00 00 00 00 00
R10=0x0 is NULL
R11=0x0000000000000246 is an unknown value
R12=0x000002112bb9a300 points into unknown readable memory: 0x0000000000040000 | 00 00 04 00 00 00 00 00
R13=0x0 is NULL
R14=0x0 is NULL
R15=0x0 is NULL

Registers:
RAX=0x000002113644fc88, RBX=0x000002113644faf0, RCX=0x000000000097b7a7, RDX=0x000002112532cf80
RSP=0x0000005161bfe6b0, RBP=0x0000021136456c90, RSI=0x00000211364500c0, RDI=0x000002112b6a2e70
R8 =0x0000000000000014, R9 =0x000002113644fbf8, R10=0x0000000000000000, R11=0x0000000000000246
R12=0x000002112bb9a300, R13=0x0000000000000000, R14=0x0000000000000000, R15=0x0000000000000000
RIP=0x00007ffcc2bfc56c, EFLAGS=0x0000000000010206

• sudo dmesg | grep FTDI returns the following:
  [171234.063004] usb 1-1: Manufacturer: FTDI
  [171234.087991] usbserial: USB Serial support registered for FTDI USB Serial Device
  [171234.088020] ftdi_sio 1-1:1.0: FTDI USB Serial Device converter detected
  [171234.089269] usb 1-1: FTDI USB Serial Device converter now attached to ttyUSB0

• I tried this method and made sure I am a member of the dialout group. However, launching GtkTerm and setting the port to dev/ttyUSB0 does not display any data (just a default blank screen).
  Any help is appreciated. Thanks!

  ControlPanel: Found Cyton Dongle on COM port: /dev/ttyUSB0
  Success: Host and Device on Channe. Using COM port: /dev/ttyUSB0
  [DEFAULT]: Attempting to Start Session...
  initButtonPressed: Calling initSystem() after next draw()
  OpenBCI_GUI: Start session. Calling initSystem().

  =================================================

  || INITIALIZING SYSTEM ||

  OpenBCI_GUI: Configuring Cyton Channel Count...
  Sending config string to board: c
  OpenBCI_GUI: Channel count set to 8
  "Arial" is not available, so another font will be used. Use PFont.list() to show available fonts.
  Unpacking to: /root/.cache/JNA/temp/libonnxruntime_x64.so
  Unpacking to: /root/.cache/JNA/temp/libonnxruntime_arm64.so
  java.lang.NullPointerException
  at java.base/java.util.Objects.requireNonNull(Objects.java:208)
  at java.base/java.nio.file.Files.copy(Files.java:3128)
  at brainflow.JarHelper.unpack_from_jar(JarHelper.java:31)
  at brainflow.MLModel.(MLModel.java:58)
  at OpenBCI_GUI$W_Focus.initBrainFlowMetric(OpenBCI_GUI.java:24885)
  at OpenBCI_GUI$W_Focus.(OpenBCI_GUI.java:24672)
  at OpenBCI_GUI.setupWidgets(OpenBCI_GUI.java:31736)
  at OpenBCI_GUI$WidgetManager.(OpenBCI_GUI.java:31826)
  at OpenBCI_GUI.initSystem(OpenBCI_GUI.java:849)
  at OpenBCI_GUI.systemInitSession(OpenBCI_GUI.java:1117)
  at OpenBCI_GUI.draw(OpenBCI_GUI.java:654)
  at processing.core.PApplet.handleDraw(PApplet.java:2094)
  at processing.opengl.PSurfaceJOGL$DrawListener.display(PSurfaceJOGL.java:840)
  at jogamp.opengl.GLDrawableHelper.displayImpl(GLDrawableHelper.java:692)
  at jogamp.opengl.GLDrawableHelper.display(GLDrawableHelper.java:674)
  at jogamp.opengl.GLAutoDrawableBase$2.run(GLAutoDrawableBase.java:443)
  at jogamp.opengl.GLDrawableHelper.invokeGLImpl(GLDrawableHelper.java:1293)
  at jogamp.opengl.GLDrawableHelper.invokeGL(GLDrawableHelper.java:1147)
  at com.jogamp.newt.opengl.GLWindow.display(GLWindow.java:782)
  at com.jogamp.opengl.util.AWTAnimatorImpl.display(AWTAnimatorImpl.java:81)
  at com.jogamp.opengl.util.AnimatorBase.display(AnimatorBase.java:453)
  at com.jogamp.opengl.util.FPSAnimator$MainTask.run(FPSAnimator.java:178)
  at java.base/java.util.TimerThread.mainLoop(Timer.java:566)
  at java.base/java.util.TimerThread.run(Timer.java:516)
  file: libonnxruntime_arm64.so is not found in jar file
  Unpacking to: /root/.cache/JNA/temp/libMLModule.so
  [SUCCESS]: Marker Widget: Listening for markers on 127.0.0.1:12350
  InitSettings: Saving Default Settings to file!
  SessionSettings: 3 active widgets saved!
  [SUCCESS]: Session started!
  Unpacking to: /root/.cache/JNA/temp/libDataHandler.so
  java.lang.NullPointerException: Cannot invoke "ddf.minim.ugens.Gain.setValue(float)" because "this.this$0.auditoryNfbGains[i]" is null
  at OpenBCI_GUI$AuditoryNeurofeedback.update(OpenBCI_GUI.java:2229)
  at OpenBCI_GUI$W_Focus.updateFocusState(OpenBCI_GUI.java:24837)
  at OpenBCI_GUI$W_Focus.updateFocusWidgetData(OpenBCI_GUI.java:24970)
  at OpenBCI_GUI$DataProcessing.process(OpenBCI_GUI.java:9341)
  at OpenBCI_GUI.processNewData(OpenBCI_GUI.java:9074)
  at OpenBCI_GUI.systemUpdate(OpenBCI_GUI.java:1046)
  at OpenBCI_GUI.draw(OpenBCI_GUI.java:649)
  at processing.core.PApplet.handleDraw(PApplet.java:2094)
  at processing.opengl.PSurfaceJOGL$DrawListener.display(PSurfaceJOGL.java:840)
  at jogamp.opengl.GLDrawableHelper.displayImpl(GLDrawableHelper.java:692)
  at jogamp.opengl.GLDrawableHelper.display(GLDrawableHelper.java:674)
  at jogamp.opengl.GLAutoDrawableBase$2.run(GLAutoDrawableBase.java:443)
  at jogamp.opengl.GLDrawableHelper.invokeGLImpl(GLDrawableHelper.java:1293)
  at jogamp.opengl.GLDrawableHelper.invokeGL(GLDrawableHelper.java:1147)
  at com.jogamp.newt.opengl.GLWindow.display(GLWindow.java:782)
  at com.jogamp.opengl.util.AWTAnimatorImpl.display(AWTAnimatorImpl.java:81)
  at com.jogamp.opengl.util.AnimatorBase.display(AnimatorBase.java:453)
  at com.jogamp.opengl.util.FPSAnimator$MainTask.run(FPSAnimator.java:178)
  at java.base/java.util.TimerThread.mainLoop(Timer.java:566)
  at java.base/java.util.TimerThread.run(Timer.java:516)

I downloaded and installed the OpenBCI GUI on my MacBook Air 2022, but I can’t open it—the application immediately crashes on launch. Has anyone encountered this issue or knows how to fix it?

Thanks in advance for your help!

I've got the script to work perfectly with the synthetic board, so that the logged uVRMS value and frequency is exactly that of the synthetic channels displayed in the GUI.

However, when trying to do the same with my Cyton board the values vary wildly from what's displayed. I'm sure I am just missing a (or adding an extra) crucial preprocessing step, so what should I change in my script to match the signal amplitudes printed with those displayed in the GUI?

General Questions:
1. Should I have the scaling from ADC counts to uV, or is the Cyton masterboard streaming uV already (either way, the values are significantly off)
2. Should filtering be done manually in the script, or are all the filters applied in the GUI applied before data is streamed (either way, the values are significantly off)

Here is a minimal version of the script and video showing the live comparison between the data and GUI readings.

Code: https://codeshare.io/5zloJD
Live comparison: https://streamable.com/iexvfd

Thanks in advance for the help!

Has anyone experienced this issue or knows why this might be happening?
Any help on how to resolve this would be greatly appreciated!

Thanks in advance.

"The current version of the OpenBCI GUI (download link below) has been tested/confirmed for compatibility with MacOS 10.15 through 13, Windows 10, and Linux."

Which flavors and versions of Linux have been confirmed to be compatible with the v6.0.0-beta.1 version of OpenBCI GUI?

I bought the EEG device from OPENBCI with 16 channels, but it will take some time to arrive. So, I want to test my model now to save time in the future. Does anyone know how I can load data that wasn’t recorded with the OpenBCI EEG into the GUI?

My current data header looks like this:

%OpenBCI Raw EXG Data
%Number of channels = 16
%Sample Rate = 125 Hz
%Board = Cyton+Daisy
Sample Index, EXG Channel 0, EXG Channel 1, EXG Channel 2, EXG Channel 3, EXG Channel 4, EXG Channel 5, EXG Channel 6, EXG Channel 7, EXG Channel 8, EXG Channel 9, EXG Channel 10, EXG Channel 11, EXG Channel 12, EXG Channel 13, EXG Channel 14, EXG Channel 15, Accel Channel 0, Accel Channel 1, Accel Channel 2, Not Used, Digital Channel 0 (D11), Digital Channel 1 (D12), Digital Channel 2 (D13), Digital Channel 3 (D17), Not Used, Digital Channel 4 (D18), Analog Channel 0, Analog Channel 1, Analog Channel 2, Timestamp, Marker Channel, Timestamp (Formatted)
I think the problem might be with the Board field, as I don’t know the correct name for the GUI to recognize the 16-electrode setup.
Thank you in advance for your attention!

We have a first column named “Sample Index,” then 16 columns related to each electrode, 3 columns named “Accel Channel,” followed by 7 columns named “Other,” 3 columns named “Analog Channel,” and finally the “Timestamp.” We would like to know if you can help us to understand what each column means.

Thank you in advance for your help!

https://openbci.com/forum/index.php?p=/discussion/3836/recording-data-stream-with-running-psychopy-program

e.g., sent via a separate LSL stream, so the best option is to send the OpenBCI data via LSL and compile in a third party viewer? I saw in this thread,

https://openbci.com/forum/index.php?p=/discussion/2908/streaming-through-gui-4-2-lsl-with-timestamp-problem

from 2021 that "using the GUI to route full Time Series data is not advised. I would use BrainFlow Python + LSL for Python to stream to LabRecorder." Is this still current? Or is it now OK to directly use the networking widget from the GUI to send a full data stream to LSL?

Also the samples are listed in intervals of 2 strangely, and seem to occur at 128 sps rather than the 125 sps commented in the text file header (I counted each row between an interval from 0.0 to 254.0). It seems that this does not match with the Cyton/Daisy sampling method outlined in the documentation (which also mentions a scale factor being used, I've tried to implement this in the image below) where odd numbered samples are from the Cyton and even number samples are from the Daisy: https://docs.openbci.com/Cyton/CytonDataFormat/

I would also like to mention that putting the files in playback mode does give me the expected signals, so somehow the values do reflect uVrms I'm just not sure how. Also I've been reliably observing the FFT spike at 10 Hz when I close my eyes so it appears the electrodes work fine. I've attached one of my txt files below, it was a 1 minute recording of me moving/not moving my right hand in 5 second intervals (I'm trying to observe event-related desynchronization for motor imagery).

Would anyone have any insight into this? Perhaps I should look into Brainflow or BDF+ data recording? Is there something I'm missing/not doing right?
Thank you.

EEGLAB time series with "remove DC offset" option toggled on:

Matlab bandpass from 0.5-60 Hz at 125 sampling rate:

Matlab bandpass from 0.5-60 Hz at 128 sampling rate with scale factor included:

Are there any examples of what params to pass to the BoardShim in order to properly network the openbci gui to brainflow?

I've tried a few different ways, but I'm really just guessing based on the limited docs.

from brainflow.board_shim import BoardShim, BrainFlowInputParams, BoardIds
import time
import json

def main():
    BoardShim.enable_dev_board_logger()

    params = BrainFlowInputParams()
    params.ip_port = 12345  # Make sure this matches the UDP port set in OpenBCI GUI
    params.ip_address = '127.0.0.1'  # Use localhost if GUI is on the same machine
    # params.ip_port = 6677
    # params.ip_address = '225.1.1.1'
    # params.mac_address = 'c3:60:56:3a:6c:d7'
    params.ip_protocol = 1
    params.timeout = 15  # Set a timeout for connection attempts
    # params.other_info = json.dumps({"use_udp_board_streaming": True})

    params.serial_port = '/dev/tty.usbmodem11'
    params.master_board = BoardIds.SYNTHETIC_BOARD

    # board = BoardShim(BoardIds.GANGLION_BOARD, params)
    board = BoardShim(BoardIds.STREAMING_BOARD, params)

I have those numbers on serial port:

import controlP5.*;
import processing.core.PApplet;

class W_HeartRate extends Widget {

    ControlP5 localCP5;
    double hr = 72, hrv = 0;
    long instance1 = 0, timer;
    int value = 0, count = 0;
    boolean flag = false;

    W_HeartRate(PApplet _parent) {
        super(_parent);

        localCP5 = new ControlP5(ourApplet);
        localCP5.setGraphics(ourApplet, 0, 0);
        localCP5.setAutoDraw(false);

        // Initialize timer
        timer = millis();
    }

    public void update() {
        super.update();

        // Fetch data from channel 6
        float[] ecgData = getLiveECGData(6); // Channel 6 data

        // Process data to update heart rate and HRV
        processECGData(ecgData);
    }

    private float[] getLiveECGData(int channelIndex) {
        // Get the live ECG data for the specified channel
        // Replace this with actual logic to fetch data from OpenBCI board
        int nPoints = 100; // Number of data points to fetch
        float[] data = new float[nPoints];
        for (int i = 0; i < nPoints; i++) {
            data[i] = dataProcessingFilteredBuffer[channelIndex][i];
        }
        return data;
    }

    private void processECGData(float[] ecgData) {
        int threshold = 100;
        int timerValue = 10000; // 10 seconds in milliseconds

        for (int i = 0; i < ecgData.length; i++) {
            value = (int) map(ecgData[i], 250, 400, 0, 100); // Flatten the ECG values

            if (value > threshold && !flag) {
                count++;
                flag = true;
                long now = millis();
                long interval = now - instance1; // RR interval in milliseconds
                instance1 = now;

                if (interval > 0) {
                    hrv = hr / 60.0 - interval / 1000.0;
                }
            } else if (value < threshold) {
                flag = false;
            }

            if ((millis() - timer) > timerValue) {
                hr = count * 6;
                timer = millis();
                count = 0;
            }
        }
    }

    public void draw() {
        super.draw();
        drawHeartRate();
        localCP5.draw();
    }

    private void drawHeartRate() {
        pushStyle();
        fill(50);
        textFont(createFont("Arial", 20));
        fill(255, 0, 0); // Red color for heart rate text
        textAlign(LEFT, CENTER);
        text("Heart Rate: " + (int) hr + " BPM", x + 20, y + 20);
        text("HRV: " + hrv, x + 20, y + 50);
        popStyle();
    }

    public void screenResized() {
        super.screenResized();
        localCP5.setGraphics(ourApplet, 0, 0);
    }

    public void mousePressed() {
        super.mousePressed();
    }

    public void mouseReleased() {
        super.mouseReleased();
    }
}

I am looking for documentation on the OpenBCI WiFi (shield) API, specifically example responses from an OpenBCI board. I found this old documenation https://docs.openbci.com/ThirdParty/WiFiShield/WiFiAPI/, but it doesn't cover all commands.

My goal is to use the OpenBCI_GUI to visualize and analyze live EEG signals from a third-party device, a Muse S.

Here’s what I’ve done so far:
1. On the GUI, select "CYTON (live)" with the "WiFi" protocol.
2. Select "Static IP" and enter the IP value (my laptop's).
3. Press START SESSION.
Result: the GUI displays "Failed to initialize board" error message. I found out that it sent a "/board" API call on Port 80 to my laptop's IP.
* NOTE: The Wifi API documentation I cited does not describe the "/board" API command.

I plan to write a custom OpenBCI-wifi server that makes the Muse emulate a Cyton board. To achieve this, I need to know what minimal set of GUI commands to support and what responses to generate.

Additionally, do you think this approach could be a viable way to extend OpenBCI_GUI’s compatibility with other third-party BCI devices? Would the OpenBCI community support this idea?

Thanks in advance for any help or guidance!
Ben!

Ideally, we could build an executable with the adaptions (1+3), such that our experimenters do not have to run from processing.

Kind regards,
Thomas

This is during my own session: