Skip to content

Woolbridge/FRecog-Gate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 

Repository files navigation

F_Recog-Gate

πŸ” Facial Authentication System (Tkinter + MediaPipe)

A secure facial authentication system built with Python, Tkinter, and MediaPipe.
Designed for educational purposes (school project) β€” featuring a modern UI, encrypted storage, and GDPR-friendly principles.


✨ Features

  • 🧠 Face Recognition with MediaPipe
  • πŸ”’ Strong Data Protection
    • Stores only 2D landmark coordinates (no images)
    • Encrypted using Fernet symmetric encryption
  • πŸ‘€ User Management
    • βž• Register face (with consent)
    • πŸ”‘ Login with face recognition
    • πŸ‘€ View registered users
    • ❌ Delete face data anytime
  • βš–οΈ GDPR Principles
    • βœ… Consent required
    • βœ… Encrypted + pseudonymized with UUID
    • βœ… Full user control (view/delete)
    • βœ… Data minimization
    • βœ… Manual retention
  • 🎨 Modern UI
    • Dark theme with ttk
    • Status bar for live feedback
    • Keyboard shortcuts:
      • ⏎ Enter β†’ Register
      • πŸ” Ctrl+L β†’ Login
      • πŸ—‘οΈ Ctrl+Delete β†’ Delete

πŸ“‚ Project Structure

facial-auth/
│── registered_faces/        # πŸ”‘ Encrypted face data (.pkl files)
│── facial_auth.log          # πŸ“ Log file of actions
│── main.py                  # πŸš€ Main program entry (GUI + logic)
│── README.md                # πŸ“˜ Documentation

πŸ› οΈ Requirements

  • Python 3.8+
  • Install dependencies:
pip install opencv-python mediapipe cryptography numpy

πŸš€ How to Run

  1. Start the app:
python main.py
  1. In the GUI:
    • ✍️ Enter your name
    • βœ… Tick consent box
    • 🟒 Register Face β†’ Press c to capture, q to quit camera
    • πŸ”‘ Login with Face β†’ Face the camera directly
    • ❌ Delete Face Data β†’ Enter name + delete
    • πŸ“‹ View Registered Users β†’ Show all users

πŸ“ Logs

All important actions (register, login, delete) are stored in:

facial_auth.log

⚠️ Disclaimer

This project is for educational purposes only.
It is not production-ready and must not be used for real-world security systems.


🎨 Preview

s3 s2 s1

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages