FeedYourSpider

Interactive terminal launcher for common network and reconnaissance tools (nmap, netcat, tcpdump, tshark, hping3, arp-scan, masscan, nikto, dnsenum, whatweb). Saves outputs to timestamped directories and installs missing tools automatically on most Linux distributions and macOS.

Features

• Colorful ASCII banner and a menu-driven interface.
• Quick access to common network utilities with sensible presets.
• Per-tool, timestamped output directories under $HOME (override with FEEDYOURSPIDER_OUTPUT_ROOT).
• Automatic installation of missing tools across apt, dnf, yum, pacman, zypper, apk, and Homebrew via a single ensure_command helper.
• Modular layout: each tool is one ~30-line file under lib/modules/. Adding a new tool is a 4-step recipe documented in docs/ADDING_A_TOOL.md.

Quick start

git clone https://github.com/WhiteMuush/FeedYourSpider.git
cd FeedYourSpider
chmod +x feedyourspider.sh
./feedyourspider.sh

Pick a numbered menu item. The script will offer to install the tool if it isn't already on PATH, then prompt for targets, ports, interfaces, or custom arguments.

Outputs land under $HOME/feedyourspider_<tool>/, for example:

• $HOME/feedyourspider_nmap/
• $HOME/feedyourspider_tcpdump/
• $HOME/feedyourspider_netcat/

Use Ctrl+C to stop a live capture.

Project layout

feedyourspider.sh        Thin orchestrator: sources lib/ and runs the menu loop.
lib/
  core.sh                TTY-aware colors, constants, output helpers.
  installer.sh           Logging, prompts, ensure_command / install_package.
  ui.sh                  ASCII banner, title screen, side-by-side renderer.
  modules/<tool>.sh      One file per tool. Exposes <tool>_run().
docs/
  ARCHITECTURE.md        Boot sequence and cross-cutting helpers.
  ADDING_A_TOOL.md       Recipe for contributing a new tool.
.github/                 CI workflow, issue templates, PR template.

See docs/ARCHITECTURE.md for the full layout.

Requirements

• Bash 4+
• sudo for some captures, raw-socket scans, and automatic installs
• One or more of the wrapped tools, on demand: Nmap, Ncat / Netcat, tcpdump, TShark, hping3, arp-scan, masscan, Nikto, dnsenum, WhatWeb

Demo

FeedYourSpider.-.DEMO.mp4

Safety

• Use only on systems and networks where you have explicit authorization.
• Some operations require elevated privileges or may trigger security alerts.
• The script is a convenience wrapper. Review commands before running, especially with custom args.

Contributing

PRs and issues are welcome. Start with CONTRIBUTING.md — it covers conventions, the contribution checklist, and the validation commands the CI runs.

Adding a new tool? See docs/ADDING_A_TOOL.md; the typical contribution is around 30 lines.

License

GPL-3.0-or-later. See LICENSE.

Disclaimer

Provided as-is. The author is not responsible for misuse. Use responsibly and legally.