{"id":48335813,"url":"https://github.com/urbanyl/npocket","last_synced_at":"2026-04-11T08:00:54.313Z","repository":{"id":349245924,"uuid":"1201627939","full_name":"urbanyl/Npocket","owner":"urbanyl","description":"Npocket is a lightweight, modern take on Nmap, designed to keep the core network‑scanning power while making everything cleaner, faster, and easier to use.","archived":false,"fork":false,"pushed_at":"2026-04-05T17:03:24.000Z","size":33,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-09T06:03:05.041Z","etag":null,"topics":["network","network-scanning"],"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/urbanyl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-04T23:51:29.000Z","updated_at":"2026-04-05T17:03:30.000Z","dependencies_parsed_at":"2026-04-07T04:00:31.585Z","dependency_job_id":null,"html_url":"https://github.com/urbanyl/Npocket","commit_stats":null,"previous_names":["urbanyl/npocket","henissartj/npocket"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/urbanyl/Npocket","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbanyl%2FNpocket","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbanyl%2FNpocket/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbanyl%2FNpocket/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbanyl%2FNpocket/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/urbanyl","download_url":"https://codeload.github.com/urbanyl/Npocket/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbanyl%2FNpocket/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31673067,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"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":["network","network-scanning"],"created_at":"2026-04-05T02:00:34.343Z","updated_at":"2026-04-11T08:00:54.252Z","avatar_url":"https://github.com/urbanyl.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Npocket - Network Exploration \u0026 Security Auditing Tool\n\n```text\n    _   __                 __        __ \n   / | / /___  ____  _____/ /_____  / /_\n  /  |/ / __ \\/ __ \\/ ___/ //_/ _ \\/ __/\n / /|  / /_/ / /_/ / /__/ ,\u003c /  __/ /_  \n/_/ |_/ .___/\\____/\\___/_/|_|\\___/\\__/  \n     /_/                                \n```\n\n\u003e **The full power of Nmap, right in your pocket.**\n\n**Npocket** is a highly concurrent, ultra-fast, and modular network scanner built entirely in Python using standard libraries (`asyncio`). It aims to be a modern alternative to Nmap, boasting better performance, built-in intelligent features, and beautiful outputs.\n\n## 🚀 Key Features\n\n- **Ultra-Fast Asynchronous Engine**: Uses `asyncio` to scan thousands of ports in seconds without thread-pool overhead.\n- **Smart Adaptive Timing (`--smart`)**: Automatically adjusts timeouts dynamically based on network latency and packet loss.\n- **Subdomain Enumeration \u0026 DNS Bruteforce (`-sD`)**: Automatically enumerates subdomains for any target domain before scanning them.\n- **Intelligent Basic Bruteforce (`-B`)**: Detects open services (like FTP) and attempts common default credentials (`admin:admin`, `root:root`, etc.) to find easy wins immediately.\n- **Web Info Grabber**: During service detection (`-sV`), Npocket extracts the HTTP `\u003ctitle\u003e` and `Server` headers.\n- **Basic OS Fingerprinting (`-O`)**: Uses TTL-based heuristics to guess the operating system.\n- **Multiple Export Formats**: Export results in JSON (`-oJ`), CSV (`-oC`), Markdown (`-oM`), or a **beautiful Interactive HTML Dashboard (`-oH`)**.\n- **Zero External Dependencies**: Built 100% with Python Standard Library.\n\n## 💻 Installation\n\n1. Ensure you have **Python 3.7+** installed.\n2. Clone the repository:\n   ```bash\n   git clone https://github.com/urbanyl/npocket.git\n   cd npocket\n   ```\n3. Run the scanner:\n   ```bash\n   # On Windows\n   py -m cli.main -h\n   \n   # On Linux/Mac\n   python3 -m cli.main -h\n   ```\n\n## 🛠️ Usage Examples\n\n**Basic Fast Port Scan (Top 100 ports)**\n```bash\npy -m cli.main 192.168.1.1\n```\n\n**Full Port Scan with Service Detection and OS Fingerprint**\n```bash\npy -m cli.main 10.0.0.1 -p all -sV -O\n```\n\n**Domain Target with Subdomain Enumeration \u0026 HTML Report**\n```bash\npy -m cli.main example.com -sD -p 80,443 -sV -oH dashboard.html\n```\n\n**Advanced Mode: Smart Timing + Bruteforce**\n```bash\npy -m cli.main 192.168.1.1 -p 21,22,80 -sV -B --smart\n```\n\n## 📖 CLI Options\n\n```text\n📌 General:\n  -h, --help            Show this help message and exit.\n\n🎯 Target Specification:\n  targets               Target IP, domain, CIDR or range\n                        Ex: 192.168.1.1, 10.0.0.0/24, example.com\n  -sD, --subdomains     Enumerate subdomains and bruteforce DNS if target is a domain\n\n🚪 Port Specification:\n  -p, --ports PORTS     Ports to scan (default: top100)\n                        Ex: 80,443,1000-2000, all, top100\n\n🔍 Scan Techniques:\n  -sS, --tcp            TCP Connect Scan (default)\n  -sU, --udp            UDP Scan\n  -sn, --ping-scan      Ping scan only (disables port scan)\n  -sV, --service        Service/Version detection on open ports (includes Web Grabber)\n  -O, --os-fingerprint  Enable basic OS detection\n  -B, --bruteforce      Basic intelligent bruteforce on discovered services (FTP, etc.)\n\n⚡ Performance \u0026 Timing:\n  -T, --timeout TIMEOUT Connection timeout in seconds (default: 1.5)\n  -c, --concurrency N   Number of concurrent async tasks (default: 500)\n  --smart               Enable smart adaptive timing (dynamically adjusts timeouts)\n\n📊 Output \u0026 Display:\n  -v, --verbose         Increase verbosity (debug mode)\n  --no-progress         Disable progress bar\n  -oJ, --output-json    Export results to JSON format\n  -oC, --output-csv     Export results to CSV format\n  -oM, --output-md      Export results to Markdown format\n  -oH, --output-html    Export results to HTML format (Dashboard)\n```\n\n## 🏗️ Architecture\n\nNpocket uses a clean, modular architecture:\n- `cli/`: Argument parsing and main entry point.\n- `scan/`: Core asynchronous engines (`port_scan.py`, `discover.py`, `service.py`, `subdomain.py`, `bruteforce.py`).\n- `parse/`: Input parsers for IPs, CIDRs, ranges, and ports.\n- `report/`: Formatters, UI colors, and exporters (JSON/CSV/HTML).\n- `utils/`: Logging, Configuration, and Progress bar logic.\n\n## 🤝 Contributing\nContributions, issues, and feature requests are welcome! Feel free to check the issues page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbanyl%2Fnpocket","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furbanyl%2Fnpocket","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbanyl%2Fnpocket/lists"}