How to Install GhostTrack: Complete Setup Guide for Linux and Termux

Clone the GhostTrack repository, install the Python dependencies listed in requirements.txt, and execute GhostTR.py to launch the interactive OSINT menu.

GhostTrack is a lightweight, Python-based open-source intelligence (OSINT) tool designed to look up information about IP addresses, phone numbers, and social media usernames. Learning how to install GhostTrack takes only a few minutes and requires no complex configuration—just a working Python environment and four simple commands.

Prerequisites

Before installing GhostTrack, ensure your system has:

• Git – to clone the repository
• Python 3 – the runtime for executing the script
• pip – to install the required Python libraries

These tools are available on standard Linux distributions and Android via Termux.

Step-by-Step Installation

On Debian/Ubuntu/Linux Systems

Install the system dependencies using apt, clone the repository, install Python libraries, and run the tool:

# Install system prerequisites

sudo apt-get update
sudo apt-get install -y git python3 python3-pip

# Clone the repository

git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack

# Install Python dependencies (requests and phonenumbers)

pip3 install -r requirements.txt

# Launch the application

python3 GhostTR.py

On Android with Termux

For Termux users, the installation process uses pkg instead of apt, but follows the same pattern:

# Install Termux packages

pkg install -y git python

# Clone the repository

git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack

# Install requirements

pip install -r requirements.txt

# Run the tool

python GhostTR.py

What Gets Installed

Running pip install -r requirements.txt installs two critical dependencies defined in the project's requirements.txt:

• requests – handles HTTP calls to external services like ipwho.is and api.ipify.org
• phonenumbers – parses and validates international phone number formats

The core application resides entirely in GhostTR.py, a single script that contains the entry point (if __name__ == '__main__':), the menu system (defined in the options list at lines 179-207), and four primary tracking functions: IP_Track(), phoneGW(), TrackLu(), and showIP().

Launching and Using GhostTrack

Once installed, start GhostTrack by running:

python3 GhostTR.py

The script clears the terminal, displays a banner, and presents a numeric menu:

• [1] IP Tracker – Queries http://ipwho.is/ for geolocation data
• [2] Show Your IP – Displays your public IP via api.ipify.org
• [3] Phone Number Tracker – Validates and analyzes numbers using the phonenumbers library
• [4] Username Tracker – Checks social media platform availability
• [0] Exit

Select an option by typing its number and pressing Enter. The is_option decorator (lines 29-36) automatically handles banner display before executing your chosen handler.

Summary

• GhostTrack requires only Git, Python 3, and the dependencies in requirements.txt (requests and phonenumbers).
• Installation involves four steps: install system tools, clone https://github.com/HunxByts/GhostTrack.git, run pip3 install -r requirements.txt, and execute python3 GhostTR.py.
• The tool is a single-file script (GhostTR.py) with no database or configuration files to manage.
• Compatible with Linux distributions and Android Termux environments.

Frequently Asked Questions

Do I need root privileges to install GhostTrack?

No, GhostTrack does not require root or administrator privileges. You can clone the repository into any user directory and install Python packages in a user environment (or use a virtual environment). The tool makes standard HTTP requests and does not modify system files.

Can I run GhostTrack on Windows?

While the source code in GhostTR.py can run on Windows (Python is cross-platform), the installation commands in the repository specifically target Linux and Termux environments. Windows users would need to manually install Python and Git, then adapt the paths and terminal commands accordingly.

What Python version is required for GhostTrack?

GhostTrack requires Python 3 to function correctly. The phonenumbers library and modern requests versions dropped support for Python 2, and the script's syntax (such as f-strings and modern exception handling) assumes a Python 3 interpreter.

Is GhostTrack safe to install?

GhostTrack is a transparent open-source tool. You can inspect GhostTR.py before running it to verify that it only makes external requests to public APIs (ipwho.is, api.ipify.org) and social media sites. It does not contain malicious code or data collection mechanisms, provided you download it from the official HunxByts/GhostTrack repository.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}