🔐 PyGenPass

A modern, desktop-based password generator built with Python and CustomTkinter. Features a sleek dark UI with purple accents, slot-machine animation, entropy display, coloured character preview, and password history.

---

✨ Features

• Slot-machine animation – password "rolls" through random characters before revealing the final result
• Strength meter – 5-segment bar with labels: Very Weak → Very Strong
• Entropy display – shows bits of entropy (e.g. 89.6 bits) for each generated password
• Coloured character preview – each character is colour-coded by type:
  • 🟡 Yellow – Uppercase (A–Z)
  • 🔴 Red – Lowercase (a–z)
  • 🟢 Teal – Digits (0–9)
  • 🌸 Pink – Special characters
• Toggle switches – pill-shaped toggles for selecting character types
• Adjustable length – slider from 3 to 30 characters with live display
• Auto-regenerate – password updates automatically when you change settings
• History – keeps last 10 passwords with strength, entropy, and time; copy any with one click
• Keyboard shortcuts – Ctrl+G generate, Enter generate, Ctrl+C copy, Ctrl+H clear history
• Custom icon – purple lock icon matching the app's colour palette

---

📸 Screenshot

---

🚀 Getting Started

Requirements

• Python 3.10 or newer
• pip

Installation

git clone https://github.com/theprzemoo/PyGenPass.git
cd PyGenPass
pip install -r requirements.txt

Run

python main.py

Or on Windows, double-click run.bat.

---

📁 Project Structure

PyGenPass/
├── main.py                # Main application
├── icon.ico               # App icon
├── run.bat                # Windows launcher
├── requirements.txt       # Dependencies
├── LICENSE                # MIT License
└── README.md              # This file

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl+G / Enter	Generate password
Ctrl+C	Copy to clipboard
Ctrl+H	Clear history

---

🛠️ Built With

• Python – core language
• CustomTkinter – modern UI framework
• pyperclip – clipboard support

---

📄 License

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