Chrome Extension

Your brain state,
on every page

Chrome extension that overlays real-time cognitive state insights on any webpage. Engagement, workload, fatigue, calm — all driven by your live EEG.

PiEEG HardwarePiEEG-serverChrome Extension+PiEEG-agent (optional)

Requires PiEEG-server running on localhost. Not available on the Chrome Web Store — localhost-only extensions require developer mode.

Quick Start

Three steps to brain-aware browsing

1

Start PiEEG Server

curl -sSL https://raw.githubusercontent.com/pieeg-club/PiEEG-server/main/install.sh | bash pieeg-server

The server streams EEG data on ws://localhost:1616 and serves a dashboard on :1617.

2

Load the Extension

git clone https://github.com/pieeg-club/PiEEG-chrome.git

Open chrome://extensions, enable Developer mode, click Load unpacked, select the PiEEG-chrome folder.

3

Optional: AI Copilot

curl -sSL https://raw.githubusercontent.com/pieeg-club/PiEEG-agent/main/install.sh | bash pieeg-agent web

Enables the Neural Feedback Assistant chat interface on any page.

Chrome Store policies don't allow localhost-only extensions. Install via Developer mode instead — it takes 30 seconds.

What It Does

Your browser becomes brain-aware

Brain Insights Overlay

Draggable HUD showing real-time cognitive state: engagement, workload, fatigue, calm — with confidence badges and animated waveforms.

Neural Feedback Assistant

AI-powered chat copilot that understands your live brain signals. Ask "am I focused?" in plain English. Requires PiEEG-agent.

Live Signal Quality

Confidence badges, trend indicators, and per-channel quality metrics. See exactly which electrodes are clean or noisy.

Context-Aware

Works on YouTube, docs, games, code editors — your mental state follows you across every tab.

Scientifically Honest

All indices are ratio-based (β/(α+θ), θ/α, etc.), normalised to your session baseline with full citations. No false clinical claims.

Auto-Update Notifications

The extension checks GitHub for new versions every 6 hours and shows a one-click reload banner when an update is available.

Staying Up to Date

Unpacked extensions don't auto-update. PiEEG Chrome checks GitHub every 6 hours and shows a banner when a new version is available.

To apply an update:

git pull

Then click Reload in the popup banner — no need to visit chrome://extensions.

Default Ports

HTTP dashboard:1617
WebSocket stream:1616
PiEEG-agent (optional):8000

Change the HTTP port in the extension's settings row — persisted via chrome.storage.sync.

Permissions Used

What the extension requests and why

storage

Persist your configured server port

tabs

Open the dashboard in a new tab

alarms

Schedule the periodic update check (every 6 h)

http://localhost/*

Fetch /api/info from the local PiEEG server

raw.githubusercontent.com

Check for extension updates on GitHub main

Ready to try it?

Start with the server, then add the extension. The actual EEG streaming and signal processing happen in PiEEG-server. The extension brings your brain data into every tab.