GUI Troubleshooting
The GUI Console Log
- Want to know what's happening "under the hood" in the GUI?
- Click the Console Log button in the top right (pictured below).
- Click the Console Log button in the top right (pictured below).
- Need even more information to debug a problem?
- Run GUI from Processing IDE or Visual Studio Code (Preferred).
- Go to Debugging.pde and change
boolean isVerbose = false;toboolean isVerbose = true;.
- You can share the Console Log as text or a file on the Forums or GitHub. This is typically a requirement for new issues on GitHub.
- You can use keyboard shortcuts within the Console Window to Open Log as Text(
f), Copy Full Log Text(c), Copy Last Line (l), Jump to Last Line(j), Scroll Down(Down Key), and Scroll Up(Up Key).
Issues Connecting & Starting Session
- If you receive an error in red at the bottom of the GUI while trying to connect to an OpenBCI board, try turning the board Off and back On.
- Also, unplug and plug the USB dongle for Cyton or BLED112 for Ganglion.
- Try to start a session again.
- Cyton: If you still can't connect, try pressing the "AUTOSCAN" button once or twice.
- Cyton+WiFi: Go through the WiFi Getting Started Guide. If this doesn't help, check the Forums or GitHub and make a new issue if one doesn't already exist. There are a number of issues that are currently being worked on.
- Ganglion: The Ganglion board usually has fewer issues. If you can't get the Ganglion to connect to the GUI after trying the previous steps, you can email us at support@openbci.com or check GitHub.
- If your Cyton firmware is older than v3.0.0, you will need to update the firmware as outlined here. The latest Cyton firmware as of 2019 is v3.1.2.
- If nothing in the Docs, GitHub, or Forums are helpful, it's a good idea to email support@openbci.com or make a new issue on GitHub.
Something Doesn't Look Right...
- Take a screenshot using tools provided by your operating system. Alternatively, you can turn on Expert Mode in the GUI and take a screenshot by pressing 'm' on your keyboard.
- Restart the GUI. If the same problem happens again, please make a new issue on GitHub.
High DPI Scaling
Further troubleshooting
If you're still having problems, search through the issues on GitHub or make a new issue.