Narthex

Modular dictionary generator
git clone git://mcdim.xyz/Narthex.git
Log | Files | Refs | README | LICENSE

README.txt (4176B)

      1       _     ,,__  _
      2      ;=#  @#####=##@.
      3     '"":##="=###.#  "
      4       .=###,-'#####-
      5      ,:###=###;="  -=####.
      6   (:#.#####"##;:'.#####"##)
      7   /#=-###;"#'"####,####;
      8    "  \ \     ##="   "
      9         ":-. ##_
     10            '##=
     11             .##:.
     12 _ _  _  ___ ___ _ _ ___ _ _
     13 |\| |_| |_/  |  |_| |_   \/
     14 | | | | | \  |  | | |__  /\
     15  __________________________________________________________________________________________________
     16 | version 1.2.1 | language C | lines of code 1k | binaries 9 | dependencies 0 | license GNU GPLv3+ |
     17 
     18 Narthex (Greek: Νάρθηξ, νάρθηκας) is a modular & minimal dictionary generator for Unix and Unix-like operating
     19 system written in C and Shell. It contains autonomous Unix-style programs for the creation of personalised
     20 dictionaries that can be used for password recovery & security assessment. The programs make use of Unix text
     21 streams for the collaboration with each other, according to the Unix philosophy.
     22 It is licensed under the GPL v3.0.
     23 
     24 I made a video to explain the usage of Narthex:
     25 https://www.youtube.com/watch?v=U0UmCeLJSkk&t=938s (the timestamp is intentional)
     26 
     27 The tools
     28 =========
     29 nchance - A capitalization tool that appends the results to the bottom of the dictionary.
     30 ninc    - A incrementation tool that multiplies alphabetical lines and appends an n++ at the end of each line.
     31 ncom    - A combination tool that creates different combinations between the existing lines of the dictionary.
     32 nrev    - A reversing tool, that appends the reserved versions of the lines at the end of the dictionary.
     33 nleet   - A leetifier. Replaces characters with Leet equivalents, such as @ instead of a, or 3 instead of e.
     34 nclean  - A tool for removing passwords that don't meet your criteria (too short, no special characters etc.)
     35 napp    - A tool that appends characters or words before or after the lines of the dictionary.
     36 ngen    - A tool that generates permutations of given length & character set (works, but is under development).
     37 nwiz    - A wizard that asks for the infromation and combines the tools together to create a final dictionary.
     38 
     39 Screenshots
     40 ===========
     41 https://mcdim.xyz/projects/n/screens/narthex2.png
     42 https://mcdim.xyz/projects/n/screens/narthex1.png
     43 
     44 Dependencies
     45 ============
     46 Narthex has no hard dependencies, however there are two building dependencies, `GCC` and `Make`, which are both
     47 required in order to easily compile and install the binaries, but not to run them.
     48 
     49 Install
     50 =======
     51 In order to install, execute the following commands:
     52 
     53 	$ git clone https://github.com/MichaelDim02/Narthex.git && cd Narthex
     54 	$ sudo make install
     55 
     56 Usage
     57 =====
     58 For easy use, there is a wizard program, nwiz, that you can use. Just run
     59 
     60 	$ nwiz
     61 
     62 And it will ask you for the target's information & generate the dictionary for you.
     63 
     64 Advanced usage
     65 ==============
     66 If you want to make full use of Narthex, you can read the manpages of each tool. What they all do, really, is
     67 enhance small dictionaries. They are really minimal, and use Unix text streams to read and output data. For
     68 example, save a couple keywords into a textfile ```words.txt``` in a different line each, and run the following
     69 
     70 	$ cat words.txt | nhance -f | ncom | nleet a:@ | ninc 1 30 > dictionary.txt
     71 
     72 and you'll see the results for yourself. Alterantively, you can try this for a larger and more complicated dictionary:
     73 
     74 	$ cat words.txt | nhance -f | ncom -d .- | ninc 1 200 -d .- | nrev | nleet | napp -c '@#$' > dict1.txt
     75 
     76 The above, with just 4 keywords in words.txt (one of which was numerical), generated a wordlist of 2279744 passwords
     77 (38MB).
     78 
     79 As demonstrated, much like Unix utilities, the tools of Narthex can be thought of as building blocks, where the user
     80 has all the power to connect them in different possible ways to generate the desired list of passwords.
     81 
     82 Donate
     83 ======
     84 https://www.paypal.com/donate/?hosted_button_id=HZXXLD586P5CW
     85 
     86 More donation options on mcdim.xyz
     87 
     88 Links
     89 =====
     90 Website:	https://mcdim.xyz/projects/n
     91 Github:		https://github.com/MichaelDim02/Narthex
     92 Raw.pm: 	https://inventory.raw.pm/tools.html#Narthex
     93 BlackArch: 	https://blackarch.org/tools.html
     94 
     95 _ _  _  ___  _  _ _ ___
     96 |\| |_| |_/ |.| |_|  _
     97 | | | | |   |_| | | ___