{"id":23665784,"url":"https://github.com/b3ta-blocker/netrecon","last_synced_at":"2026-04-27T08:32:04.615Z","repository":{"id":250901451,"uuid":"835384048","full_name":"B3TA-BLOCKER/NetRecon","owner":"B3TA-BLOCKER","description":"Automates network reconnaissance using nmap and performs a detailed scan on a given IP address. Supports Linux and macOS, with manual instructions for Windows.","archived":false,"fork":false,"pushed_at":"2024-07-30T14:01:30.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-20T21:36:52.608Z","etag":null,"topics":["automation","linux","network-scanning","nmap","python","reconnaissance","security"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/B3TA-BLOCKER.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-07-29T18:11:41.000Z","updated_at":"2024-07-30T14:03:01.000Z","dependencies_parsed_at":"2024-07-30T18:57:17.111Z","dependency_job_id":"c9ef3351-b8bc-4dab-80b5-ac01ac8428c1","html_url":"https://github.com/B3TA-BLOCKER/NetRecon","commit_stats":null,"previous_names":["b3ta-blocker/netrecon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/B3TA-BLOCKER/NetRecon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/B3TA-BLOCKER%2FNetRecon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/B3TA-BLOCKER%2FNetRecon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/B3TA-BLOCKER%2FNetRecon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/B3TA-BLOCKER%2FNetRecon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/B3TA-BLOCKER","download_url":"https://codeload.github.com/B3TA-BLOCKER/NetRecon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/B3TA-BLOCKER%2FNetRecon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32329463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"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":["automation","linux","network-scanning","nmap","python","reconnaissance","security"],"created_at":"2024-12-29T06:16:25.378Z","updated_at":"2026-04-27T08:32:04.586Z","avatar_url":"https://github.com/B3TA-BLOCKER.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \n  # NetRecon\n  \n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cstrong\u003e\n        \u003cp\u003e\n            NetRecon is a Python-based network reconnaissance tool that is designed to make network scanning and penetration testing easier. This script uses `nmap` to perform comprehensive network scans.\n        \u003c/p\u003e\n    \u003c/strong\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n## Features\n\n- Detects and installs `nmap` if not already installed.\n- Performs aggressive scans on all 65,535 TCP ports.\n- Compatible with multiple operating systems: Linux, macOS, and Windows.\n\n## Installation\n\nBefore running the script, ensure you have Python installed on your system. The script will handle the installation of `nmap` for Linux distributions and macOS. Windows users need to install `nmap` manually.\n\nFor Linux distributions, the script uses the `distro` package to detect the Linux version. Install it using:\n\n```bash\npip install distro\n```\n\n## Usage\n\nClone the repository and run the script:\n\n```bash\ngit clone https://github.com/B3TA-BLOCKER/NetRecon.git\ncd NetRecon\npython3 main.py\n```\n\nThe script will prompt you to enter an IP address for scanning:\n\n```plaintext\nEnter the IP address: \u003cyour-ip-address\u003e\n```\n\n## Example\n\nHere is an example of how the script works:\n\n```plaintext\nEnter the ip: 10.1.170.65\nNmap version 7.94SVN ( https://nmap.org )\nPlatform: x86_64-pc-linux-gnu\nCompiled with: liblua-5.4.6 openssl-3.2.2 libssh2-1.11.0 libz-1.3.1 libpcre2-10.42 libpcap-1.10.4 nmap-libdnet-1.12 ipv6\nCompiled without:\nAvailable nsock engines: epoll poll select\nStarting Nmap 7.94SVN ( https://nmap.org ) at 2024-07-30 19:00 PKT\nNSE: Loaded 156 scripts for scanning.\nNSE: Script Pre-scanning.\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.00s elapsed\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.00s elapsed\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.00s elapsed\nInitiating Parallel DNS resolution of 1 host. at 19:00\nCompleted Parallel DNS resolution of 1 host. at 19:00, 0.04s elapsed\nInitiating SYN Stealth Scan at 19:00\nScanning 10.1.170.65 [65535 ports]\nCompleted SYN Stealth Scan at 19:00, 1.33s elapsed (65535 total ports)\nInitiating Service scan at 19:00\nInitiating OS detection (try #1) against 10.1.170.65\nRetrying OS detection (try #2) against 10.1.170.65\nNSE: Script scanning 10.1.170.65.\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.03s elapsed\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.01s elapsed\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.01s elapsed\nNmap scan report for 10.1.170.65\nHost is up (0.00010s latency).\nAll 65535 scanned ports on 10.1.170.65 are in ignored states.\nNot shown: 65535 closed tcp ports (reset)\nToo many fingerprints match this host to give specific OS details\nNetwork Distance: 0 hops\n\nNSE: Script Post-scanning.\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.02s elapsed\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.00s elapsed\nInitiating NSE at 19:00\nCompleted NSE at 19:00, 0.00s elapsed\nRead data files from: /usr/bin/../share/nmap\nOS and Service detection performed. Please report any incorrect results at https://nmap.org/submit/ .\nNmap done: 1 IP address (1 host up) scanned in 3.65 seconds\n           Raw packets sent: 65547 (2.885MB) | Rcvd: 131092 (5.508MB)\n\n```\n\n## Author\n\n- [Hassaan Ali Bukhari](https://github.com/B3TA-BLOCKER)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb3ta-blocker%2Fnetrecon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fb3ta-blocker%2Fnetrecon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb3ta-blocker%2Fnetrecon/lists"}