{"id":34830417,"url":"https://github.com/umerfarok/networkmonitor","last_synced_at":"2026-05-27T07:32:35.597Z","repository":{"id":270014464,"uuid":"909141167","full_name":"umerfarok/NetworkMonitor","owner":"umerfarok","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-01T23:29:34.000Z","size":1130,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-02T08:57:38.565Z","etag":null,"topics":["monitor","wifi-network","wifi-security"],"latest_commit_sha":null,"homepage":"https://netmoniter.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/umerfarok.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-27T20:52:46.000Z","updated_at":"2026-02-01T23:25:37.000Z","dependencies_parsed_at":"2025-02-20T08:25:12.420Z","dependency_job_id":"0ec0939a-5123-4c31-974f-934ad02d43c3","html_url":"https://github.com/umerfarok/NetworkMonitor","commit_stats":null,"previous_names":["umerfarok/netmoniter","umerfarok/networkmonitor"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/umerfarok/NetworkMonitor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umerfarok%2FNetworkMonitor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umerfarok%2FNetworkMonitor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umerfarok%2FNetworkMonitor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umerfarok%2FNetworkMonitor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/umerfarok","download_url":"https://codeload.github.com/umerfarok/NetworkMonitor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umerfarok%2FNetworkMonitor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33556544,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["monitor","wifi-network","wifi-security"],"created_at":"2025-12-25T15:49:55.438Z","updated_at":"2026-05-27T07:32:35.591Z","avatar_url":"https://github.com/umerfarok.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 NetworkMonitor\n\n**A powerful network monitoring and control tool - Better than NetCut!**\n\n[![Release](https://img.shields.io/github/v/release/umerfarok/networkmonitor?style=for-the-badge)](https://github.com/umerfarok/networkmonitor/releases)\n[![Downloads](https://img.shields.io/github/downloads/umerfarok/networkmonitor/total?style=for-the-badge)](https://github.com/umerfarok/networkmonitor/releases)\n[![License](https://img.shields.io/github/license/umerfarok/networkmonitor?style=for-the-badge)](LICENSE)\n\n📖 **Documentation**: [umerfarok.github.io/networkmonitor](https://umerfarok.github.io/networkmonitor)\n\n---\n\n## 🎯 One-Click Installation (Windows)\n\n**Just download and run - everything is included!**\n\n### [⬇️ Download NetworkMonitor Installer](https://github.com/umerfarok/networkmonitor/releases/latest)\n\n1. **Download** `NetworkMonitor-Windows-Setup-*.exe`\n2. **Double-click** to install (right-click → Run as administrator)\n3. **Done!** Dashboard opens automatically\n\n\u003e ✅ **No manual setup required!** The installer automatically installs:\n\u003e - NetworkMonitor application\n\u003e - Npcap driver (for network scanning)\n\u003e - All required components\n\u003e - Firewall rules\n\n---\n\n## 📱 Other Platforms\n\n| Platform | Download | Notes |\n|----------|----------|-------|\n| **Linux** | [Download](https://github.com/umerfarok/networkmonitor/releases/latest) | Run with `sudo ./NetworkMonitor` |\n| **macOS** | [Download](https://github.com/umerfarok/networkmonitor/releases/latest) | Run with `sudo ./NetworkMonitor` |\n\n\u003e 📚 **Need help?** See [QUICK_START.md](QUICK_START.md) or [INSTALLATION.md](INSTALLATION.md)\n\n---\n\n## ✨ Features\n\n- 🖥️ **Device Discovery**: See all devices on your network\n- ✂️ **Network Cut/Restore**: Disconnect devices using ARP spoofing\n- 🔒 **Protection**: Protect devices from ARP attacks\n- ⚡ **Speed Limiting**: Control bandwidth per device\n- 📊 **Real-time Monitoring**: Live bandwidth and connection stats\n- 🌐 **Modern Web Dashboard**: Beautiful React-based UI\n- 🖱️ **Drag \u0026 Drop**: Easy device management\n- 💻 **Cross-Platform**: Windows, Linux, macOS support\n- ☁️ **Vercel Support**: Host dashboard in cloud, run backend locally\n\n## Running NetworkMonitor\n\n1. Launch NetworkMonitor from the Start Menu or desktop shortcut.\n   - Ensure you run it as administrator\n   - A modern status dashboard will appear showing the application status\n   - The web interface will open automatically in your default browser\n\n2. Using the Status Dashboard:\n   - Monitor application status through the visual indicator\n   - Click \"Open in Browser\" to access the web interface\n   - Use \"Run in Background\" to minimize to system tray\n   - Copy the web interface URL with one click\n   - Exit safely using the Exit button\n\n3. System Tray Features:\n   - Minimize the application to system tray for background operation\n   - Right-click the tray icon for quick access to common actions\n   - Double-click to restore the dashboard window\n\n4. If you see any dependency warnings:\n   - Verify that all prerequisites are installed\n   - Check that Python packages are installed correctly\n   - Refer to the troubleshooting section below\n\n## Troubleshooting\n\n### Common Issues\n\n1. \"Npcap not found\" error:\n   - Ensure Npcap is installed from https://npcap.com\n   - Try reinstalling Npcap with \"WinPcap API-compatible Mode\" checked\n\n2. Python package errors:\n   - Open an administrator command prompt\n   - Run: `pip install -r \"C:\\Program Files\\NetworkMonitor\\requirements.txt\"`\n\n3. \"Administrator privileges required\":\n   - Right-click NetworkMonitor shortcut\n   - Select \"Run as administrator\"\n\n4. UI Display Issues:\n   - Ensure your Windows theme is set to 100% scaling\n   - Update your graphics drivers\n   - Try running with compatibility mode if needed\n\n### Getting Help\n\nIf you encounter issues:\n1. Check the application logs at `%LOCALAPPDATA%\\NetworkMonitor\\logs`\n2. Open an issue on our GitHub repository\n3. Include error messages and logs when reporting issues\n\n## Quick Start (Easy Installation)\n\n1. **Download** NetworkMonitor to your computer\n\n2. **Run the installer** (as Administrator):\n   ```cmd\n   install.bat\n   ```\n\n3. **Start the application**:\n   ```cmd\n   start.bat\n   ```\n\n4. **Open your browser** and go to: http://localhost:5000\n\nThat's it! The dashboard will show all devices on your network.\n\n## Using with Vercel (Cloud Dashboard)\n\nNetworkMonitor supports a **hybrid architecture** where the frontend is hosted on Vercel and connects to your local backend:\n\n### How it Works\n- **Frontend (Vercel)**: Beautiful, responsive dashboard accessible from anywhere\n- **Backend (Local)**: Runs on your computer with admin privileges for network scanning\n\n### Setup\n\n1. **Start the local backend**:\n   ```cmd\n   start.bat\n   ```\n\n2. **Access the Vercel-hosted dashboard** at your deployment URL\n\n3. The dashboard will automatically connect to `http://localhost:5000`\n\n### Environment Variables (Vercel)\n\nSet `NEXT_PUBLIC_API_URL` in your Vercel project settings if using a different backend URL.\n\n## Architecture\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│                    Your Computer                              │\n├──────────────────────────────────────────────────────────────┤\n│  ┌────────────────────┐    ┌─────────────────────────────┐  │\n│  │   Local Backend    │    │    Network Interface        │  │\n│  │   (Flask API)      │───▶│    (WiFi/Ethernet)          │  │\n│  │   Port 5000        │    │                             │  │\n│  └────────────────────┘    └─────────────────────────────┘  │\n│           ▲                                                   │\n└───────────│───────────────────────────────────────────────────┘\n            │\n            │ CORS-enabled API calls\n            │\n┌───────────▼───────────────────────────────────────────────────┐\n│                    Vercel (Cloud)                              │\n├───────────────────────────────────────────────────────────────┤\n│  ┌────────────────────────────────────────────────────────┐  │\n│  │                  Next.js Frontend                       │  │\n│  │                  (React Dashboard)                      │  │\n│  │           https://your-app.vercel.app                   │  │\n│  └────────────────────────────────────────────────────────┘  │\n└───────────────────────────────────────────────────────────────┘\n```\n\n## Development Setup\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/umerfarok/networkmonitor.git\n   ```\n\n2. Install development dependencies:\n   ```\n   pip install -r requirements.txt\n   pip install -r requirements-build.txt\n   ```\n\n3. Install Node.js dependencies for the web interface:\n   ```\n   cd networkmonitor/web\n   npm install\n   ```\n\n4. Run the backend (with admin privileges):\n   ```\n   python -m networkmonitor\n   ```\n\n5. Run the frontend (in another terminal):\n   ```\n   cd networkmonitor/web\n   npm run dev\n   ```\n\n6. Access the dashboard at http://localhost:3000\n\n## API Reference\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `/api/status` | GET | Check server status |\n| `/api/devices` | GET | List all discovered devices |\n| `/api/device/block` | POST | Block a device by IP |\n| `/api/device/cut` | POST | Cut device network access (ARP spoof) |\n| `/api/device/restore` | POST | Restore device network access |\n| `/api/device/protect` | POST | Protect a device from attacks |\n| `/api/device/limit` | POST | Set speed limit for a device |\n| `/api/network/gateway` | GET | Get gateway information |\n| `/api/wifi/interfaces` | GET | List network interfaces |\n\n## Security Notes\n\n- NetworkMonitor requires **Administrator/Root** privileges\n- All API endpoints validate IP addresses to prevent injection attacks\n- The backend uses secure subprocess calls (no shell=True with user input)\n- CORS is configured to allow Vercel deployments\n\n## License\n\nMIT License - See LICENSE file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumerfarok%2Fnetworkmonitor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumerfarok%2Fnetworkmonitor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumerfarok%2Fnetworkmonitor/lists"}