Version: 1.0.0
Author: Malte Schad
Description: Modern desktop application for network utilities - IPv4 Scanner & MAC Formatter

• CIDR Network Scanning: Supports any valid CIDR notation (e.g., 192.168.1.0/24, 10.0.0.0/8)
• Adjustable Speed: Choose between Gentle (600ms timeout), Medium (300ms), or Aggressive (150ms)
• Parallel Scanning: High-performance multi-threaded scanning (32-128 concurrent threads)
• Real-time Results: Live progress updates with visual status indicators
• Filtering: Option to show only responding hosts
• CSV Export: Export scan results to desktop
• Smart Warnings: Alerts for large network scans

• Flexible Input: Accept MAC addresses in any format
• Multiple Outputs: Generate 4 standard formats:
  • Plain: AABBCCDDEEFF
  • Colon: AA:BB:CC:DD:EE:FF
  • Dash-4: AABB-CCDD-EEFF
  • Dash-2: AA-BB-CC-DD-EE-FF
• Vendor Commands: Auto-generate switch commands for:
  • EXTREME CLI
  • Huawei CLI
  • Huawei Access-User CLI
  • Dell CLI
• Quick Copy: One-click copy for all outputs

• Light/Dark Theme: Toggle between themes
• Custom Icon: Network topology visualization
• Responsive Design: Resizable interface with minimum 980x680
• Keyboard Shortcuts:
  • Enter: Start scan or copy first MAC format
  • Ctrl+E: Export CSV

• Python 3.8 or higher
• Windows, macOS, or Linux

pip install -r requirements.txt

python nettools_app.py

python build_exe.py

Output: dist/NetToolsSuite.exe

If you prefer to use PyInstaller directly:

# Windows (single file)
pyinstaller --onefile --windowed --name=NetToolsSuite --icon=nettools_icon.ico nettools_app.py

# macOS (app bundle)
pyinstaller --onefile --windowed --name=NetToolsSuite nettools_app.py

# Linux (single file)
pyinstaller --onefile --name=NetToolsSuite nettools_app.py

1. Enter CIDR: Type network range (e.g., 192.168.1.0/24)
2. Select Aggressiveness: Choose scan speed
3. Click "Start Scan": Begin scanning
4. View Results: Real-time updates with status indicators
   • 🟢 Green dot = Host is online
   • ⚫ Gray dot = No response
5. Filter Results: Check "Show only responding hosts" to filter
6. Export: Click "Export as CSV" or press Ctrl+E

Tips:

• Smaller networks (/24-/32) scan quickly
• Large networks (/16-/20) will show a warning
• Use "Aggressive" mode for faster scans on reliable networks
• Use "Gentle" mode for slower/unreliable networks

1. Enter MAC Address: Type in any format
   • Valid: AA:BB:CC:DD:EE:FF, AABBCCDDEEFF, AA-BB-CC-DD-EE-FF
2. View Formats: All 4 standard formats appear instantly
3. Copy: Click any "Copy" button to copy to clipboard
4. Switch Commands: View vendor-specific commands (toggle with button)
5. Quick Copy: Press Enter to copy Format 1

• GUI Framework: CustomTkinter (modern themed Tkinter)
• Network Library: pythonping (ICMP without admin rights)
• Threading: ThreadPoolExecutor for parallel operations
• IP Calculations: ipaddress module (built-in Python)

• Scan Speed: 32-128 concurrent threads
• Timeout Range: 150-600ms per host
• Memory Usage: ~50-80MB (running)
• Executable Size: ~25-40MB (single file)

• ✅ Windows: Full support, no admin rights needed
• ✅ macOS: Full support, may require network permissions
• ✅ Linux: Full support, may require capabilities for ICMP

• Windows: Should work without admin rights
• Linux: Run sudo setcap cap_net_raw+ep $(which python3) or run as sudo
• macOS: Grant network permissions when prompted

pip install --upgrade -r requirements.txt

• Check antivirus (may block unsigned executables)
• Run from command line to see error messages
• Rebuild with --debug=all flag for detailed logs

• Restart the application
• Check system theme settings

/app/
├── nettools_app.py      # Main application
├── build_exe.py         # Build script
├── requirements.txt     # Dependencies
└── README.md           # This file

Add new network tool:

1. Create new tab in create_tabs()
2. Implement tool logic
3. Add UI elements

Customize theme:

1. Modify colors in ctk.set_default_color_theme()
2. Adjust change_theme() method

Created by: Malte Schad
Framework: CustomTkinter by Tom Schimansky
Ping Library: pythonping by Alessandro Maggio

• Initial release
• IPv4 Scanner with CIDR support
• MAC Formatter with vendor commands
• Light/Dark theme
• Single-file executable build

For issues or feature requests, please contact the developer or check the documentation.

Enjoy using NetTools Suite! 🚀