EmoPAD Universe

emoPAD Universe - Emotion Universe Skill Helps users locate emotions in the PAD (Pleasure-Arousal-Dominance) coordinate system, and provides emoNebula featur...

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.