Skip to content

aniketchavan2211/Password-Manager

Repository files navigation

🔐 Password Manager 🛡️

Python: 3.x License: MIT

Table of Contents

Overview

PassMe is an open-source Password Manager Tool written in Python 3. It securely generates and stores complex passwords, supporting custom and randomly generated passwords. It also includes features for key management, account creation, and password rotation.

Features

  • Strong Encryption: Utilizes industry-standard Fernet encryption for secure password storage.
  • User-Friendly Interface: Interactive command-line interface for ease of use.
  • Account Management: Supports account creation, username association, and password updates.
  • Key Rotation: Implements key rotation for enhanced security.

Getting Started

  1. Clone the repository.

    git clone https://github.com/aniketchavan2211/Password-Manager.git
    cd Password-Manager
  2. Install dependencies.

    pip install -r requirements.txt

    (Till yet no requirements.txt is uploaded.)

  3. Run the Password Manager.

    python3 main.py
  4. Follow the on-screen instructions to manage your passwords.

Installation

  1. Clone the git repo
git clone https://github.com/aniketchavan2211/Password-Manager.git
  1. Navigate to downloaded directory
cd Password-Manager
  1. Install dependencies
pip install -r requirements.txt

or

python3 -m pip install -r requirements.txt 

Usage

  1. Run the Password Manager:
python3 main.py

Run directly

# Give executable permission
chmod +x main.py

# Run
./main.py
  1. Follow the on-screen instructions to manage your passwords.

Command-Line Options

  • -h, --help: Display help menu.
  • -g, --generate: Generate a random password.
  • -u, --username: Specify the username for actions.
  • -cs, --create-account: Create a new user account.
  • -c, --create: Create a new password entry.
  • -s, --show: Show a stored password.
  • -k, --gen-key, -generate-key: Generate a new Fernet key.
  • -i, --import-key filename: Import a Fernet key from a file.
  • -e, --export-key filename: Export the Fernet key to a file.
  • -r, --rotate-key: Rotate the encryption key.

Contributing

We welcome contributions to enhance and improve the Password Manager. If you'd like to contribute, please review our Contribution Guidelines.

Security

For information on security updates, reporting vulnerabilities, and our security policy, refer to Security Guide.

License

The Password Manager project is licensed under the MIT License.

Versioning

We use Semantic Versioning for this project. For a complete list of changes, see Release Notes.

Contact

If you have any questions or suggestions, feel free to reach out to Aniket Chavan via Email or on Twitter. Instagram