Say hello to CortEX - an open-source meditation tool that blends mindfulness with brain and heart monitering.
CortEX reads your brainwaves (EEG) and heart signals (ECG) in real time, helping you understand how focused, relaxed, or calm you are while meditating. It shows what’s happening inside your mind and body, So you’re not just guessing anymore.
By turning brain and heart activity into simple, easy-to-read visuals, CortEX makes meditation more personal, more powerful, and backed by real data
In this Instructable, we’ll walk you through how to set it up and start using it, So you can see what’s going on inside and build a deeper, more mindful practice.
Let’s get started!
What is an Electroencephalography (EEG) ?
Electroencephalography (EEG) is a method used to record an electrogram of the brain's spontaneous electrical activity.
What is Electrocardiogram (ECG) ?
Electrocardiogram (ECG) measures the electrical activity of your heart. It tracks how fast and how regularly your heart is beating by placing electrodes on the skin.
How does this application works?
In CortEX, ECG tracks your heart rate and heart rate variability (HRV) in real time to give you insights into your stress and relaxation. Meanwhile, EEG helps identify your mental state-whether you're focused, relaxed, drowsy, during meditation.
This connects wirelessly to the Neuro PlayGround Lite device, which records your brain (EEG) and heart (ECG) signals in real time. It streams this data to a web app that visualizes your brainwaves and heart metrics during meditation.While you meditate, CortEX analyzes your focus, relaxation, and heart rhythms, providing live feedback. After the session, it gives a detailed report to help you understand and improve your mental state.
CortEX application is an open-source free to use software designed to work with Neuro PlayGround Lite. It's a wellness and research tool, not a medical application and should not be treated like one. There is no Warranty, you may use it on your own risk. You agree to the terms if you use the application.
Note: This project is made by Ritika Mishra
About Neuro PlayGround (NPG) Lite:Neuro PlayGround (NPG) Liteis a compact Adafruit Feather form factor, a multi-channel wireless biopotential signal amplifier designed for EMG, ECG, EOG, and EEG recording.
It offers Wi-Fi, Bluetooth, Zigbee, and Thread connectivity, along with patient protection, LEDs (User LED, charging LED, six addressable RGB LEDs), buttons (Reset and user button), LiPo battery charging, and USB-C with ESD protection. Its lightweight and user-friendly design makes it perfect for research, education, and wearable applications.
Neuro PlayGround Lite is available on CrowdSupply. Get yours today!
Proper skin preparation is crucial for clear signal acquisition. Here’s how to prepare:
- Apply Nuprep Gel to each target area.
- Gently rub to exfoliate and remove dead skin
- Wipe the area clean using an alcohol swab.
It ensures minimal noise and maximum signal clarity during meditation
What is Nuprep Gel?
Nuprep is a mildly abrasive, highly conductive gel that improves electrode contact by reducing skin impedance. It's safe, effective, and causes minimal skin irritation.
Step 2: Connecting BioAmp CablesAlternate ECG option: Wrist setup
If chest placement is inconvenient, CortEX supports wrist-based ECG as well:
- REF cable → Back of the right hand
- Positive (A2P) → Front of the right wrist
- Negative (A2N) → Left wrist
Tip: Always clean skin with alcohol wipes before placing electrodes to ensure better signal quality.
Step 3: Uploading FirmwareTo enable signal streaming:
- Download and open NPG Lite Flasher.
- Connect the board via USB.
- Select the firmware file.
- Click Upload and wait for completion.
CortEX runs directly in your web browser - no installation required!
- Visit the app URL (https://upsidedownlabs.github.io/CortEX/).
- After initial load, CortEX works offline.
- Ensure Bluetooth is enabled on your laptop.
To start streaming:
- Power on your NPG Lite device.
- Click the “Connect” button in the app.
- Select your device from the list.
- CortEX will begin receiving EEG and ECG signals in real time.
Click the Connect button and begin your journey inward:
- Focus on your breath.
- Let CortEX track your mental and physiological state in real time.
Once connected, CortEX displays a sleek three-column layout to guide your experience.
Column One – Control & WellnessThe first column is your control center:
- Connect/Disconnect your device.
- Begin Meditation Session to start real-time feedback.
- View inspirational wellness quotes to stay centered and motivated.
This is your EEG dashboard:
- A radar chart displays power across five brainwave bands (Delta, Theta, Alpha, Beta, Gamma).
- Two line charts stream live EEG signals from the left and right hemispheres.
Here, CortEX reveals your heart’s inner story:
- Live BPM (Beats Per Minute) display at the top.
- HRV analysis below, showing metrics like low, high, and average intervals.
- A real-time ECG waveform is streamed from your chest or wrist electrodes.
CortEX reads brainwaves from two frontal electrodes:
All of this is visualized via radar and time-series plots for easy tracking.
Heart Rate & HRVA high HRV typically indicates parasympathetic dominance, meaning your body is in “rest-and-digest” mode - ideal for meditation.
CortEX tracks HRV in real time, showing:
- Trends and outliers
- Current stress/calm state
CortEX measures balance between:
- Left Frontal – Logical, analytical, verbal thinking
- Right Frontal – Emotional, intuitive, creative processes
Balanced Activity = calm, centered mind
Left-dominant = overthinking, cognitive tension
Right-dominant = emotional drifting, daydreaming
CortEX visualizes this balance in real time via a symmetry meter — helping you stay aligned.
After the Session: Your Neural Journal
When you click End Session, CortEX gives you a powerful summary:
- EEG timeline with dominant waveforms
- Mental state classification: Focused, Relaxed, Drowsy, Meditative
- Session score and key insights
Use this journal to reflect, improve, and track your inner growth.
Under the Hood: Technical ArchitectureCortEX is built using modern web technologies:
- Next.js + React – Interactive, responsive UI
- Web Bluetooth API – Device connection
- Web Workers – Real-time signal processing
- WebGL + Recharts – Fast, Real time, beautiful visualizations
- Tailwind CSS – Clean, adaptive design
- Icons - Lucide Icons
It classifies your current state using real-time EEG + ECG data — far more reliable than guesswork used in traditional apps.
For the complete step-by-step tutorial, check out our youtube video
This was just a demonstration of how Neuro PlayGround Lite can record, filter, and process multi - channel signals.
This is just the beginning. We are already working on creating much more interesting brain-computer interfaces.
The possibilities are endless. Drop your feedback in the comments.
Need help? Reach out at support@upsidedownlabs.tech
Step 9: TroubleshootingGetting an accurate EEG signal is very crucial for this project to work properly. Please check the link below for the tips for best signal acquisition: https://docs.upsidedownlabs.tech/guides/troubleshoot/tips/index.html
In case a weak EEG signal is detected, then ensure there is good electrode contact with the skin surface and you have prepared the skin using nuprep skin preparation gel properly.
If you face any issues with the Bluetooth connection, then restart NPG Lite and try to reconnect.
Comments