Skip to content

ismailtsdln/netvista

Repository files navigation

👁️ NetVista v2.1.0-pro

NetVista Logo

Go Version Version Architecture License


NetVista v2.1.0-pro is an enterprise-grade Visual Reconnaissance & Intelligence engine. Built with a robust Hexagonal Architecture, it transforms raw target lists into actionable visual insights by combining smart rendering, technology fingerprinting, and visual deduplication.

🚀 Key Capabilities

🧠 Visual Intelligence

  • Perceptual Hashing (pHash): Automatically groups visually identical hosts to eliminate report noise.
  • Framework Fingerprinting: Deep detection of modern SPA frameworks (React, Vue, Angular) and legacy technologies.
  • Smart Interactions: Automated detection and bypass of cookie consent overlays and common popups.

🏗️ Enterprise Architecture

  • Hexagonal Design: Core business logic is strictly decoupled from infrastructure, ensuring long-term maintainability.
  • Browser Pooling: High-performance browser context management with thread-safe pooling.
  • Resource Aware: Adaptive concurrency and smart retries with exponential backoff.

📊 Professional Outputs

  • Interactive Multi-Report: One-click generation of JSON, CSV, Markdown, and TXT reports.
  • Web Dashboard 2.0: A built-in surveillance dashboard to browse results in real-time.
  • Incremental Scanning: Intelligent logic that skips previously scanned targets to optimize resources.

🏗️ Architecture Visualization

NetVista utilizes the Ports & Adapters (Hexagonal) pattern to ensure the core engine remains platform-agnostic.

graph TD
    subgraph "External Actors"
        CLI[User CLI]
        Web[Web Dashboard]
    end

    subgraph "Services Layer"
        ScannerService[Scanner Service]
    end

    subgraph "Ports (Interfaces)"
        P_Prober[Prober Port]
        P_Renderer[Renderer Port]
        P_Reporter[Reporter Port]
    end

    subgraph "Infrastructure Adapters"
        A_Prober[HTTP Core Prober]
        A_Renderer[Playwright Browser]
        A_Reporter[Multi-Format Reporter]
    end

    CLI --> ScannerService
    ScannerService --> P_Prober
    ScannerService --> P_Renderer
    ScannerService --> P_Reporter
    
    P_Prober -.-> A_Prober
    P_Renderer -.-> A_Renderer
    P_Reporter -.-> A_Reporter
    
    A_Reporter --> Web
Loading

🛠️ Installation

Prerequisites

Setup

git clone https://github.com/ismailtsdln/netvista
cd netvista
go build -o netvista cmd/netvista/main.go

📖 Usage Guide

📂 Port Scanning & Capture

Pipe any list of URLs or IP addresses into NetVista.

# Basic scan
echo "example.com" | ./netvista scan -o my_scan

# Comprehensive scan with custom ports and concurrency
cat targets.txt | ./netvista scan -p 80,443,8080 -c 10 -o reports/prod

🔍 Specialized Input

Parse Nmap XML files for visual verification.

./netvista scan --nmap staging_network.xml -o staging_recon

🖥️ Surveillance Dashboard

Launch the interactive viewer to analyze your findings.

./netvista serve -d reports/prod -p 9090

⚙️ Configuration (netvista.yaml)

NetVista can be fine-tuned via a configuration file for enterprise deployments.

ports: "top-100"          # Presets: top-100, top-1000, full
concurrency: 20           # Number of simultaneous scanning threads
max_browser_contexts: 10  # Max active Playwright contexts
output: "./reports"       # Default output directory
timeout: "10s"            # Global timeout per host
proxy: ""                 # HTTP/SOCKS5 Proxy (optional)

🛡️ Credits & Contribution

Created and maintained by İsmail Taşdelen. Contributions are welcome via Pull Requests.


Generated by NetVista Engine - Empowering Reconnaissance.

About

NetVista v2.1.0-pro is an enterprise-grade Visual Reconnaissance & Intelligence engine. Built with a robust Hexagonal Architecture, it transforms raw target lists into actionable visual insights by combining smart rendering, technology fingerprinting, and visual deduplication.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors