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

> Install GhostTrack on Linux and Termux with this complete setup guide. Clone the repo, install dependencies, and launch the OSINT tool easily.

- Repository: [K1LLU/GhostTrack](https://github.com/HunxByts/GhostTrack)
- Tags: getting-started
- Published: 2026-04-29

---

**Clone the GhostTrack repository, install the Python dependencies listed in [`requirements.txt`](https://github.com/HunxByts/GhostTrack/blob/main/requirements.txt), and execute [`GhostTR.py`](https://github.com/HunxByts/GhostTrack/blob/main/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:

```bash

# 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:

```bash

# 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`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/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:

```bash
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`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/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`](https://github.com/HunxByts/GhostTrack/blob/main/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.