Summary: Manage named references to wordlist files for use in tool commands.

Managing Wordlists

In pwnity, a wordlist is not the content of the list itself, but rather a named reference (or pointer) to a wordlist file on your system. This approach allows you to manage large lists efficiently without duplicating data.

The primary purpose is to make the file path available through the $wordlist.path placeholder, which can then be used in your tool configurations.

Core Concepts

  • Wordlist Object: A simple JSON object with a name and a path.
  • Session Loading: Loading a wordlist into a session makes its path available to any tool run within that session.

Common Workflow

1. Create a Wordlist Reference

First, create a named entry for the wordlist you want to use.

wordlist add common-directories

2. Set the File Path

Next, tell pwnity where the actual file is located.

wordlist update common-directories path /usr/share/wordlists/dirbuster/directory-list-2.3-medium.txt

3. Use it in a Tool

Configure a tool (like gobuster) to use the $wordlist.path placeholder.

tool update gobuster dir param "-w $wordlist.path"

4. Load and Run

Load the wordlist into your session before running the tool.

wordlist load common-directories
pwn dir now
# pwnity resolves $wordlist.path to the full file path when executing the command.

All Commands

  • wordlist add <name>: Creates a new, empty wordlist reference.
  • wordlist list: Lists all available wordlists.
  • wordlist show <name>: Displays the details (like the path) of a wordlist.
  • wordlist update <name> path <value>: Sets the file path for the wordlist.
  • wordlist load <name>: Loads the wordlist into the current session.
  • wordlist unload: Unloads the wordlist from the current session.
  • wordlist rename <old_name> <new_name>: Renames a wordlist reference.
  • wordlist destroy <name>: Deletes a wordlist reference.
  • wordlist export <name>: Generates the commands to recreate the wordlist reference.