RSMangler

RSMangler will take a wordlist and perform various manipulations on it similar to those done by John the Ripper the main difference being that it will first take the input words and generate all permutations and the acronym of the words (in order they appear in the file) before it applies the rest of the mangles, for example given the following three input words:

  • freds
  • national
  • bank

RSMangler would generate the following initial word list:

  • freds
  • national
  • bank
  • fredsnational
  • fredsbank
  • nationalfreds
  • nationalbank
  • bankfreds
  • banknational
  • fredsnationalbank
  • fredsbanknational
  • nationalfredsbank
  • nationalbankfreds
  • bankfredsnational
  • banknationalfreds
  • fnb

Each of these new words is then subject to the other mangles, because of this I strongly recommend with permutations mode enabled (default) you use a very small wordlist, 3 start words create a final list containing 5345 words and 5 start words creates a list containing 108557. As a test we tried it with a few hundred words and gave up when the process memory usage hit 3G.

If you try to use a file with more than 5 words you will get a warning and the option to abort.

Other mangles include adding the numbers 1 to 123 to the start and end, 01 to 09 to the start and end, various case manipulations, leet speak, word reversal, ed and ing on the end and doubling words up.

New mangles in 1.1 are adding all years between 1990 and this year to the start and end and adding sys, admin, pw and pwd to the start and end.

The initial wordlist can either be specified as a file or can be piped in through STDIN. Output goes to STDOUT (screen) by default but can be sent to a file through the --output parameter.

By default, the script does not output any duplicate mangled words. Prior to version 1.5, this was done by caching all the mangled words in memory and, before sending the words to screen, using the uniq function to strip any duplicates. This caused the app to use up a lot of memory as it had to store potentially thousands of strings before finally running the output. At a sugestion by Thomas d'Otreppe, the app now generates a CRC32 of each word and, if it has not seen the value before, sends it to be output and stores the CRC. If it has seen it, then it just drops the word. This allows the mangled words to be output as soon as they are generated while keeping memory usage to a minimum as it only requires the storage of a single integer per word rather than a full string. The option to remove duplicates can also be disabled, this makes for faster output and removes memory usage.

Installation

Just make the script executable, it doesn't rely on any gems or anything external.

Usage

Note, all mangle options are ON by default, these parameters turn them OFF.

rsmangler.rb [OPTION]

--help, -h: show help
--file, -f: the input file, use - for STDIN
--perms, -p: permutate all the words
--double, -d: double each word
--reverse, -r: reverser the word
--leet, -t: l33t speak the word
--full-leet, -T: all posibilities l33t
--capital, -c: capitalise the word
--upper, -u: uppercase the word
--lower, -l: lowercase the word
--swap, -s: swap the case of the word
--ed, -e: add ed to the end of the word
--ing, -i: add ing to the end of the word
--punctuation: add common punctuation to the end of the word
--pna: add 01 - 09 to the end of the word
--pnb: add 01 - 09 to the beginning of the word
--na: add 1 - 123 to the end of the word
--nb: add 1 - 123 to the beginning of the word
--years: add all years from 1990 to current year to start and end
--acronym: create an acronym based on all the words entered in order and add to word list
--common: add the following words to start and end: admin, sys, pw, pwd
--force: don't give the warning about list length
--allow-duplicates - allow duplicates in the output list

Change Log

  • 28.09.2017 - v1.5
    • Stopped caching output in memory
    • Added the option to allow duplicate in output - uses less memory
    • Added the option to output to file
    • Improved the leet conversions
  • 23.10.2012 - v1.4
    • Added full leetspeak option, thanks Felipe Molina (@felmoltor)
    • Added Support for ruby 1.9.x
  • 24.08.2010 - v1.1
    • Added three new mangles - years, acronym, and common.
  • 13.07.2010 - v1.0
    • Initial release

Licence

This project released under the Creative Commons Attribution-Share Alike 2.0 UK: England & Wales.

Credits

  • Thanks to Thomas d'Otreppe for helping bring the project back to life after 5 years of neglect.
  • Thanks to Felipe Molina for the initial l33t speak functions.
  • Credit to Gavin Watson who had the original idea for this project.

Bugs, Comments, Feedback

Feel free to get in touch, ideally through the GitHub issues pages.

Project Categories

Support The Site

I don't get paid for any of the projects on this site so if you'd like to support my work please use the link below when buying from Amazon and I will receive a small commission on all purchases.