Skip to content

Commit 9fa8ef1

Browse files
authored
Create README.md
1 parent b0618ed commit 9fa8ef1

File tree

1 file changed

+87
-0
lines changed

1 file changed

+87
-0
lines changed

README.md

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# HTTP Status Checker Tool
2+
3+
This repository contains two Python scripts, `check_http.py` and `fast_check_http.py`, that check the HTTP status of subdomains listed in a text file. These tools are useful for web developers, system administrators, and security professionals to quickly verify the availability of web resources.
4+
5+
## Features
6+
7+
- Check the HTTP status of multiple subdomains.
8+
- Fast checking mode with concurrent requests.
9+
- Clear and color-coded terminal output for easy readability.
10+
- Handles unverified HTTPS requests gracefully.
11+
12+
## Download
13+
14+
```bash
15+
git clone https://github.com/itzNamanDev/HTTPStatus.git
16+
```
17+
18+
## Enter Directory
19+
20+
```bash
21+
cd HTTPStatus/
22+
```
23+
24+
## Requirements
25+
26+
Make sure you have Python 3 installed on your machine. You can install the required dependencies using pip. See the `requirements.txt` file for the list of dependencies.
27+
28+
### Install Dependencies
29+
30+
```bash
31+
pip install -r requirements.txt
32+
```
33+
34+
## Usage
35+
**Check HTTP Status
36+
To check the HTTP status of subdomains, run the following command:
37+
38+
```bash
39+
python3 check_http.py -l <subdomains_file>
40+
```
41+
42+
`subdomains_file`: A text file containing a list of subdomains (one per line) you want to check.
43+
## Fast Check HTTP Status
44+
For a faster check, use the fast_check_http.py script:
45+
46+
```bash
47+
python3 fast_check_http.py -l <subdomains_file>
48+
```
49+
## Example
50+
Given a file named subdomains.txt with the following content:
51+
52+
```bash
53+
nepal.gov.np
54+
mail.nepal.gov.np
55+
www.nepal.gov.np
56+
mx1.nepal.gov.np
57+
```
58+
59+
You can run the following command:
60+
61+
```bash
62+
python3 check_http.py -l subdomains.txt
63+
```
64+
or for the fast version:
65+
66+
```bash
67+
python3 fast_check_http.py -l subdomains.txt
68+
```
69+
## Sample Output
70+
The output will be color-coded for clarity:
71+
```bash
72+
[200] - mail.nepal.gov.np
73+
[200] - www.nepal.gov.np
74+
[TIMEOUT] - mx1.nepal.gov.np
75+
```
76+
`[200]` indicates a successful HTTP response.
77+
`[TIMEOUT]` indicates that the request to the subdomain timed out.
78+
79+
## Notes
80+
- You may receive warnings about unverified HTTPS requests. It is recommended to add certificate verification for production use.
81+
- Ensure that the subdomain file is properly formatted with one subdomain per line.
82+
83+
## Contact Me:
84+
- Email:
85+
- Discord:
86+
- Telegram:
87+
- Twitter:

0 commit comments

Comments
 (0)