• Download Link: shape_predictor_68_face_landmarks.dat

Usage

• Ensure your webcam is connected.
• Run the application as shown above.
• The system will start monitoring your eyes and alert you if signs of drowsiness are detected.

Folder Structure

driver-drowsiness-detection-system/
│
├── main.py                  # Entry point for the system
├── blinkDetect.py            # Drowsiness detection script
├── lanedetection.py          # Lane detection module
├── ui.py                     # User interface handling
├── requirements.txt          # Python dependencies
├── CONTRIBUTING.md           # Contribution guidelines
├── DEPLOYMENT.md             # Deployment instructions
├── PWA_README.md              # PWA installation & usage
├── PWA_IMPLEMENTATION.md      # Technical details of PWA
│
├── models/                   # Pre-trained ML models
│   └── haarcascade_frontalface_default.xml
│
├── streamlit_app/            # Web app (Streamlit + PWA)
│   ├── streamlit_app.py
│   ├── streamlit_app_pwa.py
│   ├── manifest.json
│   ├── sw.js
│   └── icons/                # App icons for PWA
│
├── assets/                   # Images, audio, and test files
│   ├── alarm.wav
│   ├── alarm.mp3
│   ├── eye.PNG
│   ├── eye_aspect_ratio.PNG
│   ├── face.PNG
│   └── test_image.jpg

Contribution Guidelines

We welcome contributions to improve this project! To get started:

1. Star ⭐ this repository to show your support.
2. Fork 🍴 the repository to your own GitHub account.
3. Create a new branch for your feature or bugfix.
4. Make your changes and commit them with clear messages.
5. Push your branch to your forked repo.
6. Open a Pull Request describing your changes.

📋 Project Board & Roadmap

We are actively tracking progress and assigning tasks for GSSoC'25 in our GitHub Project Board.
You can see which issues are To Do, In Progress, or Completed, and pick one to start contributing.

🚀 View the GSSoC 2025 Roadmap Project →

ℹ️ To work on an issue:

1. Comment on the issue stating your interest.
2. We’ll assign it to you under the appropriate GSSoC’25 level.
3. Track your progress via the Project Board.

🌐 Streamlit Web App (New Feature!)

This app version uses Streamlit + Mediapipe to detect drowsiness via webcam directly in the browser.

Usage:

# Standard web app
streamlit run streamlit_app/streamlit_app.py

# Or run the enhanced PWA version
streamlit run streamlit_app/streamlit_app_pwa.py

📱 Progressive Web App (PWA) Support

NEW! This project now supports Progressive Web App functionality! Install it like a native app on your device.

PWA Features:

• 📱 Installable: Add to home screen on mobile/desktop
• 🚀 Fast Loading: Cached resources for better performance
• 🔄 Offline Support: Basic functionality without internet
• 📲 App-like Experience: Full-screen, native app behavior

Quick PWA Installation:

1. Mobile: Open in browser → Menu → "Add to Home Screen"
2. Desktop: Look for install icon in address bar → Click "Install"

📖 Complete PWA Guide - Detailed installation and usage instructions

Dependencies: Install using:

pip install -r requirements.txt

Features:

• Real-time Eye Aspect Ratio (EAR) monitoring
• Drowsiness warning overlay
• Web-based UI with live video
• PWA installable web app
• Offline caching support

If you have any questions or need guidance, feel free to open an issue or ask in the discussions!

👥 Contributors

Thanks to these wonderful people for contributing 💖

Thank you for your interest in improving the Driver Drowsiness Detection System! Your contributions are greatly appreciated.