AES256_Passwd_Store script securely encrypts or decrypts passwords on disk within a custom database file. It also features functionality to retrieve passwords from a previously generated database file.

This script takes a master password from stdin/from memory, then hashes the password using the specified hashing algorithm passed to the algorithm parameter/-a (scrypt, sha256) and finally AES-256 encrypts/decrypts the file’s data using the algorithm’s hash as the AES-256 key.

When providing the ‘scrypt’ argument to the algorithm parameter the script will generate a custom scrypt salt per each database file edit or creation. The uniquely generated salt is base64 encoded and prepended to each database file’s encrypted bytes separated by carriage return line feed bytes (for parsing) as meta-data.

When using the change password parameter/-cp the script will decrypt the database file’s data into memory, write random bytes*WIPE_PASSES to the database file, truncate the file and finally write the new data AES-256 encrypted with the new hashed master password to the database file. Effectively making data recovery/forensics difficult.

Example Usage Using Script As The Hashing Algorithm

Create a database file

python3 -a scrypt -c

Change master password for a database file

python3 -a scrypt -cp

Edit a database file

python3 -a scrypt -e

Query data from within the database file

python3 -a scrypt -q


# Add entry to the database/modify existing data:
# Delete existing data:
# -q parameter: Query data (entering nothing dumps all data):
# Press ctrl+D (linux) or ctrl+Z (windows) to save data from stardard in