Installation#

Download#

Get BrainAccess Board from the BrainAccess downloads page: a .zip archive for Windows or Linux, or a .dmg disk image for macOS.

If you already have Board installed, the newest build is always one click away inside the app: Resources → Downloads → BrainAccess Board for Windows and Linux, All downloads → for macOS (see Updating below).

Windows#

  1. Download the Windows .zip archive.

  2. Extract it anywhere you like (for example C:\Program Files\BrainAccessBoard or a folder in your user profile).

  3. Run BrainAccessBoard.exe.

Linux#

  1. Download the Linux .zip archive.

  2. Extract it to a folder of your choice.

  3. Run the BrainAccessBoard executable. If your file manager does not offer to run it, mark it as executable first (file properties → Allow executing file as program, or chmod +x BrainAccessBoard in a terminal).

macOS#

Board runs on Macs with Apple silicon (M1 or newer) and macOS 14 Sonoma or later. Intel Macs are not supported.

  1. Download the macOS .dmg (BrainAccessBoard-<version>-arm64.dmg).

  2. Open it and drag BrainAccess Board onto the Applications folder shown next to it.

  3. Eject the BrainAccess Board disk image in the Finder sidebar.

Opening it the first time#

Board is not notarized by Apple yet, so macOS refuses to open it on the first try:

  1. Open BrainAccess Board from Applications. macOS says it cannot verify the app — click Done.

  2. Open System Settings → Privacy & Security, scroll down to Security, and click Open Anyway next to the message about BrainAccess Board. Enter your password, then click Open.

From then on it opens normally. After installing a new version, macOS asks once more.

Bluetooth permission#

The first time Board looks for headsets, macOS asks whether BrainAccess Board may use Bluetooth — click Allow. Without it headsets never appear on the Connect screen and no error is shown. If you refused, turn it on in System Settings → Privacy & Security → Bluetooth (switch on BrainAccess Board) and restart Board.

Keyboard shortcuts#

Board’s shortcuts use the Control (⌃) key on a Mac, not Command (⌘): Ctrl+1 means ⌃1. See Keyboard shortcuts.

First launch#

The first window can take a few moments to appear while the application starts its background services — this is normal. You land on the Connect screen, ready to pair a device (see Quick start).

Updating#

Board tells you when a newer version exists:

  • An “Update available” banner appears at the top of the window — follow its “Get the latest build” link.

  • Resources → Downloads always lists the current Windows and Linux builds; its All downloads → link opens the downloads page with the macOS .dmg.

  • The footer of the Resources screen shows your installed version: “BrainAccess Board v… — Up to date” or “— v… available”.

To update, download the new archive and replace your extracted folder. On macOS, open the new .dmg, drag BrainAccess Board to Applications again and choose Replace. Your recordings, templates, and settings live in your user profile, not in the application folder, so they survive updates.

Where Board keeps your files#

Open the Folders screen (sidebar, Ctrl+4) and click a card to open the folder in your file manager:

Folder

Contents

Recordings

Your recorded sessions (default: Documents/BrainAccessData).

Templates

Device template presets.

Apps

Installed companion apps.

Logs

Log files — useful when contacting support.