https://github.com/tharun-ship-it/password-vault-pro
πSecure password vault with SHA-256 hashing & real-time security analysis. Built with Python/Tkinter for desktop and HTML/CSS/JS for the interactive web demo.
https://github.com/tharun-ship-it/password-vault-pro
cross-platform css3 desktop-application html5 javascript offline-first open-source-project password-generator password-manager python3 security sha256 tkinter-gui
Last synced: 2 months ago
JSON representation
πSecure password vault with SHA-256 hashing & real-time security analysis. Built with Python/Tkinter for desktop and HTML/CSS/JS for the interactive web demo.
- Host: GitHub
- URL: https://github.com/tharun-ship-it/password-vault-pro
- Owner: tharun-ship-it
- License: mit
- Created: 2025-12-25T05:41:04.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-25T08:07:37.000Z (7 months ago)
- Last Synced: 2025-12-26T19:54:30.591Z (7 months ago)
- Topics: cross-platform, css3, desktop-application, html5, javascript, offline-first, open-source-project, password-generator, password-manager, python3, security, sha256, tkinter-gui
- Language: Python
- Homepage: https://tharun-ship-it.github.io/password-vault-pro/
- Size: 111 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
π Password Vault Pro
A modern, feature-rich password manager with beautiful dark UI
Features β’
Live Demo β’
Installation β’
Screenshots β’
Technologies β’
Architecture
---
## π― Overview
Password Vault Pro is a **secure, offline password manager** with a stunning dark-themed interface. The desktop application is built with **Python and Tkinter**, while the interactive web demo uses **HTML5, CSS3, and JavaScript**. It offers enterprise-level features like master password protection, password recovery options, smart service categorization, and password strength analysis.
---
## π Live Demo
Experience Password Vault Pro directly in your browser! No installation required.
> **Demo Password:** `demo123`
---
## β¨ Features
### π¨ Modern Dark UI
- Beautiful gradient dark theme
- Smooth animations and hover effects
- Intuitive tabbed interface
- Responsive design
### π Security Features
| Feature | Description |
|---------|-------------|
| **Master Password** | SHA-256 hashed protection |
| **Password Strength Meter** | Real-time strength analysis |
| **Password Recovery** | Email & hint-based recovery |
| **Local Storage** | All data stored locallyβno cloud |
### π Smart Organization
- **8 Pre-built Categories**: Social Media, Streaming, Email, Development, Cloud Storage, Finance, Shopping, Work
- **50+ Service Suggestions**: Quick-add buttons for popular services
- **Search & Filter**: Instantly find any password
- **Category Browser**: Visual grid of all supported services
### β‘ Quick Actions
- One-click service addition (Gmail, GitHub, Netflix, etc.)
- Auto-category detection
- Bulk delete with confirmation
- Password visibility toggle
---
## π¦ Installation
### Prerequisites
- Python 3.7 or higher
- Tkinter (included with most Python installations)
### Quick Start
```bash
# Clone the repository
git clone https://github.com/tharun-ship-it/password-vault-pro.git
cd password-vault
# Run the application
python src/vault.py
```
### Install as Package
```bash
pip install -e .
password-vault # Run from anywhere
```
---
## πΈ Screenshots
### Login Screen
Secure master password authentication with password recovery options.
### Add Password Tab
Quick-add buttons, form validation, and real-time password strength indicator.
### My Passwords Tab
Searchable list with category tags, view/delete actions, and bulk operations.
### Categories Browser
Visual grid of 50+ services organized into 8 categories for quick addition.
---
## π Technologies
This project uses **two implementations** to showcase both desktop and web development skills:
### Desktop Application (Python)
| Technology | Purpose |
|------------|---------|
|  | Core application logic |
|  | GUI framework |
| `hashlib` | SHA-256 password hashing |
| `json` | Data storage |
| `pathlib` | Cross-platform file handling |
### Live Demo (Web)
| Technology | Purpose |
|------------|---------|
|  | Page structure |
|  | Styling & animations |
|  | Interactive functionality |
### Why Two Implementations?
- **Desktop App**: Demonstrates Python skills, OOP, GUI development, security best practices
- **Web Demo**: Allows recruiters to try the app instantly without installation, showcases HTML/CSS/JS skills
---
## π Architecture
```
password-vault-pro/
βββ src/
β βββ __init__.py # Package initialization (Python)
β βββ vault.py # Main desktop app - 700+ lines (Python + Tkinter)
βββ tests/
β βββ test_vault.py # Unit tests (Python)
βββ assets/
β βββ screenshot.png # App screenshot
βββ index.html # Live web demo (HTML + CSS + JavaScript)
βββ .github/
β βββ workflows/ci.yml # CI/CD pipeline (YAML)
βββ requirements.txt # Dependencies (none!)
βββ setup.py # Package config (Python)
βββ pyproject.toml # Modern Python config
βββ LICENSE # MIT License
βββ README.md # Documentation (Markdown)
```
### Data Storage
```
~/.password_vault_pro/
βββ config.json # Master password hash, recovery email, hint
βββ vault.json # Stored credentials (JSON format)
```
### Security Model
| Component | Implementation |
|-----------|----------------|
| Master Password | SHA-256 hash (never stored plain) |
| Recovery Options | Email + Phone Number + Custom Hint |
| Password Display | Masked with π eye toggle to reveal |
| Password Strength | Real-time meter (Weak β Excellent) |
| Storage | Local filesystem only (offline) |
---
## π§ͺ Testing
```bash
# Run unit tests
python -m pytest tests/ -v
# Run with coverage
python -m pytest tests/ --cov=src --cov-report=html
```
---
## π£ Roadmap
- [x] Master password with recovery
- [x] Password strength indicator
- [x] Category-based organization
- [x] Quick-add service buttons
- [x] Search and filter
- [x] Live web demo
- [ ] Password generator
- [ ] Export/import (CSV, JSON)
- [ ] Browser extension
- [ ] Mobile companion app
---
## π€ Contributing
Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) first.
```bash
# Fork and clone
git clone https://github.com/YOUR_USERNAME/password-vault.git
# Create branch
git checkout -b feature/amazing-feature
# Commit and push
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature
# Open Pull Request
```
---
## π License
This project is licensed under the MIT Licenseβsee the [LICENSE](LICENSE) file for details.
---
## π€ Author
**Tharun Ponnam**
* GitHub: [@tharun-ship-it](https://github.com/tharun-ship-it)
* Email: tharunponnam007@gmail.com
---
**β If you find this project useful, please consider giving it a star!**
* [π Live Demo](https://tharun-ship-it.github.io/password-vault-pro/)
* [π Report Bug](https://github.com/tharun-ship-it/password-vault-pro/issues)
* [β¨ Request Feature](https://github.com/tharun-ship-it/password-vault-pro/pulls)