Update README.md

main
tired 2024-10-21 14:09:42 -05:00 committed by GitHub
parent f18232d9b1
commit 9af4c00cc7
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 34 additions and 17 deletions

View File

@ -1,42 +1,59 @@
# 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:
1. Country:
2. Country Code.
1. Country
2. Country Code
3. Region
4. Region Name
5. City
6. Zip
7. Latitude
8. Longitude
9. Timezone
10. Isp
11. Org
12. Ip
6. District
7. Zip
8. Latitude
9. Longitude
10. Timezone
11. ISP
12. Organization
13. IP Address
## 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
pip3 install colorama
pip3 install requests
pip3 install pyshark
pip3 install colorama requests pyshark
```
If you are not using Kali or ParrotOs or any other penetration distribution you need to install Tshark.
```bash
sudo apt install tshark
```
## Usage
You can run the script either interactively or by using command-line arguments:
Interactive Mode
```bash
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
![ipGeo](https://user-images.githubusercontent.com/89426041/189775552-78dfb962-23ba-46e7-b1f0-3e31ef54ebd3.png)