{"id":22449049,"url":"https://github.com/s-r-e-e-r-a-j/netscope","last_synced_at":"2025-10-16T06:30:31.350Z","repository":{"id":266090450,"uuid":"897354547","full_name":"s-r-e-e-r-a-j/NetScope","owner":"s-r-e-e-r-a-j","description":"NetScope is a network scanning and monitoring Ethical Hacking tool designed to help users discover and monitor devices in their network.It provides useful information about each device.","archived":false,"fork":false,"pushed_at":"2025-08-28T13:38:20.000Z","size":2030,"stargazers_count":17,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-28T20:56:31.894Z","etag":null,"topics":["ethical-hacking","ethical-hacking-tools","kali-linux-hacking","kali-linux-tools","netscope","networkscanner","python","python3","pythontool","pythontools"],"latest_commit_sha":null,"homepage":"","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/s-r-e-e-r-a-j.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-02T13:42:59.000Z","updated_at":"2025-08-28T13:38:24.000Z","dependencies_parsed_at":"2024-12-21T12:25:26.899Z","dependency_job_id":"cae72667-241f-4282-9c0c-3546e66598bf","html_url":"https://github.com/s-r-e-e-r-a-j/NetScope","commit_stats":null,"previous_names":["s-r-e-e-r-a-j/netscope"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/s-r-e-e-r-a-j/NetScope","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FNetScope","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FNetScope/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FNetScope/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FNetScope/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s-r-e-e-r-a-j","download_url":"https://codeload.github.com/s-r-e-e-r-a-j/NetScope/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s-r-e-e-r-a-j%2FNetScope/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279162580,"owners_count":26117239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-16T02:00:06.019Z","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":["ethical-hacking","ethical-hacking-tools","kali-linux-hacking","kali-linux-tools","netscope","networkscanner","python","python3","pythontool","pythontools"],"created_at":"2024-12-06T05:07:28.613Z","updated_at":"2025-10-16T06:30:31.343Z","avatar_url":"https://github.com/s-r-e-e-r-a-j.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## NetScope\nNetScope is a network scanning and monitoring Ethical Hacking tool designed to help users discover and monitor devices in their network. It provides useful information about each device, such as IP addresses, MAC addresses, device manufacturers, and packet sizes. With live monitoring and filtering capabilities, NetScope is perfect for home users, network admins, and IT enthusiasts.\n\n## Features\n- **Network Scanning:** Quickly find devices in your network.\n- **Device Details:** Get details like IP address, MAC address, manufacturer name, and packet size.\n- **Live Monitoring:** Continuously track devices on your network with live updates.\n- **Manufacturer Filter:** View devices from a specific manufacturer (e.g., Apple, Samsung).\n- **Save Results:** Export scan results to a file for later use.\n\n## Compatibility\n- Linux (Debian, RHEL, Arch)\n  \n## Installation\n- Ensure you have **Python 3.7 or newer** installed on your system.\n- The required third-party Python libraries are listed below (standard libraries like `argparse`,`ipaddress` etc., are included with Python by default):\n- scapy\n- rich\n  \n### Installation Steps\n\n1. **Clone the repository:**\n\n```bash\ngit clone https://github.com/s-r-e-e-r-a-j/NetScope.git\n```\n2. **Navigate to the NetScope directory**\n```bash\ncd NetScope\n``` \n3.  **Install the required libraries using requirements.txt:**\n   \n```bash\npip3 install -r requirements.txt\n```\n**Note for Kali, Parrot, Ubuntu 23.04+ users:**\n\nIf you see an error like:\n```go\nerror: externally-managed-environment\n```\nthen use:\n```bash\npip3 install -r requirements.txt --break-system-packages\n```\n\n4. **Navigate to the NetScope directory**\n```bash\ncd NetScope\n ```\n5. **Install NetScope on your system**\n\n```bash\nsudo python3 install.py\n ```\n   **Then Enter `y` for install**\n   \n6. **Make sure to run NetScope as sudo:**\n\n```bash\nsudo netscope [command line options]\n```\n\n## Options\n\n\n| Option                  | Description                                                                |\n|-------------------------|----------------------------------------------------------------------------|\n| `-r`, `--ip-range`      | Specify the target IP range or subnet to scan (e.g., `192.168.1.0/24`).    |\n| `-n`, `--interfaces`    | Specify the network interface(s) to use (e.g., `eth0`, `wlan0`).           |\n| `-l`, `--live`          | Enable live monitoring to track network devices in real-time.              |\n| `-o`, `--output`        | Save scan results to a specified file.                                     |\n| `-m`, `--manufacturer`  | Filter devices by manufacturer (e.g., `Apple`, `Samsung`).                 |\n| `-i`, `--interval`      | Set the refresh interval for live monitoring (default: 5 seconds).         |\n\n\n\n## Example Usage\n### Basic Network Scan\nScan all devices within a subnet or IP range:\n\n```bash\nsudo netscope -r 192.168.1.0/24 -n eth0\n```\n### Save Scan Results to a File\nScan a network and save the output to a file:\n\n```bash\nsudo netscope -r 192.168.1.0/24 -n eth0 -o results.txt\n``` \n### Filter by Manufacturer\nOnly display devices from a specific manufacturer:\n\n```bash\nsudo netscope -r 192.168.1.0/24 -n eth0 -m \"Apple\"\n```\n### Enable Live Monitoring\nContinuously monitor the network for changes:\n\n```bash\nsudo netscope -r 192.168.1.0/24 -n eth0 -l\n```\n### Live Monitoring with a Custom Interval\nSet a custom refresh interval for live monitoring (e.g., 10 seconds):\n\n```bash\nsudo netscope -r 192.168.1.0/24 -n eth0 -l -i 10\n```\n## Output Example\nWhen scanning the network, NetScope displays a table with device details:\n\n```mathematica\n┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓\n┃       IP      ┃         MAC       ┃     Size    ┃      Vendor      ┃\n┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩\n│ 192.168.1.10  │ 00:1A:2B:3C:4D:5E │     128     │      Apple       │\n│ 192.168.1.15  │ 11:22:33:44:55:66 │     128     │      Samsung     │\n└───────────────┴───────────────────┴─────────────┴──────────────────┘\n```\n\n## uninstallation\n```bash\ncd NetScope\n```\n```bash\ncd NetScope\n```\n```bash\nsudo python3 install.py\n```\n**Then Enter `n` for uninstall**\n\n\n## License\nNetScope is licensed under the MIT License.\n\n## Author\n- **Sreeraj**\n  \nGitHub: https://github.com/s-r-e-e-r-a-j\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs-r-e-e-r-a-j%2Fnetscope","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs-r-e-e-r-a-j%2Fnetscope","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs-r-e-e-r-a-j%2Fnetscope/lists"}