Home

FeedYourSpider Wiki

FeedYourSpider is an interactive terminal launcher for common network and reconnaissance tools. It wraps ten utilities (Nmap, Netcat, Tcpdump, TShark, hping3, arp-scan, Masscan, Nikto, dnsenum, WhatWeb) behind a single menu-driven interface, saves every run to a timestamped output directory, and installs missing tools automatically across the major Linux package managers and Homebrew.

This wiki is the knowledge base for the project: what it does, how it is built, how to operate each tool, and how to extend it.

Authorized use only. FeedYourSpider is a convenience wrapper around active scanning and capture tools. Run it only against systems and networks you are explicitly permitted to test. See Security & Responsible Use.

Start here

If you want to…	Read
Install it and run your first scan	Installation → Usage
Understand every tool and its modes	Tools Reference
Know where results are written	Output & Files
See how the codebase is structured	Architecture
Add a new tool or contribute	Extending FeedYourSpider → Contributing
Fix a problem	Troubleshooting

At a glance

• Language: Bash (4+ required).
• Runtime dependencies: none beyond Bash and the tool you choose to run.
• Layout: a thin orchestrator (feedyourspider.sh) that sources shared libraries in lib/ and one ~30-line module per tool in lib/modules/.
• Single registry: the menu and the dispatcher both derive from one list (FEEDYOURSPIDER_TOOLS), so adding a tool means editing one place.
• Outputs: per-tool, timestamped folders under $HOME (override with FEEDYOURSPIDER_OUTPUT_ROOT).
• License: GPL-3.0-or-later.
• Current version: 1.2.0 (see Changelog).

The ten wrapped tools

#	Tool	Category	Needs sudo?
1	Nmap	Port/service scanning	Some scan types
2	Netcat	Connect / listen / transfer	No
3	Tcpdump	Packet capture	Yes
4	TShark	Packet capture / analysis	Live capture only
5	hping3	Custom packet crafting	Yes
6	arp-scan	Layer-2 host discovery	Yes
7	Masscan	Mass port scanning	Yes
8	Nikto	Web server scanning	No
9	dnsenum	DNS enumeration	No
10	WhatWeb	Web fingerprinting	No

Full per-mode details are in the Tools Reference.

Project links

• Repository: https://github.com/WhiteMuush/FeedYourSpider
• Issues: https://github.com/WhiteMuush/FeedYourSpider/issues
• Security advisories: https://github.com/WhiteMuush/FeedYourSpider/security/advisories/new