SkillHub

emopad-universe

v0.1.0

emoPAD Universe - Emotion Universe Skill Helps users locate emotions in the PAD (Pleasure-Arousal-Dominance) coordinate system, and provides emoNebula feature: continuous real-time emotion PAD monitoring, with a popup window displaying the emotion nebula chart every 5 minutes. ## Cross-Platform Supp...

Sourced from ClawHub, Authored by beardao

Installation

Please help me install the skill `emopad-universe` from SkillHub official store. npx skills add beardao/emopad-universe

emoPAD Universe

Cross-Platform Support

emoPAD Universe supports the following operating systems:

OS Image Viewer Notes
Linux eog (Eye of GNOME) Window mode, closable
Windows System default image viewer Window mode, closable

Auto-Start

After installing this skill, the following operations will be performed automatically: 1. Check and install required Python dependencies 2. Start emoPAD service (listening on http://127.0.0.1:8766) 3. Start emoNebula auto-report (popup window displaying emotion nebula chart every 5 minutes)

No manual start needed, ready to use after installation.

Tools

emopad_status

Get current emotion PAD status and sensor connection status

Description: Returns values for three dimensions: Pleasure, Arousal, Dominance, and connection status of EEG, PPG, GSR sensors

Parameters: None

Returns: Formatted emotion status text, including sensor connection status

emopad_snapshot

Generate current emotion nebula chart

Description: Generate 3D PAD cube visualization screenshot

Parameters: None

Returns: - Status message - PNG image data

emopad_start_nebula

Start emoNebula auto-report

Description: Automatically generate and display emotion nebula chart in popup window every 5 minutes. Requires at least 2 sensors connected to display image, otherwise shows data missing reminder.

Parameters: None

Returns: Status message

emopad_stop_nebula

Stop emoNebula auto-report

Description: Stop automatically displaying emotion nebula chart

Parameters: None

Returns: Status message

Configuration

serial_port: /dev/ttyACM0      # Serial device path (Linux)
# serial_port: COM3            # Serial device path (Windows)
baudrate: 115200               # Serial baudrate
eeg_window_sec: 2              # EEG data window (seconds)
ppg_gsr_window_sec: 60         # PPG/GSR data window (seconds)
hop_sec: 2                     # Calculation interval (seconds)
history_length: 120            # Number of historical data points
nebula_interval: 300           # Send interval (seconds)
service_host: 127.0.0.1        # Service listening address
service_port: 8766             # Service listening port

Dependencies

  • mne
  • heartpy
  • neurokit2
  • bleak
  • pyvista
  • pyserial
  • scipy
  • numpy
  • PyWavelets
  • fastapi
  • uvicorn
  • pillow
  • requests
  • pyyaml

Hardware Support

Currently Supported Devices

Type Model Connection
EEG KSEEG102 Bluetooth BLE
PPG Cheez PPG Sensor Serial
GSR Sichiray GSR V2 Serial

Future Planned Support

  • Muse series EEG devices
  • Emotiv EEG devices
  • Oura Ring smart ring
  • Whoop smart wristband
  • Other mainstream EEG devices and wearable devices

About Emotion PAD Calculation

Important Note: Currently, emotion PAD calculation is based on heuristic methods, mapping relationships summarized from extensive literature.

Characteristics of this method: - ✅ Based on statistical patterns from scientific literature - ✅ Suitable for emotion recognition in general population - ⚠️ Temporarily cannot reflect individual differences

Future Improvements: Will introduce personalized calibration training modules in new versions, through user-specific data training, to achieve true personalized emotion recognition.