Skip to content

RELEASE_NOTES_V4.1.md

Latest commit

 

History

History
313 lines (245 loc) · 8.65 KB

RELEASE_NOTES_V4.1.md

File metadata and controls

313 lines (245 loc) · 8.65 KB

NMAPScanner v4.1 Release Notes

Released: November 24, 2025 Created by: Jordan Koch

🎯 Major Update: Comprehensive Device Details - "The Whole 9 Yards"

✨ What's New in v4.1

Complete Device Information Window

When you click on a device card in the Dashboard, you now see EVERYTHING we know about that device:

📊 New Comprehensive Detail View

1. Basic Information Section

  • ✅ IP Address - Network address
  • ✅ MAC Address - Hardware identifier
  • ✅ Hostname - Device name
  • ✅ DNS Resolution - Automatic reverse DNS lookup (if hostname not available)
  • ✅ Manufacturer - Vendor identification via MAC prefix
  • ✅ Device Type - Computer, Router, IoT, etc.
  • ✅ Detected As - Apple-specific detection (HomePod, Apple TV, Mac, etc.)
  • ✅ Operating System - OS information when available
  • ✅ SSH Detection - Shows if SSH is available with access hints
  • ✅ Web Interface Detection - Shows if HTTP/HTTPS is available

2. Network Capabilities Section ✨ NEW

Automatically detects and displays service categories:

  • Web Services - HTTP/HTTPS/8080 detected
  • Remote Access - SSH/Telnet/RDP enabled
  • File Sharing - SMB/AFP/NFS active
  • Database Services - MySQL/PostgreSQL/MongoDB/Redis running
  • Media Services - AirPlay/Plex/Jellyfin available

3. Enhanced Open Ports Section ✨ ENHANCED

Each port now shows:

  • Port Number - Large, easy-to-read monospaced
  • Service Name - What's running on this port
  • HomeKit Integration - Shows HomeKit-specific service details
  • Version Information - Software version if detected
  • Usage Hints - Actionable instructions! ✨ NEW

Usage Hints Include:

  • Port 22 (SSH) → "SSH access available - use: ssh user@192.168.1.100"
  • Port 80 (HTTP) → "Web interface - visit: http://192.168.1.100"
  • Port 443 (HTTPS) → "Secure web interface - visit: https://192.168.1.100"
  • Port 445 (SMB) → "SMB file sharing - use Finder > Connect to Server"
  • Port 3306 (MySQL) → "MySQL database server"
  • Port 5000 (AirPlay) → "Apple HomeKit AirPlay Audio Stream"
  • Port 5900 (VNC) → "VNC/Screen Sharing available"
  • Port 8080 (Web) → "Alternative web interface - visit: http://192.168.1.100:8080"
  • Port 32400 (Plex) → "Plex Media Server"
  • And many more...

4. Network Traffic Section

Real-time network statistics:

  • Current bandwidth usage
  • Total data transferred
  • Active connections
  • Last update timestamp

5. HomeKit Features Section

For Apple HomeKit devices:

  • Detected HomeKit features (AirPlay Audio, AirPlay Control, HAP, etc.)
  • Device type identification (HomePod, Apple TV, HomeKit Accessory)
  • Special icons for Apple devices

6. Security Vulnerabilities Section

CVE database integration:

  • Known vulnerabilities for detected services
  • CVSS severity scores
  • Detailed descriptions
  • Remediation recommendations

7. Device History Section

Historical tracking:

  • First seen date/time
  • Last seen date/time
  • Days tracked
  • Change history

🔧 Technical Enhancements

DNS Resolution

  • Automatic reverse DNS lookups when device hostname is unknown
  • Caches results for performance
  • Shows "Hostname (DNS)" label for resolved names

Smart Detection

  • SSH availability automatically detected (port 22)
  • Web interface detection (ports 80, 443, 8080)
  • Service categorization for quick capability overview
  • Apple device recognition (HomePod, Apple TV, Mac)

Actionable Information

Every piece of information includes how to use it:

  • SSH ports show connection commands
  • Web ports show URLs to visit
  • File sharing shows how to connect
  • Database ports identify the service

🎨 Design Improvements

Visual Hierarchy

  • Color-coded sections for easy navigation
  • Section icons for quick identification
  • Consistent card-based layout
  • Professional typography

Information Density

  • Comprehensive yet organized
  • Expandable sections
  • Scrollable content
  • 900x700 modal window

User Experience

  • One-click access from device cards
  • Close button prominently displayed
  • No need to hunt for information
  • Everything in one place

📦 Installation

Binary Location: /Volumes/Data/xcode/Binaries/NMAPScanner-v4.1-20251124-172542/

Installed Location: /Applications/NMAPScanner.app

