A secure, open-source password manager built with Python and tkinter.
4ab71b1465
- Current priority tasks - Core feature implementations - UI improvements - Security enhancements - Testing requirements - Documentation needs - Future database migration plans - Phase 1: Core functionality and security - Phase 2: UI and organization features - Phase 3: Advanced features and database - Phase 4: System integration and extensions |
||
|---|---|---|
| assets/images | ||
| src | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
| requirements.txt | ||
| TODO.md | ||
🐨 KeyKoala
A secure, lightweight, and user-friendly password manager built with Python.
🚀 Features
- 🔐 Master password protection
- 🔒 Strong encryption using Fernet
- 📋 Quick copy passwords to clipboard
- 💾 Secure local storage
- 🖥️ Clean, intuitive GUI
- 🏃 Lightweight and fast
- 📱 Cross-platform support
🛠️ Installation
- Clone the repository
git clone https://github.com/yourusername/keykoala.git
cd keykoala
- Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- Install dependencies
pip install -r requirements.txt
- Install tkinter (if not already installed)
Ubuntu/Debian:
sudo apt-get install python3-tk
Fedora:
sudo dnf install python3-tkinter
macOS:
brew install python-tk
🏃♂️ Running KeyKoala
From the project root directory:
PYTHONPATH=$PYTHONPATH:$(pwd) python src/main.py
🔒 Security Features
- Strong encryption using Fernet (symmetric encryption)
- Master password never stored, only used for key derivation
- Passwords only decrypted when copying to clipboard
- All data stored locally on your machine
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📝 Development Tasks
- Password generation functionality
- Password strength checker
- Import/export functionality
- Dark mode support
- Password categories/folders
- Auto-logout feature
- Two-factor authentication
- Browser extension
🐛 Known Issues
- None reported yet
📦 Dependencies
- Python 3.7+
- tkinter
- cryptography
- pyperclip
⚠️ Disclaimer
KeyKoala is a demonstration project and should not be used as your primary password manager without thorough security auditing. For sensitive information, please use established password managers like Bitwarden, LastPass, or 1Password.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Inspired by modern password managers
- Built with Python's cryptography library
- Uses tkinter for the GUI
📧 Contact
- Project Maintainer: Blake Ridgway
- Project Link: https://github.com/blakeridgway/keykoala
🌟 Support
If you find this project helpful, please give it a star! ⭐
Made with ❤️ by Blake Ridgway
```