# Password Control

Password Control is a lightweight web-based tool for generating, validating, and saving passwords.  
It features a dark cyber‑style interface, real‑time validation, SHA‑256 password generation, and secure saving to a local text file via PHP.

This project is fully client-side except for the save operation, which uses a simple PHP backend.

---

## Features

### Password Validation
- Minimum length: **10 characters**
- Must contain at least **one special character**
- Must contain at least **one number**
- Rejects **three repeated characters in a row**
- Validation runs **in real time** while typing

### Password Generation (SHA‑256)
- Deterministic password generation using the **Web Crypto API**
- User-defined **seed**
- Custom **output length**
- Instant generation

### Save Passwords to File
- Save passwords to a local text file (`passwords.txt`)
- Each password is saved with a **custom name**
- Uses a simple PHP endpoint (`save.php`)
- Appends entries in the format:
Name : Password

### User Interface
- Dark mode
- Clean, minimal, console-inspired design
- No external libraries required

---

## Project Structure

PasswordControl/
│── index.html        # Main UI and JavaScript logic
│── save.php          # Backend script that writes passwords to passwords.txt
│── passwords.txt     # Generated automatically; stores saved passwords
│── README.md         # Documentation

Codice

---

## Requirements

### Frontend
- Any modern browser supporting:
  - Web Crypto API
  - JavaScript ES6

### Backend
- PHP 7+ or PHP 8+
- Write permissions in the project directory

---

## How to Run

### 1. Start a local PHP server
The Web Crypto API requires a secure context, so open the project via localhost:

```bash
php -S localhost:8000
2. Open the application
Navigate to:

Codice
http://localhost:8000/index.html
3. Use the tool
Type a password → validation appears instantly

Generate a password using seed + length

Enter a name and click Save Password

Saved passwords appear in passwords.txt

Security Notes
Passwords are saved in plain text inside passwords.txt.
This tool is intended for local personal use, not production environments.

If you want encrypted storage (AES‑256), you can extend save.php.