Pulse - Biofeedback Application in Node.js

A biofeedback application that monitors physiological signals like heart rate, breathing, and skin conductance to provide real-time feedback.

Please note that this app is inspired by (https://github.com/camilleanne/pulse).

Features

• Real-time monitoring of heart rate, breathing rate, and skin conductance
• Visual feedback with charts and metrics
• Session management to track progress over time
• Multiple sensor input options (simulated, webcam, microphone)
• Personalized recommendations based on biofeedback data

Installation

1. Clone the repository:

git clone https://github.com/AhmadShallal/pulse-nodejs.git cd pulse-nodejs

2. Install dependencies:

npm install

3. Start the application:

npm start

4. Open your browser and navigate to http://localhost:3000

Usage

1. Click "Start Session" to begin monitoring your biofeedback data.
2. Select your preferred sensor input method:

• Simulated Data: Uses simulated data for demonstration purposes
• Webcam: Uses your webcam to detect heart rate (requires browser permissions)
• Microphone: Uses your microphone to detect breathing rate (requires browser permissions)

3. View real-time feedback and recommendations based on your biofeedback data.
4. Click "Stop Session" to end the monitoring session.
5. Click "Save Session" to save the session data for future reference.
6. Click "Load Sessions" to view and analyze previous sessions.

API Endpoints

• GET /api/sessions/:userId - Get all sessions for a user
• POST /api/sessions - Save a new session
• POST /api/process - Process biofeedback data

Technology Stack

• Backend: Node.js, Express.js, Socket.io
• Frontend: HTML5, CSS3, JavaScript, Chart.js
• Data Storage: JSON files (can be replaced with a database)

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.