multithreading command line port scan utility, pip package
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


PyPI version   Python 3.x   PyPI license   Downloads

PortScan is a light-weight command line utility that allows user to conduct scanning over a range of IP addresses and port ranges with multi-threading.

Install: pip install portscan

Upgrade: pip install portscan --upgrade

Usage: portscan [] [-p 22,80-200 [-t 100 [-w 1 [-e]]]]

New in version 0.2.1:

Simple Command

By default the command checks for your Local Area Network IP first, and then initiate a block wise search. specify IP if you want to search any other IP blocks. Note: This is not available before 0.2.1, please update or specify IP if you're using 0.2.0 and older

Use -w [float] to change timeout settings from default of 3 seconds: for LAN, this can be as low as 0.1. 1 is usually good enough for continental level connection.

Fast scanning Scanned 5000 ports in 2 seconds

To show more potential connection, use -e, this will show you all ports that are not timed out.

Show more potential connection


ip: default and optional (since 0.2.1, required before 0.2.1) argument, can parse single IP, list of IP, IP blocks: # single IP # A 24 block, from to

[,] # The aforementioned 24 block and

"[,]" # if you want to use space in the command, wrap in quotes.


-p, --port: port range, default 22,23,80, use , as a delimiter without space, support port range (e.g. 22-100,5000).

-t, --threadnum: thread numbers, default 500, as of now, thread number have a hard cap of 2048. More thread will increase performance on large scale scans.

-e, --show_refused: show connection errors other than timeouts, e.g. connection refused, permission denied with errno number as they happen.

-w, --wait: Wait time for socket to respond. If scanning LAN or relatively fast internet connection, this can be set to 1 or even 0.2 for faster scanning. Default 3 seconds


Jamieson Becker: For coming up with a way to find local IP on stackoverflow, which I used: