password-wallet 0.1.1

Administrador de billeteras porque soy imbecil y me olvido de la mayoria de contraseñas complejas

Password Wallet

A terminal-based password manager that stores encrypted credentials and copies them to your clipboard, automatically clearing after 5 seconds.

Installation

pip install password-wallet

Usage

Password Wallet uses two files:

• A key file — stores the cryptographic salt for master password derivation
• A vault file — stores your encrypted credentials

First time setup

password-wallet key_file vault_file

You will be prompted to create a master password. Both files will be created automatically.

Adding a credential

password-wallet key_file vault_file --new-password

Follow the prompts to enter the username, platform name, and password.

Listing credentials

password-wallet key_file vault_file --list

Displays all stored usernames and platforms.

Searching and copying a password

password-wallet key_file vault_file --search-pass "GitHub"

Copies the password to the clipboard and clears it after 5 seconds. If multiple users exist for the same platform, you can select one interactively.

Deleting a credential

password-wallet key_file vault_file --delete-pass "GitHub"

How it works

Step	Detail
Key derivation	Master password is derived using Argon2id, a memory-hard KDF resistant to GPU/ASIC attacks
Encryption	Credentials are encrypted with Fernet (AES-128-CBC + HMAC-SHA256)
Clipboard	Passwords are copied via pyperclip and automatically cleared after 5 seconds
Salt	The salt is stored in the key file; without both the key file and the master password, decryption is infeasible

File structure

• Key file — contains the Argon2 salt (binary, 16 bytes)
• Vault file — contains the encrypted JSON blob with all credentials

Note: Losing either the key file or the master password makes your data unrecoverable.