https://github.com/s-r-e-e-r-a-j/porteye
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.
https://github.com/s-r-e-e-r-a-j/porteye
bash bash-script bashtool ethical-hacking ethical-hacking-tools kali-linux kali-linux-tools linux-shell openportsscanner porteye portscanner portscanning termux termux-tool termux-tools
Last synced: 8 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/s-r-e-e-r-a-j/porteye
- Owner: s-r-e-e-r-a-j
- License: mit
- Created: 2024-12-18T14:37:38.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-09T11:16:40.000Z (over 1 year ago)
- Last Synced: 2025-02-09T12:23:28.458Z (over 1 year ago)
- Topics: bash, bash-script, bashtool, ethical-hacking, ethical-hacking-tools, kali-linux, kali-linux-tools, linux-shell, openportsscanner, porteye, portscanner, portscanning, termux, termux-tool, termux-tools
- Language: Shell
- Homepage:
- Size: 45.9 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## 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**
```bash
git clone https://github.com/s-r-e-e-r-a-j/PortEye.git
```
2. **Navigate to the PortEye directory**
```bash
cd PortEye
```
3. **Navigate to the PortEye directory**
```bash
cd PortEye
```
## How to Use
#### Requirements
- A Linux-based system with Bash installed (e.g., Kali Linux, Ubuntu, parrot os, Termux, etc.).
#### Usage
``` bash
bash porteye.sh
```
#### Example
To scan ports `20` to `80` on the IP address `192.168.1.1`:
```bash
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.