Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aflucas-uom/ics2207-viola-jones

The Viola-Jones object detection framework, introduced in 2001 by Paul Viola and Michael Jones, represents a breakthrough in the field of Computer Vision (CV), particularly in the domain of real-time face detection.
https://github.com/aflucas-uom/ics2207-viola-jones

computer-vision machine-learning viola-jones

Last synced: 7 days ago
JSON representation

Host: GitHub
URL: https://github.com/aflucas-uom/ics2207-viola-jones
Owner: AFLucas-UOM
License: mit
Created: 2024-05-08T17:20:00.000Z (6 months ago)
Default Branch: main
Last Pushed: 2024-05-08T17:43:48.000Z (6 months ago)
Last Synced: 2024-05-08T18:50:35.496Z (6 months ago)
Topics: computer-vision, machine-learning, viola-jones
Language: Python
Homepage:
Size: 50.4 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Viola-Jones Face Detection System

## Introduction

This Python script implements the Viola-Jones face detection algorithm using OpenCV for face, eye, and mouth detection. The program captures video from a webcam, processes each frame for face detection, and displays the live feed with bounding boxes around detected faces, eyes, and mouths.

## Motivation
The Viola-Jones algorithm is a popular method for real-time object detection, particularly for faces. This project aims to provide a simple implementation of the algorithm using Python and OpenCV, making it accessible for educational purposes, prototyping, or integration into larger projects. Face detection has various applications, including security systems, human-computer interaction, and biometric identification.

## Requirements

- Python 3.x
- OpenCV (cv2)
- Tkinter (for GUI)
- macOS or Linux (for dynamic path handling)

## Installation
1. Install Python 3.x from [python.org](https://www.python.org/downloads/).
2. Install OpenCV:
```bash
pip install opencv-python
```
3. Install Tkinter (included in Python standard library).

## Usage
1. Clone or download the script to your local machine.
```bash
git clone https://github.com/AFLucas-UOM/ICS2207-Viola-Jones
```
2. Run the script using Python:
```bash
python Viola-Jones.py
```
3. Ensure that your webcam is connected and accessible.
4. The program will display the live webcam feed with face, eye, and mouth detection bounding boxes.
5. Press the 'q' key to exit the program.

## Features

- Utilizes the Viola-Jones algorithm for real-time face detection.
- Detects eyes and mouths within detected faces.
- Provides a simple GUI with an exit confirmation dialog.

## File Structure

- `Viola-Jones.py`: Main Python script implementing the Viola-Jones algorithm.
- `haarcascade_frontalface_default.xml`: Pre-trained Haar cascade XML file for face detection.
- `haarcascade_eye.xml`: Pre-trained Haar cascade XML file for eye detection.
- `haarcascade_mcs_mouth.xml`: Pre-trained Haar cascade XML file for mouth detection.
- `Icon.png`: Icon image used for the application window.

## Troubleshooting

- If the webcam is not accessible, ensure it is connected and not being used by other applications.
- Check for any warnings or errors displayed in the terminal while running the script.

## Contributions

Contributions to improve the functionality or add new features are welcome! Please fork the repository, make your changes, and submit a pull request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Acknowledgments

This project was developed as part of an academic assignment. Unit: `ICS2207` at the `University of Malta`.

## Contact

For any inquiries or feedback, please contact [Andrea Filiberto Lucas](mailto:[email protected]).