Skip to content

s-r-e-e-r-a-j/BannerHunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bannerhunter

Bannerhunter is a powerful banner grabbing tool written in C. It can connect to services running on different ports, attempt plain TCP grabs, and also perform SSL/TLS handshakes for encrypted services. The tool sends protocol-appropriate requests (like HEAD with Host headers for HTTP/HTTPS) to increase the chance of extracting banners.

Features

  • Works on both Linux(Debian,RedHat,Arch) and Termux

  • Supports plain TCP and SSL/TLS connections

  • Sends proper Host headers for HTTP/HTTPS

  • Can attempt banner grabs across multiple ports (HTTP, HTTPS, FTP, SSH, SMTP, and custom services).

  • Receive timeout handling to prevent hangs when services don’t respond

  • Installer and uninstaller scripts for easy setup and removal

Disclaimer

BannerHunter is for educational and authorized security testing only. Do not use it on systems without permission. The author is not responsible for misuse.

Installation

  1. Clone the repository:
git clone https://github.com/s-r-e-e-r-a-j/BannerHunter.git
  1. Navigate to the project directory:
cd BannerHunter
  1. Run the installer to install dependencies and setup the system-wide command (Linux & Termux):
sudo bash install.sh

The installer will check for required dependencies and install them if missing.

Usage

bannerhunter <host> <port>
bannerhunter <host> <port1> <port2> <port3>

Example (Single Port):

bannerhunter example.com 80

Connects to example.com on port 80 and attempts to grab the banner.

Example (Multiple Ports):

bannerhunter example.com 21 22 25 80 443

Connects to example.com on ports 21, 22, 25, 80, and 443, grabbing banners from each service.

Uninstallation

sudo bash uninstall.sh

This will remove the bannerhunter command from your system(Termux & Linux).

License

This project is licensed under the MIT License

Releases

No releases published

Packages

No packages published