Skip to content
A Python implementation of Crackstion's Hash Lookup
Python C Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Updated readme Mar 19, 2018
Makefile Fix typo in Makefile Jun 26, 2015 Updated readme Mar 19, 2018 Removed exit on failed import Mar 21, 2018 Fixed lowercase Mar 19, 2018
checksort.c Gracefully handle utf-8 decoding errors Mar 30, 2018
requirements.txt Refactored for python3 Mar 19, 2018
sortidx.c First commit Nov 11, 2013

A Python Implementation of's Lookup Tables


There are three components to this system:

  1. The indexing script, which takes a wordlist and builds a lookup table index for a hash function and the words in the list.

  2. The indexing sorter program sortidx.c, which sorts an index created by the indexing script, so that the lookup script can use a binary search on the index to crack hashes.

  3. The lookup script, which uses the wordlist and index to crack hashes.

Suported Algorithms:

  • lm
  • md4
  • md5
  • msdcc
  • msdcc2
  • mssql41
  • mysql323
  • ntlm
  • oracle10g-sys
  • oracle10g-system
  • whirlpool
  • ripemd160
  • sha1
  • sha2-224
  • sha2-256
  • sha2-384
  • sha2-512
  • sha3-224
  • sha3-256
  • sha3-384
  • sha3-512

Indexing a Dictionary

Suppose you have a password dictionary in the file words.txt and you would like to index it for MD5 and SHA1 cracking.

First, create the MD5 and SHA1 indexes:

$ ./ -a md5 -w words.txt
$ ./ -a sha1 -w words.txt

Next, build the sortidx program and run it on the indexes.

$ make
$ ./sortidx -r 1024 words-md5.idx
$ ./sortidx -r 1024 words-sha256.idx

The -r parameter is the maximum amount of memory sortidx is allowed to use in Mb. The more memory you let it use, the faster it will go.

Cracking Hashes

Once you have generated and sorted the index, you can use the LookupTable class to crack hashes. It can be used as a library or a standalone app.

$ ./ -a md5 -i words-md5.idx -w words.txt -c 1f3870be274f6c49b3e31a0c6728957f

Adding Words

Once a wordlist has been indexed, you can not modify the wordlist file without breaking the indexes. Appending to the wordlist is safe in that it will not break the indexes, but the words you append (obviously) won't be indexed, unless you re-generate the index.

There is currently no way to add words to an index without re-generating the entire index.

You can’t perform that action at this time.