Requirements:

  • macOS 13.0 or later
  • Apple Silicon or Intel Mac

🚀 Usage

How to Access Complete Device Information

  1. Launch NMAPScanner from Applications
  2. Scan your network (or use existing scan results)
  3. Click on any device card in the Dashboard
  4. View comprehensive details - everything you need to know!

What You'll See

For example, clicking on a HomePod will show:

  • IP & MAC addresses
  • DNS hostname (e.g., "HomePod-Kitchen.local")
  • Manufacturer: Apple
  • Detected As: HomePod mini
  • Network Capabilities:
    • Media Services Available
  • Open Ports:
    • 5000 - AirPlay Audio → "Apple HomeKit AirPlay Audio Stream"
    • 7000 - AirPlay Control → "Apple HomeKit AirPlay Control Channel"
    • 3689 - DAAP → "iTunes/Music sharing"
    • 5353 - mDNS → "Multicast DNS for discovery"
  • HomeKit Features: AirPlay Audio, AirPlay Control, DAAP/iTunes
  • Device Type: HomePod mini

For a web server, you'll see:

  • SSH availability with connection command
  • Web interface with clickable URL
  • Open ports with service versions
  • Database services if running
  • Security vulnerabilities if detected

📝 All Features Included

Sections in Detail View:

  1. ✅ Basic Information (8+ fields)
  2. ✅ Network Capabilities (5 service categories)
  3. ✅ Open Ports (with usage hints)
  4. ✅ Network Traffic (real-time stats)
  5. ✅ HomeKit Features (Apple devices)
  6. ✅ Security Vulnerabilities (CVE database)
  7. ✅ Device History (tracking info)

Information Types:

  • ✅ IP addresses
  • ✅ MAC addresses
  • ✅ Hostnames (local + DNS)
  • ✅ Manufacturers
  • ✅ Device types
  • ✅ Operating systems
  • ✅ Open ports (all detected)
  • ✅ Service names
  • ✅ Service versions
  • ✅ HomeKit capabilities
  • ✅ SSH detection
  • ✅ Web interfaces
  • ✅ File sharing
  • ✅ Database services
  • ✅ Media services
  • ✅ Network traffic
  • ✅ Security vulnerabilities
  • ✅ Usage instructions
  • ✅ Historical tracking

🆚 Comparison: v4.0 vs v4.1

v4.0 Device Card Click:

IP Address: 192.168.1.100
MAC: AA:BB:CC:DD:EE:FF
Hostname: device.local
Open Ports: 5
[Close Button]

v4.1 Device Card Click:

✨ Comprehensive Device Details Window ✨
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 Basic Information
   • IP Address, MAC, Hostname, DNS
   • Manufacturer, Device Type, OS
   • SSH/Web Interface Detection

🌐 Network Capabilities
   • Service Categories Detected
   • Web/Remote/File/Database/Media

🚪 Open Ports (detailed, with usage hints)
   22   SSH → ssh user@192.168.1.100
   80   HTTP → visit http://192.168.1.100
   443  HTTPS → visit https://192.168.1.100
   5000 AirPlay Audio (HomeKit)

📊 Network Traffic (if available)
🏠 HomeKit Features (if applicable)
🔒 Security Vulnerabilities (if detected)
📅 Device History

🐛 Bug Fixes

Fixed in v4.1:

  1. ✅ Replaced basic device detail view with comprehensive view
  2. ✅ Added DNS resolver integration
  3. ✅ Fixed actor isolation warnings in DNS resolution
  4. ✅ Added ComprehensiveDeviceDetailView to Xcode project
  5. ✅ Added DNSResolver to Xcode project
  6. ✅ Fixed vulnerability version display logic

🔐 Security

Enhanced security information:

  • CVE vulnerability detection
  • Service version identification
  • Security recommendations
  • Risk scoring

🎉 The Bottom Line

v4.0: Basic device information v4.1: THE WHOLE 9 YARDS! 🚀

Every piece of information we can gather about a device is now displayed in a beautiful, organized, actionable format. No more guessing - everything you need is right there.

🙏 Credits

Developed by: Jordan Koch Release Date: November 24, 2025 Version: 4.1 (Build 5) Platform: macOS 13.0+

📞 Support

For issues or feature requests, refer to project documentation:

  • FEATURES_IMPLEMENTED.md - Complete feature list
  • IMPLEMENTATION_ROADMAP.md - Development roadmap
  • README.md - Project overview

Build Status: ✅ BUILD SUCCEEDED Code Quality: ✅ CLEAN Testing: ✅ VERIFIED Deployment: ✅ INSTALLED & RUNNING

🎯 Next Steps

Try it out:

  1. Open NMAPScanner
  2. Scan your network
  3. Click on any device
  4. See everything we know about it!