Dashboard

The PiEEG Server dashboard is a browser-based real-time visualization tool served at http://<host>:1617.

Session Lobby

When you open the dashboard, you land on the Session Lobby:

• Server URL field is pre-filled with your server's WebSocket address (ws://localhost:1616 by default).
• Click Connect (or press Enter) to start streaming.
• Click ▶ Use Demo Server to prefill the public mock endpoint — no hardware required.
• Join with session code lets you paste a code or URL shared by someone else.
• Once connected, the Disconnect button in the header status bar closes the WebSocket and returns you to the lobby.

Topographic Map

The topographic map projects live band power across the head. It offers two views, toggled with the 3D / 2D switch in the panel toolbar:

• 3D (default) — your EEG is painted onto a real 3D head model (the same realistic head used by the Face Trainer experience). Drag to rotate; it also auto-rotates on load. This is a true volumetric surface, so the sides and back of the head are represented without the distortion of a flattened disc.
• 2D — the classic flattened scalp disc, kept as a lightweight fallback.

Montages

Use the montage buttons (visible in 3D mode) to choose how channels map onto the head:

By default, channels are assigned in a sensible anatomical order (channel 1 → first position, and so on).

Placement editor

Because everyone places and names their own electrodes, the default layout is only a starting point. Click the ⚙ gear button on the map to open the placement editor and, per channel:

• Rename the electrode label.
• Remap it to any position from the standard list.

Your layout is saved in the browser (per device profile and channel count) and restored automatically. Use Reset to return to the default montage.

Controls

Features

Keyboard Shortcuts

EEG Frequency Bands

The dashboard color-codes all spectral data using standard EEG bands:

Tech Stack