PassForge Pro | Indestructible Identity Vault

</div>

English

🔐 About PassForge Pro

PassForge Pro is a zero-knowledge, local-first password vault built with paranoia-grade security. Designed to withstand even aggressive state-level forensic analysis, it stores your credentials in an AES-256 encrypted SQLite database that never leaves your machine.

This is not just a password manager—it is a cryptographic fortress designed for advanced security professionals and individuals requiring absolute digital sovereignty.

🎯 Core Philosophy

Zero-Knowledge Architecture: Your master password never leaves RAM. We can't access your data—ever.
Local-First: No cloud sync, no telemetry, no network connections. Your vault = your machine.
Memory-Safe: Sensitive data is wiped from RAM immediately after use.
Open Source: Every line of code is auditable on GitHub.

🛡️ Strategic Security Protocols

Military-Grade Encryption: AES-256 GCM / Fernet authenticated encryption
Adaptive KDF: PBKDF2-HMAC-SHA256 (150,000 iterations) + BCrypt (12 rounds)
Ghost Protocol: Signature masking in system directories to evade static analysis
Noisy Wipe: Multi-pass recursive sector overwriting for secure data destruction
Autonomous Locking: Inactivity-based memory purging and vault closure
Clipboard Sanitation: Automated background wiping of sensitive data from OS clipboard

⚠️ Legal Disclaimer

IMPORTANT: This application is provided "AS-IS" without any warranty. We do NOT provide state-level, government-certified, or military-grade security guarantees.

By using this software:

You accept full responsibility for your data security and vault management.
You acknowledge compliance with local laws (TCK, KVKK, BTK for Turkish users).
You understand that lost master passwords result in irreversible data loss. No recovery mechanism exists by design.
Legal Compliance: Users are responsible for ensuring their use complies with all local and international digital privacy and encryption laws.
Security Auditing: While designed for high-end security, PassForge Pro should be used with robust operational security (OpSec) practices (e.g., air-gapped devices for maximum protection).

For more details, review our Privacy & Security Policy.

✨ Features

| Feature | Description | |---------|-------------| | 🔒 AES-256 GCM Encryption | Military-standard authenticated encryption | | 🔑 PBKDF2-HMAC-SHA256 | 150,000+ iterations for key derivation | | 🧠 Memory Purging | RAM wiped on lock, exit, or inactivity | | 📋 Clipboard Sanitization | Auto-clear after 10-60 seconds | | ⏱️ Auto-Lock Timer | Configurable inactivity timeout | | 🎨 7 Premium Themes | Cyberpunk, Midnight, Neon, and more | | 📁 Folder Hierarchy | Unlimited nested categories | | 🔄 Trash Recovery | 30-day soft delete before permanent wipe | | 🎲 Password Generator | Cryptographically secure random passwords |

📥 Installation & Setup

Prerequisites

Python 3.8+
Windows 10/11 or Linux
Administrator privileges (for system-level operations)

Step 1: Clone Repository

git clone https://github.com/can-deliktas/PassForgePro.git

Switch to Project Directory

cd PassForgePro

Step 2: Install Dependencies

pip install -r requirements.txt

Step 3: Launch Application

python PassForgePro.py

🎯 Usage (GUI)

First Run

Launch the application
Enter a strong master password (minimum 8 characters)
Select or create a vault location (.db file)
Access your encrypted vault

Interface Overview

| Screen | Purpose | |--------|---------| | Login | Master password entry with entropy indicator | | Vault | Browse, search, and manage credentials | | Generator | Create random passwords with custom rules | | Settings | Configure auto-lock, clipboard timeout, themes | | Trash | Recover or permanently delete entries |

Preview Images

<details> <summary>🖼️ Click to view screenshots</summary>

- Login Screen: The authentication screen where the user logs in using the master password.
- Vault Authentication: Additional verification step required to access a selected vault.
- Active Vault View: Main interface displaying stored entries, folders, and credentials inside the vault.
- Save / Edit Entry: Screen for creating a new password entry or editing an existing one.
- Copy Action: Visual feedback indicating that a username or password has been copied to the clipboard.
- Add Root Folder: Interface for creating a new top-level folder in the vault.
- Add Subfolder: Screen for adding a subfolder inside an existing folder.
- Recycle Bin: Section where deleted entries are listed and can be restored or permanently removed.
- Settings Panel: Area for managing application preferences, security options, and themes.
- Password Generator: Tool for generating strong and random passwords based on selected criteria.
- Theme 1: First available visual theme of the application.
- Theme 2: Alternative theme with a different color palette.
- Theme 3: Theme featuring different contrast and UI highlights.
- Theme 4: Dark-focused theme option.
- Theme 5: Light-colored alternative theme design.
- Theme 6: Minimal and modern interface theme.
- Theme 7: Additional theme option with unique accent colors.

</details>

🗂️ Project Structure

PassforgeV2/
├── passforgepropy/          # Python Application
│   ├── PassForgePro.py      # Main application (GUI + Logic)
│   ├── requirements.txt     # Python dependencies
│   ├── LICENSE              # GNU GPL-3.0
│   ├── README.md            # This file
│   └── .github/
│       └── ISSUE_TEMPLATE/
│           ├── bug_report.md
│           └── feature_request.md

📝 License and Copyright

PassForge Pro is licensed under the GNU General Public License v3.0 (GPL-3.0).

✅ You may use, modify, and distribute this software
✅ You must include the original copyright notice
✅ You must disclose source code for derivative works
❌ No warranty is provided

🤝 How to Contribute?

Fork the repository
Create a feature branch: git checkout -b feature/AmazingFeature
Commit your changes: git commit -m 'Add AmazingFeature'
Push to the branch: git push origin feature/AmazingFeature
Open a Pull Request

Reporting Issues

Use the Bug Report Template
Use the Feature Request Template

👨‍💻 Developer Notes

Security Architecture

Encryption: Fernet (AES-256-GCM) via cryptography library
KDF: PBKDF2 with HMAC-SHA256, 150k iterations, 16-byte salt
Memory: bytearray for passwords, explicit zeroing
Database: SQLite with encrypted BLOB storage

Code Highlights

# Key Derivation
kdf

PassForgePro

Install / Use

README