Skip to content

Commit 08faa53

Browse files
author
RevoltSecurities
authored
Update README.md
1 parent 45ccc31 commit 08faa53

File tree

1 file changed

+43
-49
lines changed

1 file changed

+43
-49
lines changed

README.md

Lines changed: 43 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Subprober - A Fast Multi-Purpose Http Probing Tool for Penetration Testing
1+
# Subprober - An essential HTTP multi-purpose Probing Tool for Penetration Testers and Security Researchers with Asynchronous httpx client support
22

33
![GitHub last commit](https://img.shields.io/github/last-commit/sanjai-AK47/Subprober) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/sanjai-AK47/Subprober) [![GitHub license](https://img.shields.io/github/license/sanjai-AK47/Subprober)](https://github.com/sanjai-AK47/Subprober/blob/main/LICENSE) [![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue)](https://www.linkedin.com/in/d-sanjai-kumar-109a7227b/)
44

@@ -17,32 +17,20 @@ Subprober is a powerful and efficient tool designed for penetration testers and
1717
- Supports proxies and customizable Header for probing
1818
- Progress your probing tasks
1919

20-
### Features in V1.0.9:
20+
### Features in V2.0.0:
2121

2222
- **New Probing configurations**
2323

24-
- **-ip** : **finds the ips of urls**
25-
- **-cn** : **find the cname of urls**
26-
- **-maxr** : **maximum redirection for url**
27-
- **-ra** : **enable random agent to probe with random agent**
28-
- **-X** : **custom method for urls to probe**
29-
- **-H** : **set custom header for urls to probe**
30-
- **-sc** : **removed default to show response code and this flag to improve the subprober I/O**
31-
32-
- **Headless**
24+
- **--http2** : **Now subprober support to request with Http/2 version**
25+
- **--http-version** : **display the server supported http version of the host**
26+
- **--http-reason** : **display the reason for http connection of the host**
27+
- **--jarm-fingerprint** : **display the jarm figerprint hash of the host**
3328

34-
- **-ss** : **enable to probe and take screenshots for urls (required: chormedriver, geckodriver to be installed)**
35-
- **-st** : **set a timeout value for urls to take screenshots**
36-
- **-bt** : **select your browser type to take screenshots**
29+
### New Updates:
3730

38-
### Why Subprober:
39-
40-
Subprober is a http probing toolkit build in **python**, wait a minute? yes you read it right its build in python Which is high in concurrent to probe.
41-
Hey wait its **python** and **Concurrent** how and what about **GIL**? Yes let me Explain you, Subprober utilized asynchronous performance which make
42-
subprober to perform concurrent probing and taking screenshots which nearly gives performance like **GOLANG!!!**, Yes performance like **Golang** in **python**
43-
because it uses **uvloops** with **asynchronous** Libraries like **aiohttp**, **asyncio**, **arsenic**, **aiodns** by this, Subprober provide you more concurrent
44-
performance with high accuracy and Subprober is capable to handle high loads and ability to give high performance in even low end systems and also to your low end VPS
45-
without causing any high CPU loads even if it is high load of inputs to probe
31+
Subprober now supports HTTP/2 to give request and Improved concurrency using next generation http request client `httpx`
32+
and also now gives jarm figerprints and other probe configurations. Subprober Concurrency performance improved with
33+
more Asynchronous concurrency which make subprober more accurate and Concurrent tool for probing.
4634

4735
### Subprober Probing Configuration:
4836

@@ -64,6 +52,7 @@ without causing any high CPU loads even if it is high load of inputs to probe
6452
| Cname of Host | False | `-cn`, `--cname` |
6553
| Proxy | False | `-px`, `--proxy` |
6654
| Custom Headers | False | `-H`, `--header` |
55+
| Jarm | False | `-jarm` `--jarm-fingerprint` |
6756

6857
### Subprober headless configurations:
6958

@@ -105,7 +94,6 @@ subprober -h
10594

10695
```yaml
10796
subprober -h
108-
10997

11098
_____ __ ____ __
11199
/ ___/__ __/ /_ / __ \_________ / /_ ___ _____
@@ -117,12 +105,11 @@ subprober -h
117105

118106
@RevoltSecurities
119107

120-
121-
Subprober - An essential HTTP multi-purpose Probing Tool for Penetration testers
108+
Subprober - An essential HTTP multi-purpose Probing Tool for Penetration Testers and Security Researchers with Asynchronous httpx client support
122109

123110
[Description] :
124111

125-
Subprober is a high-performance tool designed for probing and extract vital information efficiently.
112+
Subprober is a high-performance tool designed for probing and extract vital information efficiently with Asynchronous concurrency performance
126113

127114
[Options]:
128115

@@ -134,34 +121,39 @@ Subprober - An essential HTTP multi-purpose Probing Tool for Penetration testers
134121

135122
[PROBES-CONFIG]:
136123

137-
-sc, --status-code display the response status code
138-
-tl, --title retrieve and display the titles
139-
-sv, --server identify and display the server name
140-
-wc, --word-count retrieve and display the content length
141-
-l , --location display the redirected location of the response.
142-
-apt, --application-type determine and display the application type.
143-
-p, --path specify a path for probe and get results ex: -p admin.php
144-
-px, --proxy specify a proxy to send the requests through your proxy or BurpSuite (ex: http://127.0.0.1:8080)
145-
-gw, --grep-word enable The grep word flag will be usefull when grepping partiuclar status codes
146-
-ar, --allow-redirect enabling these flag will make Subprober to follow the redirection and ger results
147-
-dhp, --disable-http-probe disables the subprober from probing to http protocols and only for https when no protocol is specified
148-
-X , --method request methods to probe and get response
149-
-H , --header add a custom headers for probing and -H can be used multiple times to pass multiple header values (ex: -H application/json -H X-Forwarded-Host: 127.0.0.1)
150-
-ra , --random-agent enable Random User-Agent to use for probing (default: subprober/Alpha)
151-
-ip , --ip find ip address for the host
152-
-cn , --cname find cname for the host
153-
-maxr, --max-redirection set a max value to follow redirection (default: 10)
124+
-sc, --status-code display the status code of the host
125+
-tl, --title display the title of host
126+
-sv, --server display the server name of the host
127+
-wc, --word-count display the content length of host
128+
-l , --location display the redirected location of the host
129+
-apt, --application-type display the content type of the host
130+
-p, --path specify a path for probe and get results (example: -p admin.php)
131+
-px, --proxy specify a proxy to send the requests through your proxy (ex: http://127.0.0.1:8080)
132+
-gw, --grep-word enable The grep word flag will be usefull when grepping particular status codes
133+
-ar, --allow-redirect enable to follow the redirections
134+
-dhp, --disable-http-probe disables the subprober from probing to http protocols and only for https when no protocol is specified
135+
-X , --method request methods to probe and get response (supported: get, post, head, put, delete, patch, trace, connect, options) (default: get)
136+
-H , --header add a custom headers for probing and -H can be used multiple times to pass multiple header values (ex: -H application/json -H X-Forwarded-Host: 127.0.0.1)
137+
-ra , --random-agent enable Random User-Agent to use for probing (default: subprober/Alpha)
138+
-ip , --ip display the ip of the host
139+
-cn , --cname display the cname of the host
140+
-maxr, --max-redirection set a max value to follow redirection (default: 10)
141+
-http2, --http2 enable to request with http2 support (default: Http/1.1)
142+
-htv, --http-version display the server supported http version of the host
143+
-hrs, --http-reason display the reason for http connection of the host
144+
-jarm, --jarm-fingerprint display the jarm figerprint hash of the host
154145

155146
[HEADLESS-Mode]:
156147

157148
-ss, --screenshot enable to take screenshot of the page using headless browsers with asynchronous performance
158-
-st, --screenshot-timeout eet a timeout values for taking screenshosts
149+
-st, --screenshot-timeout set a timeout values for taking screenshosts
159150
-br, --browser-type select a browser for taking screenshots and browser available: chrome, firefox (default: chrome)
160151
and requires chrome driver, gecko driver to be installed
152+
161153
[MATCHERS]:
162154

163-
-ex, --exclude exclude specific response status code(s) from the analysis.
164-
-mc, --match specify specific response status code(s) to include in the analysis.
155+
-ex, --exclude exclude specific response status code(s) from the analysis (example: -ex 404 403)
156+
-mc, --match specify specific response status code(s) to include in the analysis (example: -mc 200 302)
165157

166158
[OUTPUT]:
167159

@@ -175,11 +167,13 @@ Subprober - An essential HTTP multi-purpose Probing Tool for Penetration testers
175167
-to, --timeout set a custom timeout value for sending requests.
176168

177169
[UPDATES]:
178-
-up, --update update Subprober to the latest version (pip required to be installed)
179-
-sup, --show-updates shows the current version subprober updates
170+
171+
-up, --update update subprober to the latest version (pip required to be installed)
172+
-sup, --show-updates display the current or latest version subprober updates
173+
180174
[DEBUG]:
181175

182-
-h, --help show this help message for you and exit!
176+
-h, --help display this help message for you and exit!
183177
-s, --silent enable silent mode to suppress the display of Subprober banner and version information.
184178
-v, --verbose enable verbose mode to display error results on the console.
185179
-nc, --no-color enabling the --no-color will display the output without any CLI colors

0 commit comments

Comments
 (0)