Brain Arcade — Athena edition (this fork)
Thought-controlled minigames in your browser. This fork adds full support for the Muse S Athena (Gen 3), including its fNIRS light sensors. It also adds calm, Mendi-style training games, personal brainwave calibration, child profiles with a training journal, and a parent report. It works on a phone. Everything stays on your device.
Try it now: https://palo007.github.io/BrainArcade/
What this fork adds
| Feature | What it does | Screenshot |
|---|
| Muse S Athena over Web Bluetooth | Connects the Athena (EEG, motion and fNIRS HbO/HbR) straight from Chrome. Reconnects by itself if the link drops. A phone relay is also available. | Start screen |
| fNIRS games | Glow Orb and Focus Ball: think hard and the orb flies or the ball stays up. Mendi-style, with a session report. | |
| Bubble Hippo (new) | A calm-practice bath game. Stay calm and a bubble grows and floats away with a Bubble Zoo friend. Six badges (Duckling to Hippo King), each adds one skill: breathing ring, duck counting, buzzing pests, a secret bubble. | (no screenshot yet) |
| Train of Thoughts, upgraded | Faster calm signal (8 updates/s). A tense jaw, closed eyes or sleepiness pause the reward and Brainy gives a hint, no punishment. Daily goal, line unlocks, line events and new sounds. | (no screenshot yet) |
| Fair brain-game rules | Shared by Train of Thoughts and Bubble Hippo: the goal adapts to keep success at 75–85 %, a safety net once per round, a daily limit (3 rounds per game, 15 min per day), and one round record for the journal and parent report. All numbers are start values until the headband test day. | — |
| Play setup | The start screen asks "How do you play today?": phone in hands, phone on a stand, or computer. A top-bar chip changes it with one tap. Sessions, the journal (SETUP column), the parent report, the CSV export and recordings (/Setup marker) store it. In hands mode a round is 2 min at most. | — |
| Training Journal | Score over time, day streak and check-ins, per child. | |
| Two-phase calibration | Peak Alpha Frequency from eyes closed, then eyes open. Personal frequency bands for each child. | |
| Session recording | Opt-in, on-device, crash-safe CSV. Mind Monitor compatible, with Athena optics. Opens in mind-monitor.com/Chart.php. See where the file goes. | |
| Recording Viewer | Open a saved recording from the start screen (VIEW A RECORDING, no headset needed): band power, raw EEG, signal quality, markers, topomaps, spectrogram, fNIRS, heart rate, estimated breathing rate and HRV, and more. Everything stays on your device. See Viewing a recording. | (no screenshot yet) |
| Child profiles and history | One profile per child. Session history, trends, CSV export and import. | Journal |
| Parent report | Band timeline, topomap and a plain-language summary. Print or save as PDF. | (in game over screen) |
| Phone first | Installable PWA. Fullscreen, rotation, portrait and landscape layouts. No desktop-only block. | |
| Drift-proof signal mechanics | Slow signal drift no longer pins a game at 0. Bad-signal pauses really pause. Stuck or unusable sessions are flagged, not scored. Covers the original games too. Band powers are cleaner: segments are detrended, blink segments are left out, and a bad forehead sensor drops out. Command Center tiles use log mapping, so they sit at 0 or 100 less often. See Signal mechanics. | — |
How the brain signal becomes a game control, and what we changed compared with the original project: see docs/SIGNAL-MECHANICS.md.
Gallery
| |
|---|
| Game list | Glow Orb in action |
| Calibration, step 1 of 2 | Phone portrait |
Try it
- Open https://palo007.github.io/BrainArcade/ in Chrome (Android or desktop).
- With a headset: tap CONNECT MUSE (ATHENA).
- No headset: tap EXPLORE WITHOUT A DEVICE, then USE SIMULATED REAL-TIME DATA.
Run it locally: npm install, then npm run dev.
Install on Android
Open the site in Chrome. Tap the menu (three dots), then Install app. This makes a WebAPK with a home-screen icon and fullscreen mode.
Why not a Trusted Web Activity (Bubblewrap)? We built one. It works, but Chrome disables Web Bluetooth inside TWAs ("Web Bluetooth API globally disabled"). The headset cannot connect there. So the Chrome install is the recommended way.
Windows PC with bad Bluetooth: play through your phone
Does the Muse fail to connect to your Windows PC ("GATT Server is disconnected", or it drops after a few seconds)? Let an Android phone hold the Bluetooth link, and play on the PC.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
