An open API service indexing awesome lists of open source software.

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.

Awesome Lists containing this project

README

          


Password Vault Pro Logo

πŸ” Password Vault Pro


A modern, feature-rich password manager with beautiful dark UI


Features β€’
Live Demo β€’
Installation β€’
Screenshots β€’
Technologies β€’
Architecture


Python 3.7+
Tkinter
HTML5
CSS3
JavaScript


MIT License
Zero Dependencies
Platform

---

## 🎯 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.


Password Vault Pro Screenshot

---

## πŸš€ Live Demo

Experience Password Vault Pro directly in your browser! No installation required.



Live Demo

> **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 |
|------------|---------|
| ![Python](https://img.shields.io/badge/Python-3776AB?style=flat&logo=python&logoColor=white) | Core application logic |
| ![Tkinter](https://img.shields.io/badge/Tkinter-FF6B6B?style=flat) | GUI framework |
| `hashlib` | SHA-256 password hashing |
| `json` | Data storage |
| `pathlib` | Cross-platform file handling |

### Live Demo (Web)
| Technology | Purpose |
|------------|---------|
| ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=flat&logo=html5&logoColor=white) | Page structure |
| ![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=flat&logo=css3&logoColor=white) | Styling & animations |
| ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=flat&logo=javascript&logoColor=black) | 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)