π NetworkMonitor
A powerful network monitoring and control tool - Better than NetCut!
π Documentation: umerfarok.github.io/networkmonitor
π― One-Click Installation (Windows)
Just download and run - everything is included!
- Download
NetworkMonitor-Windows-Setup-*.exe
- Double-click to install (right-click β Run as administrator)
- Done! Dashboard opens automatically
β
No manual setup required! The installer automatically installs:
- NetworkMonitor application
- Npcap driver (for network scanning)
- All required components
- Firewall rules
π± Other Platforms
| Platform |
Download |
Notes |
| Linux |
Download |
Run with sudo ./NetworkMonitor |
| macOS |
Download |
Run with sudo ./NetworkMonitor |
π Need help? See QUICK_START.md or INSTALLATION.md
β¨ Features
- π₯οΈ Device Discovery: See all devices on your network
- βοΈ Network Cut/Restore: Disconnect devices using ARP spoofing
- π Protection: Protect devices from ARP attacks
- β‘ Speed Limiting: Control bandwidth per device
- π Real-time Monitoring: Live bandwidth and connection stats
- π Modern Web Dashboard: Beautiful React-based UI
- π±οΈ Drag & Drop: Easy device management
- π» Cross-Platform: Windows, Linux, macOS support
- βοΈ Vercel Support: Host dashboard in cloud, run backend locally
Running NetworkMonitor
-
Launch NetworkMonitor from the Start Menu or desktop shortcut.
- Ensure you run it as administrator
- A modern status dashboard will appear showing the application status
- The web interface will open automatically in your default browser
-
Using the Status Dashboard:
- Monitor application status through the visual indicator
- Click "Open in Browser" to access the web interface
- Use "Run in Background" to minimize to system tray
- Copy the web interface URL with one click
- Exit safely using the Exit button
-
System Tray Features:
- Minimize the application to system tray for background operation
- Right-click the tray icon for quick access to common actions
- Double-click to restore the dashboard window
-
If you see any dependency warnings:
- Verify that all prerequisites are installed
- Check that Python packages are installed correctly
- Refer to the troubleshooting section below
Troubleshooting
Common Issues
-
"Npcap not found" error:
- Ensure Npcap is installed from https://npcap.com
- Try reinstalling Npcap with "WinPcap API-compatible Mode" checked
-
Python package errors:
- Open an administrator command prompt
- Run:
pip install -r "C:\Program Files\NetworkMonitor\requirements.txt"
-
"Administrator privileges required":
- Right-click NetworkMonitor shortcut
- Select "Run as administrator"
-
UI Display Issues:
- Ensure your Windows theme is set to 100% scaling
- Update your graphics drivers
- Try running with compatibility mode if needed
Getting Help
If you encounter issues:
- Check the application logs at
%LOCALAPPDATA%\NetworkMonitor\logs
- Open an issue on our GitHub repository
- Include error messages and logs when reporting issues
Quick Start (Easy Installation)
-
Download NetworkMonitor to your computer
-
Run the installer (as Administrator):
-
Start the application:
-
Open your browser and go to: http://localhost:5000
That's it! The dashboard will show all devices on your network.
Using with Vercel (Cloud Dashboard)
NetworkMonitor supports a hybrid architecture where the frontend is hosted on Vercel and connects to your local backend:
How it Works
- Frontend (Vercel): Beautiful, responsive dashboard accessible from anywhere
- Backend (Local): Runs on your computer with admin privileges for network scanning
Setup
-
Start the local backend:
-
Access the Vercel-hosted dashboard at your deployment URL
-
The dashboard will automatically connect to http://localhost:5000
Environment Variables (Vercel)
Set NEXT_PUBLIC_API_URL in your Vercel project settings if using a different backend URL.
Architecture
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Your Computer β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ββββββββββββββββββββββ βββββββββββββββββββββββββββββββ β
β β Local Backend β β Network Interface β β
β β (Flask API) βββββΆβ (WiFi/Ethernet) β β
β β Port 5000 β β β β
β ββββββββββββββββββββββ βββββββββββββββββββββββββββββββ β
β β² β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
β CORS-enabled API calls
β
βββββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Vercel (Cloud) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Next.js Frontend β β
β β (React Dashboard) β β
β β https://your-app.vercel.app β β
β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Development Setup
-
Clone the repository:
git clone https://github.com/umerfarok/networkmonitor.git
-
Install development dependencies:
pip install -r requirements.txt
pip install -r requirements-build.txt
-
Install Node.js dependencies for the web interface:
cd networkmonitor/web
npm install
-
Run the backend (with admin privileges):
-
Run the frontend (in another terminal):
cd networkmonitor/web
npm run dev
-
Access the dashboard at http://localhost:3000
API Reference
| Endpoint |
Method |
Description |
/api/status |
GET |
Check server status |
/api/devices |
GET |
List all discovered devices |
/api/device/block |
POST |
Block a device by IP |
/api/device/cut |
POST |
Cut device network access (ARP spoof) |
/api/device/restore |
POST |
Restore device network access |
/api/device/protect |
POST |
Protect a device from attacks |
/api/device/limit |
POST |
Set speed limit for a device |
/api/network/gateway |
GET |
Get gateway information |
/api/wifi/interfaces |
GET |
List network interfaces |
Security Notes
- NetworkMonitor requires Administrator/Root privileges
- All API endpoints validate IP addresses to prevent injection attacks
- The backend uses secure subprocess calls (no shell=True with user input)
- CORS is configured to allow Vercel deployments
License
MIT License - See LICENSE file for details