|
1 | | -# 🚀 IP Scanner Tool |
2 | | -***version 1.0.1*** |
3 | | - |
| 1 | +# 🚀 IP Scanner Pro |
4 | 2 |
|
5 | | -Welcome to the IP Scanner Tool! This handy Bash script lets you uncover detailed information about any IPv4 or IPv6 address with ease. Whether you're a network administrator, a security enthusiast, or just curious about IPs, this tool has got you covered! |
| 3 | + |
| 4 | +[](https://opensource.org/licenses/MIT) |
| 5 | + |
| 6 | + |
| 7 | + |
6 | 8 |
|
7 | | -# 🛠 Features |
| 9 | +Welcome to IP Scanner Pro! This handy Bash script lets you uncover detailed information about any IPv4 or IPv6 address with ease. It's built for security, portability, and power. |
8 | 10 |
|
9 | | -**🔍 IP Address Details:** Get comprehensive information about IP addresses, including location, organization, timezone, and more. |
10 | 11 |
|
11 | | -**⚙️ Easy Updates & Removal:** Easily update or remove the tool with built-in options. |
| 12 | +--- |
12 | 13 |
|
13 | | -**💾 Save Results:** Automatically save your scan results to neatly organized files in your home directory. |
| 14 | +## Features |
14 | 15 |
|
| 16 | +* **Multi-OS Support:** A smart installer that works on Termux, Debian (Kali, Ubuntu), Arch, Fedora, and macOS. |
| 17 | +* **IP Details:** Get comprehensive info: location, organization, timezone, and more. |
15 | 18 |
|
16 | 19 |
|
| 20 | +## 💻 Supported Operating Systems |
| 21 | +The installer will automatically detect and work on: |
17 | 22 |
|
| 23 | +- `Termux (Android)` |
18 | 24 |
|
| 25 | +- `Debian-based Linux (Ubuntu, Kali Linux, Parrot OS)` |
19 | 26 |
|
20 | | -# 📥 Installation |
21 | | -Prepare Your System: |
| 27 | +- `Arch-based Linux (Manjaro, Garuda)` |
22 | 28 |
|
23 | | -Ensure you have `figlet` and `Python3` with the `requests` module installed. You can install them with the following commands: |
| 29 | +- `Fedora-based Linux` |
24 | 30 |
|
| 31 | +- `macOS (using Homebrew)` |
| 32 | + |
| 33 | + |
| 34 | +## Installation |
| 35 | + |
| 36 | +The smart installer handles all dependencies (like `python`, `jq`, `figlet`, `nmap`) for you. |
| 37 | + |
| 38 | + |
| 39 | +## 1. Clone the repository |
25 | 40 | ```bash |
26 | | -pkg install -y git python python2 jq python3 && pkg install figlet -y && pip3 install requests lolcat |
| 41 | +git clone https://github.com/trmxvibs/IPScanPro |
27 | 42 | ``` |
| 43 | +## 2. Navigate into the directory |
28 | 44 | ```bash |
29 | | -git clone https://github.com/trmxvibs/IPScanPro && cd IPScanPro |
| 45 | +cd IPScanPro |
30 | 46 | ``` |
31 | | -**Make the Script Executable:** |
| 47 | + |
| 48 | +## 3. Make the installer executable |
32 | 49 | ```bash |
33 | 50 | chmod +x install.sh |
34 | 51 | ``` |
35 | | -**Run the Script:** |
| 52 | + |
| 53 | +## 4. Run the installer (use sudo if on Linux/macOS) |
36 | 54 | ```bash |
37 | 55 | ./install.sh |
38 | 56 | ``` |
39 | | -# *OR* |
40 | | -``` |
41 | | -bash install.sh |
| 57 | +## or for Linux/macOS: |
| 58 | +```bash |
| 59 | +sudo ./install.sh |
42 | 60 | ``` |
43 | | - |
44 | | - |
| 61 | +- After installation, restart your terminal and run the tool from anywhere using the ip command. |
45 | 62 |
|
| 63 | +# Important: API Key Setup |
| 64 | +- ***This tool uses the ipinfo.io API, which requires a free access token.*** |
46 | 65 |
|
| 66 | +- Go to [ipinfo](https://ipinfo.io/signup) to get your free API token. |
47 | 67 |
|
48 | | - # 🛠 Usage |
| 68 | +- Run the install.sh script. It will automatically ask you to paste your token. |
49 | 69 |
|
50 | | -**🔍 Scan IPv4/IPv6:** Enter an IP address to fetch its details. |
| 70 | +- Your token is saved securely in $HOME/.config/ipscanner/config. |
51 | 71 |
|
52 | | -**⬆️ Update Tool:** Simulate an update process with a visual progress bar. |
53 | | - |
54 | | -**🗑 Remove Tool:** Completely remove the tool from your system. |
55 | | - |
56 | | -**❌ Exit:** Close the script. |
57 | | - |
58 | | -# 🎨 Screenshot |
59 | | -Here’s a sneak peek of the IP Scanner Tool in action: |
60 | | - |
61 | | - |
62 | | - |
63 | | - |
64 | | - |
65 | | -📚 Example Output |
66 | | -When you scan an IP, you'll see detailed information like this: |
67 | | - |
68 | | -```bash |
| 72 | +- The tool will not work without this token. |
| 73 | +## Example Output |
| 74 | +```python |
69 | 75 | --- IP Address Details --- |
70 | 76 | IP Address: 8.8.8.8 |
71 | 77 | Hostname: dns.google |
72 | 78 | City: Mountain View |
73 | 79 | Region: California |
74 | 80 | Country: US |
75 | | -Location: 37.4056,-122.0775 |
76 | | -Organization: Google LLC |
| 81 | +Location: 37.4056,-22.0775 |
| 82 | +Organization: AS15169 Google LLC |
77 | 83 | Postal Code: 94043 |
78 | 84 | Timezone: America/Los_Angeles |
79 | | -Anycast: No |
80 | | -Carrier: N/A |
81 | | -Internet ID: AS15169 |
82 | 85 | ---------------------------- |
| 86 | +Details saved to: /home/user/IP_Scanner_Results/8.8.8.8_Report.txt |
83 | 87 | ``` |
84 | 88 |
|
85 | | -# 🚀 How to Contribute |
86 | | -Feel free to fork the repository and submit pull requests! If you find any bugs or have feature requests, open an issue to let us know. |
87 | | - |
88 | | -# 📜 License |
89 | | -This script is provided as-is. No warranties or guarantees are provided. Use at your own risk. |
90 | 89 |
|
91 | | -# 👨💻 Author |
92 | | -**Lokesh Kumar** |
93 | | -[GitHub Profile](https://github.com/trmxvibs) |
94 | 90 |
|
95 | 91 |
|
96 | | -# My other videos on Youtube |
97 | | -[](https://youtu.be/jfPqGalt5CQ?si=IBOvM3iOB8-03ccd) |
| 92 | + |
0 commit comments