Skip to content
RSMangler will take a wordlist and perform various manipulations on it similar to those done by John the Ripper with a few extras.
Branch: master
Clone or download
Latest commit 3de8a72 Sep 28, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
rsmangler.rb print in acronyms as well Aug 28, 2017

RSMangler: Take a wordlist and mangle it

Copyright(c) 2017, Robin Wood

Version 1.5

RSMangler will take a wordlist and perform various manipulations on it similar to those done by John the Ripper with a few extras. The main new feature is permutations mode which takes each word in the list and combines it with the others to produce all possible permutations (not combinations, order matters). For example the words freds, fresh, fish will produce the following list:


It also creates an acronym from the words in order, for example the terms


would give the acronym "psm". This acronym is then added to the list of terms used in the rest of the mangling.

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.


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


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


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

( )


  • 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,

You can’t perform that action at this time.