Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/s-r-e-e-r-a-j/porteye
PortEye is a lightweight and simple Bash script 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.
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: 2 days ago
JSON representation
PortEye is a lightweight and simple Bash script 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.
- 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 (4 days ago)
- Default Branch: main
- Last Pushed: 2024-12-18T14:56:45.000Z (4 days ago)
- Last Synced: 2024-12-18T15:36:46.836Z (4 days 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: 0 Bytes
- Stars: 0
- 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 script 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, requiring no additional dependencies beyond Bash.
- Timeout functionality to avoid hanging on unresponsive ports.
- Informative banner with attribution and GitHub link.
## 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
#### Prerequisites
- A Linux-based system with Bash installed (e.g., Kali Linux, Ubuntu, Termux, etc.).
#### Command Syntax
``` bash
bash porteye.sh
```
#### Example Usage
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.
## Features in Detail
- **Display Banner**: Includes tool details and attribution.
- **Port Scanning**: Iterates through a range of ports to determine their status.
- **Timeout Mechanism**: Prevents the script from getting stuck on unresponsive ports using `timeout`.
- **Results Array**: Stores the results of open ports for additional display.
## Author
Developed by **Sreeraj**
Copyright © 2024
GitHub: https://github.com/s-r-e-e-r-aj
## Disclaimer
This tool is intended for ethical purposes only. Ensure you have permission to scan any IP address or network. Unauthorized scanning of networks can be illegal and lead to penalties.
Use responsibly and for educational purposes!