Metadata-Version: 2.4
Name: openrecon
Version: 1.0.0
Summary: A lightweight, modular cybersecurity scanner
Author-email: v7upsln <salmanalmtyry522@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/v7upsln/OpenRecon
Project-URL: Documentation, https://r0salman.github.io/OpenRecon/
Project-URL: Repository, https://github.com/v7upsln/OpenRecon
Project-URL: Issues, https://github.com/v7upsln/OpenRecon/issues
Keywords: security,vulnerability scanner,xss,sql injection,cms detection,web security,penetration testing,reconnaissance,subdomain enumeration,port scanning
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Topic :: System :: Systems Administration
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.MD
Requires-Dist: colorama>=0.4.6
Requires-Dist: mac_vendor_lookup>=0.1.12
Requires-Dist: psutil>=7.1.0
Requires-Dist: requests>=2.32.5
Requires-Dist: rich>=14.2.0
Requires-Dist: scapy>=2.6.1
Requires-Dist: urllib3>=2.5.0
Provides-Extra: windows
Requires-Dist: pywin32>=311; extra == "windows"
Dynamic: license-file

# OpenRecon

[![PyPI version](https://img.shields.io/pypi/v/openrecon.svg)](https://pypi.org/project/openrecon/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

## Overview

OpenRecon is a comprehensive network reconnaissance tool designed for security professionals, network administrators, and cybersecurity enthusiasts. Originally developed as an educational project to explore network security concepts, it provides powerful scanning and discovery capabilities for authorized security assessments.

## Installation

### Via pip (Recommended)
```bash
pip install openrecon
```

### From Source
```bash
git clone https://github.com/v7upSln/OpenRecon.git
cd OpenRecon
pip install -r requirements.txt
```

### Optional: Install Nmap (for enhanced version detection)

**Ubuntu/Debian:**
```bash
sudo apt install nmap
```

**CentOS/RHEL:**
```bash
sudo yum install nmap
```

**macOS:**
```bash
brew install nmap
```

**Windows:**
Download from [nmap.org](https://nmap.org/download.html)

## Usage

### Basic Command Structure
```bash
openrecon [command] [options]
```

### Display System Information
```bash
openrecon
```
Shows system and network configuration.

### Common Examples
```bash
# Basic network scan
openrecon scan --target 192.168.1.0/24

# Port scanning
openrecon ports --target 192.168.1.1 --ports 1-1000

# Service detection
openrecon services --target 192.168.1.1
```

## Features

- Network discovery and host enumeration
- Port scanning with service detection
- Operating system fingerprinting
- Vulnerability assessment templates
- Comprehensive reporting capabilities
- Educational mode with detailed explanations

## Legal Disclaimer

This tool is intended for:
- Security professionals conducting authorized assessments
- Network administrators monitoring their own networks
- Educational and research purposes

### Important:
- Only use on networks you own or have explicit permission to test
- Unauthorized scanning may be illegal in your jurisdiction
- The developers are not responsible for misuse of this tool
- Always comply with local laws and regulations

## Support

- **Documentation:** [GitHub Wiki](https://github.com/v7upSln/OpenRecon/wiki)
- **Issues:** [GitHub Issues](https://github.com/v7upSln/OpenRecon/issues)

## Contributing

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features.

## License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/v7upSln/OpenRecon/blob/main/LICENSE) file for details.
