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
~/.netscanfor proper user permissions - CLI wrapper script installation issues
Downloads
- NetScan-3.0.0-Installer.pkg (macOS GUI+CLI)
- NetScan-3.0.0.dmg (macOS Intel)
- NetScan-3.0.0-arm64.dmg (macOS Apple Silicon)
- NetScan-3.0.0-Setup.exe (Windows)
- NetScan-CLI-3.0.0.pkg (macOS CLI only)
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
-mflag - 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 (
-fflag) - 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 (
-wflag) - Python API for programmatic access
- Batch MAC lookup (
-bflag) - 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 (
-sflag) - Auto-detect local network
- Interface selection (
-iflag) - 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.