.TH cewl "1" "Jun 2018" "CEWL 5.4.3" "custom word list generator"
.\" Text automatically generated by txt2man
.SH NAME
\fBcewl \fP- custom word list generator
.SH SYNOPSIS
.nf
.fam C
\fBcewl\fP [\fIOPTION\fP] \.\.\. \fIURL\fP
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
CeWL (Custom Word List generator) is a ruby app which spiders a given \fIURL\fP, up to a specified depth, and returns
a list of words which can then be used for password crackers such as John the Ripper. Optionally, CeWL can follow
external links.
.PP
CeWL can also create a list of email addresses found in mailto links. These email addresses can be used as
usernames in brute force actions.
.PP
CeWL is pronounced "cool".
.SH OPTIONS
General options
.RS
.TP
.B
\fB-h\fP, \fB--help\fP
Show help.
.TP
.B
\fB-k\fP, \fB--keep\fP
Keep the downloaded file.
.TP
.B
\fB-d\fP <x>,\fB--depth\fP <x>
Depth to spider to, default 2.
\fB-m\fP, \fB--min_word_length\fP Minimum word length, default 3.
.TP
.B
\fB-o\fP, \fB--offsite\fP
Let the spider visit other sites.
.TP
.B
\fB-w\fP, \fB--write\fP
Write the output to the file.
.TP
.B
\fB-u\fP, \fB--ua\fP <agent>
User agent to send.
.TP
.B
\fB-n\fP, \fB--no-words\fP
Don't output the wordlist.
.TP
.B
\fB--with-numbers\fP
Accept words with numbers in as well as just letters.
.TP
.B
\fB-a\fP, \fB--meta\fP
Include meta data.
.TP
.B
\fB--meta_file\fP file
Output file for meta data.
.TP
.B
\fB-e\fP, \fB--email\fP
Include email addresses.
.TP
.B
\fB--email_file\fP <file>
Output file for email addresses.
\fB--meta-temp-dir\fP <dir> The temporary directory used by exiftool when parsing files, default /tmp.
.TP
.B
\fB-c\fP, \fB--count\fP
Show the count for each word found.
.TP
.B
\fB-v\fP, \fB--verbose\fP
Verbose.
.TP
.B
\fB--debug\fP
Extra debug information.
.RE
.PP
Authentication
.RS
.TP
.B
\fB--auth_type\fP
Digest or basic.
.TP
.B
\fB--auth_user\fP
Authentication username.
.TP
.B
\fB--auth_pass\fP
Authentication password.
.RE
.PP
Proxy Support
.RS
.TP
.B
\fB--proxy_host\fP
Proxy host.
.TP
.B
\fB--proxy_port\fP
Proxy port, default 8080.
.TP
.B
\fB--proxy_username\fP
Username for proxy, if required.
.TP
.B
\fB--proxy_password\fP
Password for proxy, if required.
.RE
.PP
Headers
.RS
.TP
.B
\fB--header\fP, \fB-H\fP
In format name:value - can pass multiple.
.RE
.TP
.B
<url>
The site to spider.
.SH BUGS
Someone has reported that the spider misses some pages which are have querystrings on them. This issue isn't confirmed.
.SH SEE ALSO
fab-\fBcewl\fP(1)
.SH AUTHOR
The CeWL was written by Robin Wood <robin@digi.ninja>.
.PP
This manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org>
for the Debian project (but may be used by others).