Skip to content
Fetch, install and search wordlist archives from websites and torrent peers.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
bash-completion update bash-completion and add more wordlists Mar 10, 2019
man add multiprocessing Feb 24, 2019
.gitignore fix mediafire resolver Jan 9, 2019
LICENSE Initial commit Oct 29, 2018
requirements.txt add -F arg and change coloring lib Dec 7, 2018


Script to fetch, install, update and search wordlist archives from websites offering wordlists with more than 2900 wordlists available.

In the latest version of the Blackarch Linux it has been added to /usr/share/wordlists/ directory.


pacman -S wordlistctl


[ sepehrdad@blackarch-dev ~/blackarch/repos/wordlistctl ]$ wordlistctl -H
--==[ wordlistctl by ]==--


  wordlistctl -f <arg> [options] | -s <arg> [options] | -S <arg> | <misc>


  -f <num>   - download chosen wordlist - ? to list wordlists with id
  -d <dir>   - wordlists base directory (default: /usr/share/wordlists)
  -c <num>   - change wordlists category - ? to list wordlists categories
  -s <regex> - wordlist to search using <regex> in base directory
  -S <regex> - wordlist to search using <regex> in sites
  -h         - prefer http
  -X         - decompress wordlist
  -F <str>   - list wordlists in categories given
  -r         - remove compressed file after decompression
  -t <num>   - max parallel downloads (default: 5)


  -C         - disable terminal colors
  -T         - disable torrent download
  -P         - set proxy (format: proto://user:pass@host:port)
  -A         - set useragent string
  -Y         - proxy http
  -Z         - proxy torrent
  -M         - use multiprocessing for parallelization
  -N         - do not ask for any confirmation
  -I         - do not check for integrity
  -V         - print version of wordlistctl and exit
  -H         - print this help and exit


  # download and decompress all wordlists and remove archive
  $ wordlistctl -f 0 -Xr

  # download all wordlists in username category
  $ wordlistctl -f 0 -c 0

  # list all wordlists in password category with id
  $ wordlistctl -f ? -c 1

  # download and decompress all wordlists in misc category
  $ wordlistctl -f 0 -c 4 -X

  # download all wordlists in filename category using 20 threads
  $ wordlistctl -c 3 -f 0 -t 20

  # download wordlist with id 2 to "~/wordlists" directory using http
  $ wordlistctl -f 2 -d ~/wordlists -h

  # print wordlists in username and password categories
  $ wordlistctl -F username,password

  # download all wordlists with using tor socks5 proxy
  $ wordlistctl -f 0 -P "socks5://" -Y

  # download all wordlists with using http proxy and noleak useragent
  $ wordlistctl -f 0 -P "" -Y -A "noleak"

Get Involved

You can get in touch with the BlackArch Linux team. Just check out the following:

Please, send us pull requests!



IRC: irc://

You can’t perform that action at this time.