Skip to content
This repository was archived by the owner on Feb 18, 2025. It is now read-only.

Commit 0c3e068

Browse files
committed
Update Readme
1 parent 4d89642 commit 0c3e068

File tree

1 file changed

+43
-0
lines changed

1 file changed

+43
-0
lines changed

README.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,46 @@
22
Parse through a wordlist and get only the entries you want. Useful for limiting wordlists for brute-force attacks when password policy is known
33

44
## Quick Start
5+
To get started, Download the latest release or compile from source
6+
7+
```
8+
# listparse help
9+
$ listparse -h
10+
usage: list-parse [-h|--help] -w|--wordlist "<value>" -o|--output "<value>"
11+
[-m|--min-length "<value>"] [-x|--max-length "<value>"]
12+
[-p|--phrase "<value>"] [-s|--require-special-characters]
13+
[-n|--require-number] [-r|--replace-letters]
14+
15+
Creates more customized wordlist
16+
17+
Arguments:
18+
19+
-h --help Print help information
20+
-w --wordlist Wordlist to parse through; Full path to
21+
wordlist
22+
-o --output File to output to
23+
-m --min-length Minimum length of line. Default: 0
24+
-x --max-length Maximum length of line. Default: 0
25+
-p --phrase Phrase/word that is required to be in the
26+
line. Default:
27+
-s --require-special-characters Require special characters
28+
-n --require-number Require Number
29+
-r --replace-letters Replace Letters with special characters in
30+
phrase search
31+
```
32+
*Please note -r currently does not work*
33+
## Examples
34+
```
35+
# Get all lines with only 8 characters and require special characters
36+
$ listparse -w rockyou.txt -o outfile.txt -m 8 -x 8 -s
37+
```
38+
39+
```
40+
# Get all lines that contains numbers
41+
$ listparse -w rockyou.txt -o outfile.txt -n
42+
```
43+
44+
```
45+
# Get all lines that contain the phrase "pass"
46+
$ listparse -w rockyou.txt -o outfile.txt -p pass
47+
```

0 commit comments

Comments
 (0)