{"id":20864418,"url":"https://github.com/d1se0/portscan","last_synced_at":"2026-04-19T21:34:46.132Z","repository":{"id":247442676,"uuid":"825858610","full_name":"D1se0/portScan","owner":"D1se0","description":"portScan is a port scanning tool written in Python, designed for network auditing and ethical hacking. It allows you to scan open, closed and filtered ports on an IP or a range of IPs, providing detailed information about the services running on the open ports.","archived":false,"fork":false,"pushed_at":"2024-07-08T16:54:10.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-19T08:17:47.075Z","etag":null,"topics":["cibersecurity","command-line","commands","ethical-hacking","hacking","hackingetico","ip","kali-linux","linux","pentesters","pentesting","ports","portscan","redteam","scanner"],"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/D1se0.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-08T16:31:08.000Z","updated_at":"2024-07-08T16:58:20.000Z","dependencies_parsed_at":"2024-07-08T21:06:55.806Z","dependency_job_id":"3d13a4cc-46ea-46ce-ba74-2cf0f388b336","html_url":"https://github.com/D1se0/portScan","commit_stats":null,"previous_names":["d1se0/portscan"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/D1se0%2FportScan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/D1se0%2FportScan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/D1se0%2FportScan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/D1se0%2FportScan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/D1se0","download_url":"https://codeload.github.com/D1se0/portScan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243238967,"owners_count":20259126,"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","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":["cibersecurity","command-line","commands","ethical-hacking","hacking","hackingetico","ip","kali-linux","linux","pentesters","pentesting","ports","portscan","redteam","scanner"],"created_at":"2024-11-18T05:42:17.724Z","updated_at":"2025-12-25T22:18:58.418Z","avatar_url":"https://github.com/D1se0.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# portScan\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/D1se0/portScan/assets/164921056/9c78824a-af22-4377-ad6f-774c122f5410\" alt=\"Directorybrute\" width=\"400\"\u003e\n\u003c/p\u003e\n\n## Description\n\n`portScan` is a port scanning tool written in `Python`, designed for network auditing and ethical hacking. It allows you to scan open, closed and filtered ports on an `IP` or a range of `IPs`, providing detailed information about the services running on the open ports.\n\n## Characteristics\n\n- Port scanning on a specific `IP`.\n- Port scanning in a range of `IPs` specified in `CIDR` notation.\n- Shows only open ports with brief details.\n- Show all ports with full details using `nmap`.\n- Export scan results to a `.txt` file.\n- Interrupt the scan with Ctrl+C showing an output message.\n\n## Requirements\n\n- Python 3.x\n- `termcolor`\n- `scapy`\n- `nmap`\n\n## Install\n\n1. **Clone the repository**:\n\n    ```bash\n    git clone https://github.com/D1se0/portScan.git\n    cd port scan\n    ```\n\n3. **Run the installation script**:\n\n    ```bash\n    ./requirements.sh\n    ```\n\n## Use\n\nThe `portScan` tool offers several options and parameters for port scanning. The parameters and usage examples are detailed below.\n\n### Parameters\n\n- `-i`, `--ip`: Unique IP address to scan.\n- `-s`, `--subnet`: CIDR notation to scan a range of IPs (e.g. `10.10.11.0/24`).\n- `--only-open`: Show only open ports with brief details.\n\n- `--only-filtered`: Show only filtered ports.\n- `--all`: Show all open ports with detailed information using `nmap`.\n- `--export \u003cfile\u003e`: Export the scan results to a `.txt` file.\n\n### Examples of use\n\n1. **Port scanning on a specific IP**:\n\n    ```bash\n    python3 portScan.py -i \u003cIP\u003e --only-open\n    ```\n\n3. **Scanning a range of IPs**:\n\n    ```bash\n    python3 portScan.py -s \u003cIP\u003e/24 --only-open\n    ```\n\n    ### Example:\n\n    ```bash\n    python3 portScan.py -s 10.10.11.0/24 --only-open\n    ```\n\n3. **Show all ports with full details**:\n\n    ```bash\n    python3 portScan.py -i \u003cIP\u003e --all\n    ```\n\n5. **Export results to a file**:\n\n    ```bash\n    python3 portScan.py -i \u003cIP\u003e --all --export \u003cFILE\u003e.txt\n    ```\n\n## Output Example\n\n### Scanning with `--only-open`\n\n```plaintext\n    ****************************************\n    *                                      *\n    *            portScan Tool             *\n    *            portScan v1.0             *\n    *           by Diseo (@d1se0)          *\n    *                                      *\n    ****************************************\n\nScanning 192.168.5.132...\nDetailed information for open ports:\nPort 21 is open\n - Service: ftp\n - Protocol: TCP\nPort 22 is open\n - Service: ssh\n - Protocol: TCP\nPort 80 is open\n - Service: http\n - Protocol: TCP\n\nScan completed in: 0:00:35.303330\n```\n\n### Scan with `--all`\n\n```bash\n    ****************************************\n    *                                      *\n    *            portScan Tool             *\n    *            portScan v1.0             *\n    *           by Diseo (@d1se0)          *\n    *                                      *\n    ****************************************\n\nScanning 192.168.5.132...\n\nNmap scan report for 192.168.5.132\nHost is up (0.00029s latency).\n\nPORT   STATE SERVICE VERSION\n21/tcp open  ftp     vsftpd 3.0.3\n| ftp-anon: Anonymous FTP login allowed (FTP code 230)\n|_Can't get directory listing: TIMEOUT\n| ftp-syst:\n|   STAT:\n| FTP server status:\n|      Connected to 192.168.5.199\n|      Logged in as ftp\n|      TYPE: ASCII\n|      No session bandwidth limit\n|      Session timeout in seconds is 300\n|      Control connection is plain text\n|      Data connections will be plain text\n|      At session startup, client count was 1\n|      vsFTPd 3.0.3 - secure, fast, stable\n|_End of status\n22/tcp open  ssh     OpenSSH 7.9p1 Debian 10+deb10u4 (protocol 2.0)\n| ssh-hostkey:\n|   2048 f6:b2:97:f0:f1:27:17:64:94:31:03:1b:67:5d:14:da (RSA)\n|   256 66:76:43:83:5c:e7:19:39:81:35:90:be:b8:44:43:5e (ECDSA)\n|_  256 69:91:f4:79:f9:3d:2b:d7:58:15:46:3b:b0:3a:d2:97 (ED25519)\n80/tcp open  http    Apache httpd 2.4.38 ((Debian))\n|_http-title: Apache2 Debian Default Page: It works\n|_http-server-header: Apache/2.4.38 (Debian)\nMAC Address: 00:0C:29:8F:E1:EA (VMware)\nService Info: OSs: Unix, Linux; CPE: cpe:/o:linux:linux_kernel\n\nNmap done: 1 IP address (1 host up) scanned in 37.03 seconds\n```\n\n## Contributions\n\nContributions are welcome. Please open an issue or submit a pull request to improve this tool.\n\n## License\n\n`portScan` is licensed under the MIT License.\n\n----\n\nThank you for using `portScan`!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd1se0%2Fportscan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd1se0%2Fportscan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd1se0%2Fportscan/lists"}