Share
## https://sploitus.com/exploit?id=E64B6D5F-49C5-51BB-BE75-62EF4316DCB7
# ๐Ÿ›ก๏ธ StreamGuard Premium

**Professional Surveillance & IoT Security Assessment Framework**

[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-2.0.0-orange.svg)](https://github.com/yourusername/streamguard)

> Enterprise-grade reconnaissance, exploitation, and security assessment toolkit for surveillance systems and IoT devices.

---

## ๐Ÿš€ Quick Start

```bash
# Clone repository
git clone https://github.com/yourusername/streamguard-premium.git
cd streamguard-premium

# Install dependencies
pip install -r requirements.txt

# Run StreamGuard
python streamguard.py --help
```

---

## โœจ Features

### ๐Ÿ” **Intelligent Reconnaissance**
- Network discovery (LAN/WAN)
- Service enumeration (RTSP, HTTP, ONVIF)
- Shodan/Censys integration
- Stream analysis & capture

### ๐Ÿ’ฅ **Multi-Vector Exploitation**
- 347+ manufacturer default credentials
- 187+ camera-specific CVE database
- RTSP session hijacking
- Protocol-level attacks

### ๐Ÿ•ต๏ธ **Advanced Capabilities**
- Stealth scanning with evasion
- Image metadata & OCR analysis
- Interactive TUI interface
- Professional HTML/PDF reports

---

## ๐Ÿ“ฆ Installation

### Requirements
- Python 3.8 or higher
- pip package manager

### Basic Setup
```bash
pip install -r requirements.txt
```

### Optional Dependencies
```bash
# For image analysis (OCR)
# Ubuntu/Debian:
sudo apt-get install tesseract-ocr

# macOS:
brew install tesseract

# Windows: Download from GitHub releases
```

---

## ๐ŸŽฏ Usage Examples

### Network Scanning
```bash
# Scan local network
python streamguard.py scan --target 192.168.1.0/24

# Stealth scan with custom threads
python streamguard.py scan --target 10.0.0.0/24 --stealth --threads 100
```

### Exploitation
```bash
# Exploit discovered target
python streamguard.py exploit 192.168.1.100:80

# Force exploitation
python streamguard.py exploit 192.168.1.100 --force
```

### RTSP Stream Hijacking
```bash
# Enumerate RTSP streams
python streamguard.py rtsp-enumerate 192.168.1.100

# Hijack RTSP stream
python streamguard.py rtsp-hijack rtsp://192.168.1.100:554/stream
```

### Shodan Integration
```bash
# Search for cameras globally
python streamguard.py shodan-search "webcamxp" --limit 100

# Geographic analysis
python streamguard.py shodan-geo
```

### Image Analysis
```bash
# Analyze image metadata
python streamguard.py analyze-image capture.jpg

# Batch analysis
python streamguard.py analyze-image ./captures/ --export json
```

### Interactive TUI
```bash
# Launch text-based UI
python streamguard.py tui
```

---

## ๐Ÿ“‹ Available Commands

| Command | Description |
|---------|-------------|
| `scan` | Network discovery & fingerprinting |
| `exploit` | Target exploitation |
| `vuln-scan` | CVE vulnerability analysis |
| `onvif-scan` | ONVIF device discovery |
| `rtsp-hijack` | RTSP stream hijacking |
| `rtsp-enumerate` | RTSP stream enumeration |
| `shodan-search` | Global device search |
| `shodan-stats` | Shodan statistics |
| `shodan-geo` | Geographic distribution |
| `analyze-image` | Image metadata extraction |
| `show-findings` | Display sensitive findings |
| `persistence` | Install persistence mechanisms |
| `tui` | Launch interactive interface |
| `report` | Generate assessment reports |

---

## โš™๏ธ Configuration

Edit `configs/premium.yaml`:

```yaml
# API Keys
apis:
  shodan_key: "YOUR_SHODAN_API_KEY"
  censys_id: "YOUR_CENSYS_ID"
  censys_secret: "YOUR_CENSYS_SECRET"

# Stealth Settings
advanced_stealth:
  jitter_range: [0.5, 5.0]
  request_pattern: "random"
  user_agent_rotation: true

# Exploitation
exploitation:
  default_timeout: 30
  max_threads: 50
  auto_persistence: false
```

---

## ๐Ÿ“Š Project Structure

```
streamguard-premium/
โ”œโ”€โ”€ streamguard.py              # Main CLI entry point
โ”œโ”€โ”€ setup.py                    # Package installation
โ”œโ”€โ”€ requirements.txt            # Dependencies
โ”œโ”€โ”€ streamguard_premium/        # Core package
โ”‚   โ”œโ”€โ”€ core/                   # Scanner & exploiter
โ”‚   โ”œโ”€โ”€ modules/                # Feature modules
โ”‚   โ”œโ”€โ”€ ui/                     # CLI & TUI interfaces
โ”‚   โ””โ”€โ”€ utils/                  # Utilities
โ”œโ”€โ”€ data/
โ”‚   โ”œโ”€โ”€ creds/                  # Credential database
โ”‚   โ””โ”€โ”€ cve/                    # CVE database
โ””โ”€โ”€ configs/                    # Configuration files
```

---

## ๐Ÿ”’ Ethical Usage & Legal Notice

**โš ๏ธ IMPORTANT:** This tool is for **authorized security testing only**.

### Intended Use
- โœ… Authorized penetration testing
- โœ… Security research & education
- โœ… Red team exercises
- โœ… Asset inventory & assessment

### Prohibited Use
- โŒ Unauthorized access to systems
- โŒ Illegal surveillance
- โŒ Malicious activities
- โŒ Privacy violations

**Users are responsible for compliance with all applicable laws and regulations.**

---

## ๐Ÿ› Troubleshooting

### Common Issues

**Import Errors:**
```bash
# Ensure you're in project directory
cd /path/to/streamguard-premium

# Install in development mode
pip install -e .
```

**Permission Errors (Scapy):**
```bash
# Linux: Run with sudo or add capabilities
sudo python streamguard.py scan --target 192.168.1.0/24

# Windows: Run as Administrator
```

**Missing Tesseract:**
```bash
# Install Tesseract OCR for image analysis
# See installation instructions above
```

For more help, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md)

---

## ๐Ÿค Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

---

## ๐Ÿ“„ License

This project is licensed under the MIT License - see [LICENSE](LICENSE) file for details.

---

## ๐Ÿ™ Acknowledgments

- Shodan & Censys for internet intelligence APIs
- OpenCV & Tesseract communities
- Textual framework for beautiful TUI
- Security research community

---

## ๐Ÿ“ž Support

- **Issues:** [GitHub Issues](https://github.com/yourusername/streamguard/issues)
- **Documentation:** [Wiki](https://github.com/yourusername/streamguard/wiki)
- **Email:** support@streamguard.com

---



**โš ๏ธ USE RESPONSIBLY โ€ข ๐Ÿ›ก๏ธ SECURE RESPONSIBLY โ€ข ๐ŸŒ PROTECT PRIVACY**

Made with โค๏ธ by the StreamGuard Team