Skip to content

inor-w/Password-Gen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

🔐 Secure Password Generator

A secure, privacy-focused password generator available as both a Python script and a browser extension. Generate cryptographically secure passwords locally - no data stored, no network requests, completely private.

✨ Features

  • 🔒 Cryptographically Secure: Uses secure random number generation
  • 🏠 100% Local: All generation happens on your device
  • 🚫 No Storage: Passwords are never saved anywhere
  • 🌐 Zero Permissions: Browser extension requires no permissions
  • 📱 Cross-Platform: Python script works anywhere, extension works in Chrome/Firefox/Edge
  • 🎨 Modern UI: Beautiful, intuitive interface for the browser extension

📦 What's Included

1. Python Script (password_generator.py)

A command-line password generator that works on any system with Python 3.

Usage:

python3 password_generator.py

2. Browser Extension (extension/)

A full-featured browser extension for Chrome, Firefox, and Edge.

Features:

  • Customizable password length (8-128 characters)
  • Toggle numbers and special characters
  • One-click copy to clipboard
  • Beautiful modern UI
  • Auto-generates on open

See the extension README for installation and usage instructions.

🚀 Quick Start

Python Script

python3 password_generator.py

Browser Extension

  1. Go to chrome://extensions/ (or edge://extensions/ for Edge)
  2. Enable "Developer mode"
  3. Click "Load unpacked"
  4. Select the extension folder

See extension/README.md for detailed instructions.

🔒 Security & Privacy

This tool is designed with security and privacy as top priorities:

  • ✅ Uses cryptographically secure random number generation
  • ✅ No data collection or tracking
  • ✅ No network requests
  • ✅ No password storage
  • ✅ Zero permissions required (extension)
  • ✅ Open source - review the code yourself

Best Practices:

  • Generate passwords locally (this tool)
  • Store passwords in a trusted password manager (Bitwarden, 1Password, etc.)
  • Use unique passwords for each account
  • Enable two-factor authentication (2FA) when available

📱 Browser Extension Stores

Want to install from the official stores? Check if it's available:

Or see PUBLICATION_GUIDE.md to publish your own version!

🛠️ Development

Requirements

  • Python 3.6+ (for the script)
  • Modern browser (for the extension)
  • Pillow (optional, for generating icons): pip install Pillow

Project Structure

Password-Gen/
├── password_generator.py      # Python CLI version
├── extension/                 # Browser extension
│   ├── manifest.json         # Extension manifest
│   ├── popup.html            # Extension UI
│   ├── popup.js              # Password generation logic
│   ├── popup.css             # Styling
│   ├── icons/                # Extension icons
│   ├── README.md             # Extension documentation
│   ├── PRIVACY_POLICY.md     # Privacy policy
│   └── PUBLICATION_GUIDE.md  # Store publication guide
└── README.md                 # This file

📝 License

Free to use and modify. No warranty provided.

🤝 Contributing

Contributions are welcome! Feel free to:

  • Report bugs
  • Suggest features
  • Submit pull requests
  • Improve documentation

⚠️ Disclaimer

This tool generates passwords but does not store them. Always use a password manager to securely store your generated passwords.

🔗 Links


Made with 🔒 for privacy and security

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published