The Password Manager App is a Python-based application that allows users to securely store and manage their passwords. The app uses the cryptography library to encrypt and decrypt the passwords, and the pyperclip library to copy the passwords to the clipboard for easy retrieval.
To install and run the Password Manager App locally, follow these steps:
-
Clone the repository to your local machine:
git clone https://github.com/CireWire/password-manager.git
-
Change into the project directory:
cd password-manager
-
Create a virtual environment for the project and activate it:
python -m venv venv source venv/bin/activate
-
Install the required Python packages:
pip install -r requirements.txt
-
Set the encryption key environment variable:
export PASSWORD_MANAGER_KEY=your-secret-key
Note: replace "your-secret-key" with a secure key of your choice.
-
Run the app:
python password_manager.py
-
Access the app in your web browser at http://localhost:8000
To run the Password Manager App with Docker, follow these steps:
-
Clone the repository to your local machine:
git clone https://github.com/CireWire/password-manager.git
-
Change into the project directory:
cd password-manager
-
Build the Docker image:
docker build -t password-manager .
-
Set the encryption key environment variable:
export PASSWORD_MANAGER_KEY=your-secret-key
Note: replace "your-secret-key" with a secure key of your choice.
-
Run the Docker container:
docker run -p 8000:8000 -e PASSWORD_MANAGER_KEY=$PASSWORD_MANAGER_KEY password-manager
-
Access the app in your web browser at http://localhost:8000
Once the app is running, you can use the command-line interface or the web-based user interface to interact with the app. Here are some examples of usage:
-
Add a new password to the password manager:
python password_manager.py add gmail mypassword123
-
Retrieve a password from the password manager and copy it to the clipboard:
python password_manager.py get gmail
Note: this will copy the password to the clipboard automatically.
-
List all the passwords stored in the password manager:
python password_manager.py list
-
Delete a password from the password manager:
python password_manager.py delete gmail
-
The Password Manager App is provided "as is" and without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability.
-
It is the responsibility of the user to choose a secure encryption key and to keep it safe. The Password Manager App does not store the encryption key