FAQ

FAQ

What is FeedYourSpider? An interactive Bash menu that launches ten common network and recon tools (Nmap, Netcat, Tcpdump, TShark, hping3, arp-scan, Masscan, Nikto, dnsenum, WhatWeb), with sensible presets, automatic installation of missing tools, and timestamped output folders. See Home.

Do I need the tools installed first? No. Pick a tool and, if its binary is missing, the launcher offers to install it via your package manager. See Automatic Installation.

What are the requirements? Bash 4+, sudo for some operations, and whichever wrapped tool you choose. See Installation.

Does it run on macOS? Yes, but install a current Bash first (brew install bash) because stock macOS ships Bash 3.2. Installs use Homebrew. See Installation.

Where do results go? Into $FEEDYOURSPIDER_OUTPUT_ROOT/feedyourspider_<tool>/ (default $HOME), with timestamped filenames. Override the root with the env var. See Output & Files.

Why does it ask for my password? Some operations (tcpdump, hping3, arp-scan, Masscan, tshark live capture, and certain Nmap scans) need raw-socket access and run under sudo. The launcher prints the command and tells you when it elevates. See Security & Responsible Use.

How do I stop a running capture or scan? Press Ctrl+C. A scoped SIGINT trap returns you to the menu instead of killing the launcher. See Usage.

How do I cancel a prompt? Submit an empty answer (press Enter) at a validated prompt to abort back to the menu. See Input Validation.

Can I pass arguments the presets don't cover? Yes. Every tool has a "Custom args" mode that passes your input straight to the binary. These are not shape-validated, so review them carefully. See Tools Reference.

How do I add a new tool? Create a small module, source it, and add one line to the FEEDYOURSPIDER_TOOLS registry. See Extending FeedYourSpider.

Is it safe / legal to use? Only against systems and networks you are explicitly authorized to test. Unauthorized use may be illegal. See Security & Responsible Use.

What license is it under? GPL-3.0-or-later.

Where do I report a bug or a security issue? Bugs: the issue tracker with the bug-report template. Security: a private channel, never a public issue. See Security & Responsible Use.