========================================
    NETWORK SCANNER - User Guide
========================================

WHAT DOES IT DO?
----------------
Finds all devices connected to your WiFi or Ethernet network.
Shows IP addresses, MAC addresses, device types, and connection status.

QUICK START (3 STEPS)
---------------------
1. Double-click INSTALL.bat (only needed once)
2. Double-click RUN_AS_ADMIN.bat
3. Enter your network range when prompted

HOW TO FIND YOUR NETWORK RANGE
------------------------------
1. Press Windows + R, type "cmd", press Enter
2. Type "ipconfig" and press Enter
3. Look for "IPv4 Address" (example: 192.168.1.5)
4. Your range is the first 3 numbers with .0/24
   
   Examples:
   - If IP is 192.168.1.5, enter: 192.168.1.0/24
   - If IP is 10.0.0.5, enter: 10.0.0.0/24
   - If IP is 172.16.1.5, enter: 172.16.0.0/16

UNDERSTANDING THE RESULTS
-------------------------
[OK] ACTIVE   = Device responds to ping (full connectivity)
[--] PRESENT  = Device online but blocks ping (normal for security)

- iPhones/iPads show as PRESENT (privacy feature - this is NORMAL)
- ALL discovered devices ARE connected to your network!

WHAT YOU'LL SEE
---------------
For each device, the scanner shows:
- Device Name (e.g., "iPhone", "DESKTOP-PC", "Router")
- IP Address (e.g., 192.168.1.5)
- MAC Address (physical hardware address)
- Connection type (Wi-Fi or Ethernet)
- Device type (iPhone, Computer, Router, etc.)
- Response time (if device responds to ping)

TROUBLESHOOTING
---------------
Problem: "Python not found"
Solution: Install Python from https://python.org

Problem: No devices found
Solution: Make sure you're connected to WiFi/Ethernet

Problem: Permission errors
Solution: RUN_AS_ADMIN.bat automatically requests admin rights

Problem: Scan takes too long
Solution: Normal for first scan (30-60 seconds)

TIPS FOR BEST RESULTS
---------------------
- Run as Administrator (automatic with RUN_AS_ADMIN.bat)
- Scan during daytime when more devices are active
- Make sure phones/tablets are awake (not in sleep mode)
- The scanner shows ALL devices on your network

EXAMPLE OUTPUT
--------------
Device #1
Name:           Router TD5130v3
IP Address:     192.168.1.1
MAC Address:    70:5A:9E:96:66:42
Status:         [OK] ACTIVE
Device Type:    Technicolor Router

Device #2
Name:           iPhone
IP Address:     192.168.1.10
MAC Address:    72:71:0B:F0:77:85
Status:         [--] PRESENT
Device Type:    Apple iPhone/iPad

CONTACT
-------
For help or questions, contact your network administrator

========================================