Changelog

All notable changes to NetScan are documented here. We follow Semantic Versioning.

v3.0.0 2026-01-06

Desktop GUI Application with Professional Installers

Added

  • Desktop GUI Application (Electron) — Modern cross-platform desktop app with dark/light themes, real-time scanning, device management, topology visualization, and security dashboard.
  • macOS Installers — Full .pkg installer with component selection (GUI, CLI, or both), plus .dmg files for Intel and Apple Silicon.
  • Windows Installers — NSIS installer with component selection and portable ZIP archive.
  • Installer Build System — Automated build scripts for creating professional installers on all platforms.

Fixed

  • Bash 3.2 compatibility for macOS default shell (removed bash 4+ features)
  • Config files now stored in ~/.netscan for proper user permissions
  • CLI wrapper script installation issues

Downloads

v2.1.0 2026-01-06

Network Intelligence Suite - Device fingerprinting, topology visualization, security auditing, and automation.

Added

  • Device Fingerprinting (fingerprint.py) — Intelligent device type detection using MAC vendor, open ports, and TTL analysis.
  • Network Topology (topology.py) — Visualize your network structure with ASCII art, interactive HTML (vis.js), or DOT format.
  • Security Audit (security.py) — Comprehensive vulnerability assessment with 50+ risky port signatures and SSL/TLS verification.
  • Wake-on-LAN (wol.py) — Remote device power management with magic packets.
  • Scheduled Scanning (scheduler.py) — Automated scans with native cron (Linux) or launchd (macOS) integration.
  • Export Reports (export.py) — Multi-format export to CSV, styled HTML, JSON, and PDF.

v2.0.0 2024-01-15

Major release with Rust performance module, Docker support, and comprehensive documentation website.

✨ Added

  • Rust performance module — Optional 10-100x speedup for MAC normalization, CIDR expansion, and port scanning
  • Docker support — Multi-stage Dockerfile, docker-compose.yml, and helper script
  • Documentation website — Comprehensive static docs with search, syntax highlighting, and responsive design
  • Python wrapper (fast_core.py) — Automatic fallback to pure Python if Rust not compiled
  • Build script (build_rust.sh) — Easy compilation of Rust module
  • New CLI flags — --json, --csv, --report, --threads
  • Environment variables — Configure behavior via NETSCAN_* variables

🔄 Changed

  • Installer rewritten — Comprehensive one-command installer with better error handling
  • Menu system — Improved interactive menu with more options
  • Output formats — Standardized JSON and CSV output across all commands
  • Documentation — Consolidated all docs into website format

🐛 Fixed

  • Python helper CLI arguments now work correctly from scanner.sh
  • Web server kill option added to menu
  • MAC address normalization edge cases
  • Interface detection on macOS with multiple interfaces

📦 Dependencies

  • Python 3.7+ (was 3.6+)
  • Optional: Rust 1.70+ for performance module
  • Optional: Docker 20.10+ for containerized deployment

v1.5.0 2024-01-01

Web interface improvements and monitoring enhancements.

✨ Added

  • Real-time network monitoring with -m flag
  • Desktop notifications for new devices (--notify)
  • Web interface scan history
  • Export to XML format
  • Vendor search functionality (--vendor)

🔄 Changed

  • Web interface redesign with modern UI
  • Improved scan performance with parallel execution
  • Better error messages for common issues

🐛 Fixed

  • Web server stability improvements
  • Memory leak in long-running scans
  • Hostname resolution timeout issues

v1.4.0 2023-12-15

Port scanning and enhanced reporting.

✨ Added

  • Full scan with port detection (-f flag)
  • HTML report generation (--report)
  • Service detection for common ports
  • Custom port specification (--ports)

🔄 Changed

  • Scan output now shows open ports
  • JSON output includes port information

v1.3.0 2023-12-01

Web interface and Python API.

✨ Added

  • Web interface (-w flag)
  • Python API for programmatic access
  • Batch MAC lookup (-b flag)
  • Cache for faster repeated lookups

🔄 Changed

  • Modular Python helper structure
  • Improved OUI database parsing

v1.2.0 2023-11-15

Network scanning capabilities.

✨ Added

  • Network scanning (-s flag)
  • Auto-detect local network
  • Interface selection (-i flag)
  • JSON output (--json)
  • CSV output (--csv)

🔄 Changed

  • Interactive menu with scan options
  • Improved hostname detection

v1.1.0 2023-11-01

Python helpers and installation improvements.

✨ Added

  • Python helper scripts for MAC lookup
  • Installation script (install.sh)
  • OUI database auto-update
  • Support for different MAC formats

🔄 Changed

  • Moved from pure Bash to Bash + Python hybrid
  • Improved MAC address validation

v1.0.0 2023-10-15

Initial release.

✨ Added

  • MAC address lookup via OUI database
  • Interactive menu interface
  • Local OUI database
  • Basic command-line interface

Versioning Policy

NetScan follows Semantic Versioning:

  • MAJOR (X.0.0) — Incompatible API changes
  • MINOR (0.X.0) — New features, backwards compatible
  • PATCH (0.0.X) — Bug fixes, backwards compatible

Release Schedule

  • Major releases: As needed for significant changes
  • Minor releases: Monthly or bi-monthly
  • Patch releases: As needed for critical fixes

Deprecation Policy

Deprecated features will be marked with warnings for at least one minor version before removal.