Shortscan Utility (shortutil)

shortutil is a companion tool packaged with shortscan that provides helper functions for generating short filenames and creating custom rainbow tables.

Synopsis

shortutil <command> [<args>]

Commands

wordlist

This is the most powerful feature of shortutil. It processes a standard wordlist file and enriches it with 8.3 filename representations and pre-computed checksums, turning it into a rainbow table that shortscan can use for its de-checksumming feature.

Usage

shortutil wordlist [OPTIONS] <input-wordlist.txt> > <output.rainbow>

Options

  • --keepcase: By default, words are converted to uppercase. This flag preserves their original case.
  • --uniq: Ensures that the output contains only unique words. This is enabled by default.
  • --variants: In addition to the word itself, it generates checksums for different case variations (lowercase, UPPERCASE, Titlecase). This is highly recommended and enabled by default.

Example

To create a rainbow table from a file named common-files.txt:

shortutil wordlist common-files.txt > my-custom.rainbow

You can then use this file with shortscan:

shortscan --wordlist my-custom.rainbow http://example.org/

checksum

This command generates a single 8.3 filename checksum for a given string. This is useful for testing or manual analysis.

Usage

shortutil checksum [OPTIONS] <filename>

Options

  • -o, --original: Uses the older checksum algorithm found in Windows Server 2003 and XP. The default is to use the modern algorithm.

Example

To generate a checksum for index.html:

shortutil checksum index.html

Output: 

B31A