PortEye - A Simple Bash Port Scanner

PortEye is a lightweight and simple Bash Tool designed to scan a range of ports on a target host and determine which ones are open. It’s an easy-to-use tool for network diagnostics and learning purposes, built entirely in Bash.

Features

• Scans a specified range of ports on a given IP address.

• Detects and displays open and closed ports.

• Lightweight and portable — requires only Bash (no extra dependencies)

• Includes Timeout functionality to avoid hanging on unresponsive ports.

• Displays discovered open ports at the end of the scan

• Saves open port results to a timestamped log file for later reference

  Disclaimer

  This tool is intended for educational and diagnostic use only. Use it only on systems you own or have permission to test.

  Installation

1. Clone the Repository

git clone https://github.com/s-r-e-e-r-a-j/PortEye.git

2. Navigate to the PortEye directory

cd PortEye

3. Navigate to the PortEye directory

cd PortEye

How to Use

Requirements

• A Linux-based system with Bash installed (e.g., Kali Linux, Ubuntu, parrot os, Termux, etc.).

Usage

bash porteye.sh <target_ip> <starting_port> <ending_port>

Example

To scan ports 20 to 80 on the IP address 192.168.1.1:

bash porteye.sh 192.168.1.1 20 80

Output

• Open Ports: Displayed in green, indicating the port is open and responsive.
• Closed Ports: Displayed in red, indicating the port is closed or filtered.

License

This tool is open-source and available under the MIT License.