Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


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:


multithreading command line port scan utility, pip package




No releases published


No packages published


You can’t perform that action at this time.