Skip to main content
This guide will walk you through installing IP-Tracker and all required dependencies.

​
System requirements

Operating system

Linux (Ubuntu/Kali recommended) or Termux on Android

Python version

Python 3.8 or higher
While IP-Tracker is designed for Linux environments, it should work on macOS and Windows with Python 3.8+ installed. The color output works best on Unix-like terminals.

​
Dependencies

IP-Tracker requires the following Python packages:
  • requests: HTTP library for API calls to ip-api.com and ipinfo.io
  • phonenumbers: Google’s libphonenumber library for phone number parsing and validation
The tool also uses these standard library modules (no installation required):
  • os, sys, re, datetime

​
Installation steps

1

Verify Python installation

Ensure Python 3.8 or higher is installed:
python3 --version
Expected output:
Python 3.8.0  # or higher
If Python 3.8+ is not installed, install it first:Ubuntu/Debian:
sudo apt update
sudo apt install python3 python3-pip
Termux (Android):
pkg update
pkg install python
2

Clone the repository

Clone the IP-Tracker repository from GitHub:
git clone https://github.com/Devsebastian44/IP-Tracker.git
cd IP-Tracker
This will download all necessary files including the main tracker.py script.
3

Install Python dependencies

Install the required packages using pip:
pip3 install requests phonenumbers
Or install them individually:
pip3 install requests
pip3 install phonenumbers
If you encounter permission errors, try using --user flag:
pip3 install --user requests phonenumbers
4

Verify installation

Check that all dependencies are installed correctly:
python3 -c "import requests, phonenumbers; print('All dependencies installed successfully')"
If successful, you should see:
All dependencies installed successfully
5

Run IP-Tracker

Launch the tool:
python3 tracker.py
You should see the IP-Tracker banner and main menu. The tool will automatically create a Resultados_Tracker directory for storing results.

​
Directory structure

After installation and first run, your directory structure will look like this: 
IP-Tracker/
├── tracker.py              # Main script
├── README.md               # Documentation
├── Img/                    # Screenshots and images
└── Resultados_Tracker/     # Created automatically
    ├── IP_8.8.8.8_20260304_143022.txt
    └── Telefono_593991234567_20260304_143156.txt
The Resultados_Tracker directory is created automatically on first run. All query results are saved here with timestamped filenames.

​
Troubleshooting

The requests library is not installed. Run:
pip3 install requests
If using a virtual environment, ensure it’s activated before installing packages.
The phonenumbers library is not installed. Run:
pip3 install phonenumbers
Make the script executable:
chmod +x tracker.py
Or run with python3 explicitly:
python3 tracker.py
IP-Tracker uses ANSI color codes. If colors don’t display:
  • Ensure you’re using a terminal that supports ANSI colors
  • On Windows, use Windows Terminal or WSL
  • The tool will still work without colors
If you see timeout errors:
  • Check your internet connection
  • The tool uses a 10-second timeout for API calls
  • Some networks may block HTTP requests to external APIs
  • Try using a different network or VPN

​
Environment-specific notes

​
Termux (Android)

For Termux users on Android: 
# Install dependencies
pkg update && pkg upgrade
pkg install python git
pip install requests phonenumbers

# Clone and run
git clone https://github.com/Devsebastian44/IP-Tracker.git
cd IP-Tracker
python tracker.py

​
Kali Linux

Kali Linux typically has Python pre-installed: 
sudo apt update
sudo apt install python3-pip
pip3 install requests phonenumbers

​
Next steps

Quick start guide

Learn how to perform your first IP lookup and phone number analysis

Build docs developers (and LLMs) love

Get started for freeTalk to us