Usage

Usage

FeedYourSpider is driven entirely by an interactive menu. There are no command-line flags to learn: you launch the script, pick a number, and answer a few prompts.

Launching

./feedyourspider.sh

On startup the launcher briefly shows a centered title screen, then clears and draws the main screen: the spider ASCII art on the left and the numbered menu on the right.

The main loop

Each pass through the menu does the same five things:

1. Clears the screen.
2. Draws the banner and the menu side by side.
3. Reads a single numeric choice at the FEED YOUR SPIDER: prompt.
4. Dispatches that number to the matching tool (or exits on 0).
5. Waits at Press Enter to continue… before redrawing.

Pick a number 1–10 to run a tool, or 0 to exit.

FEED YOUR SPIDER: 1     # runs Nmap
FEED YOUR SPIDER: 0     # exits

If you type something that is not a valid menu number, the launcher prints an error and returns you to the menu.

What happens when you pick a tool

Every tool follows the same flow:

1. Availability check. The tool's *_run function calls ensure_command. If the underlying binary is missing, you are offered an automatic install (see Automatic Installation). If you decline or the install fails, you return to the menu without running anything.
2. Mode selection. Most tools present their own sub-menu of modes (for example Nmap's Quick, Service/version, Aggressive, All ports, SYN stealth, Custom args).
3. Prompts. You are asked for the inputs that mode needs: a target, a port, an interface, a URL, a CIDR range, and so on. Inputs that have a well-defined shape are validated and re-prompted on bad input (see Input Validation).
4. Run. The command is printed (so you can see exactly what is executed) and then run. sudo is used only for the modes that require elevated privileges, and you are told when that happens.
5. Output. Results are saved to a timestamped file under the tool's output directory. The path is printed before the run starts. See Output & Files.

Prompts and defaults

• A prompt that shows a value in parentheses, like Interface (any) >, has a default. Press Enter to accept it.
• A validated prompt (target, port, CIDR, domain) re-asks until you give a well-formed value. Submitting an empty answer aborts the action and returns you to the menu, so you can always back out.
• Yes/no prompts default to yes on an empty answer.

Stopping a running tool

For live operations (captures, pings, listens), press Ctrl+C. Thanks to a scoped SIGINT trap, Ctrl+C interrupts the running tool and drops you back to the menu rather than killing the whole launcher.

A first run, end to end

FEED YOUR SPIDER: 1
==> Launching Nmap

Target (ip/host or CIDR) > scanme.nmap.org

Select scan type:
  [1] Quick (top ports)
  [2] Service/version (-sV + default scripts)
  [3] Aggressive (-A)
  [4] All ports (-p-)
  [5] SYN stealth (-sS)
  [6] Custom args
Choice > 1

Saving results to /home/you/feedyourspider_nmap/scan_scanme.nmap.org_20260617_140312.{nmap,gnmap,xml}
==> Running: nmap -T4 --top-ports 100 -oA ... scanme.nmap.org

For the full set of modes per tool, see the Tools Reference.