hashdog

hashdog is a lightweight, pure‑Python implementation of a hash‑cat clone. It reads a wordlist, hashes each entry using the specified algorithm, and stops as soon as a match with the target hash is found.

Installation

hashdog can be installed globally with pipx, ensuring it never interferes with your other Python projects.

# Install pipx if you don't have it yet
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Install hashdog
pipx install hashdog

A normal pip install works as well:

python3 -m venv .venv
source .venv/bin/activate
pip install hashdog

Usage

hashdog <TARGET_HASH> <DICTIONARY_FILE> [-m ALGORITHM]

• TARGET_HASH – The hash value you want to crack (hexadecimal string).
• DICTIONARY_FILE – Path to the wordlist; one candidate password per line.
• -m ALGORITHM – Optional. Hash algorithm to use.
  Defaults to md5. Supported values: md5, sha1.

Example

# Crack an MD5 hash with a local wordlist
hashdog d41d8cd98f00b204e9800998ecf8427e ./rockyou.txt

Supported Algorithms

Future extensions may add more algorithms; just modify the hash_password helper.

License

MIT © cylab

See the LICENSE file for details.