# Password Manager

A command-line password manager written in C.

---

## How to Build

Make sure GCC is installed. Open a terminal in the folder containing `password_manager.c` and run:

```
gcc -o password_manager password_manager.c
```

If the command completes with no error messages, the build was successful and an executable called `password_manager` has been created.

---

## How to Run

```
./password_manager
```

The program runs interactively in the terminal. Type the number of the option you want and press Enter.

---

## Menu Options

When the program starts you will see:

```
  +--------------------------------+
  |       PASSWORD MANAGER         |
  +--------------------------------+
  |  1. Add entry                  |
  |  2. List all entries           |
  |  3. Search by service          |
  |  4. Delete entry               |
  |  5. Exit                       |
  +--------------------------------+
```

**Option 1 - Add entry**
Prompts you for a service name, username, and password. All three fields must be filled in. The entry is encoded and saved to `passwords.txt`.

Example:
```
  Enter service name : gmail
  Enter username     : alice@gmail.com
  Enter password     : mypassword99
```

**Option 2 - List all entries**
Displays all saved entries decoded and readable, numbered from 1. If nothing has been saved yet, a message says so.

**Option 3 - Search by service**
Prompts for a service name and prints every entry that matches exactly. Service names are case-sensitive, so `Gmail` and `gmail` are treated as different.

**Option 4 - Delete entry**
Prompts for a service name and removes all entries with that name. You will be told how many were deleted.

**Option 5 - Exit**
Closes the program.

---

## Data File

All entries are stored in `passwords.txt` in the same folder as the executable. The file is created automatically the first time you add an entry. Its contents appear as garbled characters because everything is encoded before being saved. This is expected and correct behaviour.

---

For full technical details and testing see `documentation.txt`.