# Where to Find GhostTrack Documentation: A Complete Guide to the OSINT Tool

> Find complete GhostTrack documentation directly in the HunxByts/GhostTrack GitHub repository. Access quick-start guides and canonical references for this OSINT tool.

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

---

**GhostTrack documentation is maintained entirely within the HunxByts/GhostTrack GitHub repository, with the README.md providing quick‑start guidance and GhostTR.py serving as the canonical reference for all implementation details.**

GhostTrack is a lightweight Python CLI tool designed for OSINT investigations, offering IP address tracking, phone number lookup, and social media username enumeration through a simple text‑menu interface. Unlike complex frameworks that maintain separate documentation sites, this project follows a source‑code‑as‑documentation approach where every function, dependency, and usage pattern is self‑contained within the repository files. Understanding where to find GhostTrack documentation requires examining three specific files that collectively cover installation, architecture, and operational logic.

## Primary Documentation Files

The repository contains three essential files that constitute the complete documentation for GhostTrack.

### README.md

The **README.md** file located at the repository root provides the entry‑point documentation. It contains installation steps, prerequisite requirements, and visual screenshots demonstrating the menu interface. For users seeking immediate setup instructions, this file offers the fastest path to running the tool.

### GhostTR.py Source Code

According to the GhostTrack source code, the **GhostTR.py** file is the primary technical reference. This single Python script contains all functionality including the console UI loop (`option()`, `run_banner()`, `main()`), the option registry (`options` list), and all tracking implementations. Each public function is decorated with `@is_option` and includes inline comments explaining its operation.

### requirements.txt

Dependencies are documented in **requirements.txt**, which lists the external Python packages required for operation. The file specifies `requests` for HTTP operations and `phonenumbers` for phone number parsing, with no version pinning so that latest stable releases are used.

## Architecture Overview

Understanding the internal structure requires examining specific functions within [`GhostTR.py`](https://github.com/HunxByts/GhostTrack/blob/main/GhostTR.py).

### Console UI and Menu System

The user interface operates through a loop defined in `main()` that clears the terminal, displays a stylized banner via `run_banner()`, and presents a numbered menu. The `option()` function handles user input dispatch, while `is_in_options()` validates selections against the `options` registry—a list of dictionaries mapping numeric selectors to callable functions. The helper functions `call_option()` and `execute_option()` manage the execution flow and gracefully handle `ValueError` and `KeyboardInterrupt` exceptions.

### IP Tracking Implementation

The `IP_Track()` function prompts for an IP address and queries the **ipwho.is** public API. It parses the JSON response to display geo‑location data including country, city, ASN, ISP, and generates a Google Maps link. The `showIP()` function similarly queries **api.ipify.org** to reveal the machine's public IP address.

### Phone Number Analysis

Phone lookup functionality resides in `phoneGW()`, which utilizes the **phonenumbers** library to parse international formats. This function extracts location, carrier information, validation status, time zones, and provides both national and international formatting options.

### Username Enumeration

Social media tracking is implemented in `TrackLu()`, which constructs URLs for platforms including Facebook, Twitter, Instagram, and GitHub. The function performs synchronous HTTP requests using the **requests** library to verify profile existence via status codes, marking URLs as "found" on HTTP 200 responses.

## Installation and Usage Examples

Deploying GhostTrack requires only standard Python tooling and the documented dependencies.

### Setup Commands

```bash

# Clone the repository

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

# Install required Python packages

pip3 install -r requirements.txt

# Run the tool

python3 GhostTR.py

```

### IP Address Lookup

Selecting option 1 from the menu invokes the IP tracker:

```text
Enter IP target : 8.8.8.8

============= SHOW INFORMATION IP ADDRESS =============
IP target       : 8.8.8.8
Type IP         : IPv4
Country         : United States
...
Maps            : https://www.google.com/maps/@37,-122,8z

```

### Phone Number Investigation

Option 3 triggers the phone analysis module:

```text
Enter phone number target Ex [+6281xxxxxxxxx] : +14155552671

========== SHOW INFORMATION PHONE NUMBERS ===========
Location             : United States
Region Code          : US
Timezone             : America/Los_Angeles, ...
Operator             : AT&T
Valid number         : True
...
International format : +1 415-555-2671

```

### Username Tracking

Option 4 executes the social media enumeration:

```text
Enter Username : johndoe

========== SHOW INFORMATION USERNAME ===========
[ + ] Facebook   : https://www.facebook.com/johndoe
[ + ] Twitter    : https://www.twitter.com/johndoe
[ + ] Instagram  : https://www.instagram.com/johndoe
[ + ] GitHub     : https://www.github.com/johndoe

```

## Summary

- **GhostTrack documentation** is self‑contained within the HunxByts/GhostTrack repository, requiring no external wiki or website.
- The **README.md** provides installation instructions and visual references for new users.
- **GhostTR.py** serves as the definitive technical manual, containing all implementation logic for IP tracking (`IP_Track()`), phone lookup (`phoneGW()`), and username enumeration (`TrackLu()`).
- **requirements.txt** documents the minimal dependency footprint consisting of `requests` and `phonenumbers`.
- All network operations use free public APIs (**ipwho.is**, **api.ipify.org**) requiring no authentication keys.
- The `@is_option` decorator wraps each command to automatically display the banner before execution.

## Frequently Asked Questions

### Where is the official GhostTrack documentation hosted?

The official documentation exists only within the GitHub repository at `HunxByts/GhostTrack`. There is no separate documentation website; users should reference the README.md for setup instructions and GhostTR.py for technical implementation details.

### How do I install GhostTrack and its dependencies?

Clone the repository and install the Python packages listed in requirements.txt using pip3. The tool requires only the `requests` and `phonenumbers` libraries, which are standard packages available via PyPI.

### Can I use GhostTrack without API keys?

Yes. As implemented in the source code, GhostTrack utilizes free public endpoints including ipwho.is for IP geolocation and api.ipify.org for public IP detection. The username tracking function performs direct HTTP requests to social media platforms without requiring authentication.

### Which function handles phone number validation in GhostTrack?

The `phoneGW()` function within GhostTR.py handles all phone number operations. It uses the phonenumbers library to parse international formats, validate numbers, extract carrier information, and determine geographic location and time zones.