Update README.md
parent
f18232d9b1
commit
9af4c00cc7
51
README.md
51
README.md
|
@ -1,42 +1,59 @@
|
||||||
# IPGeo
|
# IPGeo
|
||||||
|
|
||||||
IpGeo is a python tool to extract IP addresses from captured network traffic file (pcap/pcapng) and generate csv report containing details about the geolocation of each ip in the packets.
|
**IpGeo** is a Python tool to extract IP addresses from captured network traffic files (pcap/pcapng) and generate reports in various formats (JSON, CSV, TXT, Markdown) containing details about the geolocation of each IP in the packets.
|
||||||
|
|
||||||
### The report contains:
|
### The report contains:
|
||||||
1. Country:
|
1. Country
|
||||||
2. Country Code.
|
2. Country Code
|
||||||
3. Region
|
3. Region
|
||||||
4. Region Name
|
4. Region Name
|
||||||
5. City
|
5. City
|
||||||
6. Zip
|
6. District
|
||||||
7. Latitude
|
7. Zip
|
||||||
8. Longitude
|
8. Latitude
|
||||||
9. Timezone
|
9. Longitude
|
||||||
10. Isp
|
10. Timezone
|
||||||
11. Org
|
11. ISP
|
||||||
12. Ip
|
12. Organization
|
||||||
|
13. IP Address
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Use the package manager [pip3](https://pip.pypa.io/en/stable/) to install required modules.
|
Use the package manager [pip3](https://pip.pypa.io/en/stable/) to install the required modules:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip3 install colorama
|
pip3 install colorama requests pyshark
|
||||||
pip3 install requests
|
|
||||||
pip3 install pyshark
|
|
||||||
```
|
```
|
||||||
|
|
||||||
If you are not using Kali or ParrotOs or any other penetration distribution you need to install Tshark.
|
If you are not using Kali or ParrotOs or any other penetration distribution you need to install Tshark.
|
||||||
```bash
|
```bash
|
||||||
sudo apt install tshark
|
sudo apt install tshark
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
You can run the script either interactively or by using command-line arguments:
|
||||||
|
|
||||||
|
Interactive Mode
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 ipGeo.py
|
python3 ipGeo.py
|
||||||
# then you will enter captured traffic file path
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
You will be prompted to enter the captured traffic file path and the desired output format (json, csv, txt, md).
|
||||||
|
|
||||||
|
Command-Line Mode
|
||||||
|
|
||||||
|
You can also specify the pcap file and output format directly in the command line:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 ipGeo.py <path_to_pcap_file> --format <output_format>
|
||||||
|
```
|
||||||
|
|
||||||
|
Example:
|
||||||
|
```bash
|
||||||
|
python3 ipGeo.py /path/to/your/file.pcap --format json
|
||||||
|
```
|
||||||
|
|
||||||
## Screenshot from the script
|
## Screenshot from the script
|
||||||
![ipGeo](https://user-images.githubusercontent.com/89426041/189775552-78dfb962-23ba-46e7-b1f0-3e31ef54ebd3.png)
|
![ipGeo](https://user-images.githubusercontent.com/89426041/189775552-78dfb962-23ba-46e7-b1f0-3e31ef54ebd3.png)
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue