PyPassManager

PyPassManager is a command-line program that allows you to securely store and manage your passwords. It uses the Fernet encryption module from the Cryptography library to encrypt and decrypt passwords.

Getting Started

To get PyPassManager up and running, follow these steps:

Clone the Repository:

Clone this repository to your local machine using Git:

   git clone https://github.com/av1155/PyPassManager.git

Navigate to the Project Directory

Change your current directory to the project folder:

   cd PyPassManager

Install Dependencies

Before using PyPassManager, you need to install the required Python libraries. Make sure you have Python 3.x installed. You can easily install these dependencies by running the following command:

pip install -r requirements.txt

This command will read the REQUIREMENTS.txt file and install the necessary libraries, including:

cryptography==3.4.8
tabulate==0.8.9
colorama==0.4.4
pwinput==0.4.1

Run PyPassManager

To start PyPassManager, run the following command:

python pypassmanager.py

The program will first check if a master password has been set. If not, you will be prompted to set one. The master password must be at least 8 characters long, and it should contain at least one uppercase letter, one lowercase letter, one number, and one special character.

Enjoy Secure Password Management

Once you have set the master password and logged in, you can use the available commands to manage your passwords securely.

view: View all stored passwords.
add: Add a new password.
edit: Edit an existing password.
delete: Delete an existing password.
exit: Exit the program.

That's it! You are now ready to use PyPassManager for secure password management.

File System

PyPassManager utilizes a file-based system for secure password management:

Key File (key.key):

When you run the PyPassManager for the first time, it generates an encryption key (Fernet key).
This key is then written to a file named key.key.

Master Password File (master_password.txt):

If the master_password.txt file does not exist, it prompts you to set a master password.
The master password is required to access the PyPassManager program.
The master password is stored in an encrypted form within this file.

Encrypted Passwords File (passwords.encrypted):

This file stores all the passwords in an encrypted format.
When you add a password, it is encrypted using the Fernet key and then stored in this file.
Each line in this file contains the website, username, and the encrypted password, separated by a vertical bar |.

File Paths:

The script uses specific file paths to locate these files, such as key_file_path, passwords_encrypted_file_path, and master_password_file_path.
These paths are constructed based on the script's location.

File Existence Checks:

The script checks for the existence of these files:
- If the passwords.encrypted file exists but the master_password.txt file doesn't, it deletes the passwords.encrypted file. This prevents unauthorized access.
- If neither the passwords.encrypted nor the master_password.txt file exists, it proceeds to create them.

Encryption and Decryption:

The Fernet key stored in key.key is used for both encryption and decryption.
When viewing, editing, or deleting passwords, the script decrypts the passwords from the passwords.encrypted file using the Fernet key.
When adding a password, it encrypts the password with the Fernet key before appending it to the passwords.encrypted file.

These file-based operations ensure that the passwords are stored securely in an encrypted format, and the master password is used to control access to the program and the decrypted passwords.

Details

Adding a Password

To add a new password, use the add command. You will be prompted to enter a username and a password. The password must be at least 8 characters long, and must contain at least one uppercase letter, one lowercase letter, one number, and one special character.

Viewing Passwords

To view all stored passwords, use the view command. The program will display the username and password for each stored password.

Editing a Password

To edit an existing password, use the edit command. You will be prompted to enter the username for the password you want to edit, and then to enter the new password. The new password must meet the same requirements as when adding a password.

Deleting a Password

To delete an existing password, use the delete command. You will be prompted to enter the username for the password you want to delete.

Security

PyPassManager uses the Fernet encryption module from the Cryptography library to encrypt and decrypt passwords. The encryption key is stored in a file named key.key, which is generated automatically if it doesn't already exist. The key is used to create a Fernet object, which is then used to encrypt and decrypt passwords.

The encrypted passwords are stored in a file named passwords.encrypted. This file is also created automatically if it doesn't already exist. The file is in plain text format, with each line containing the username and encrypted password for a single password, separated by a vertical bar |.