Is GhostTrack Open Source? Analyzing the HunxByts/GhostTrack Repository

Yes, GhostTrack is an open-source Python utility hosted on GitHub at HunxByts/GhostTrack, where all source files are publicly visible, cloneable, and executable, though the repository currently lacks an explicit software license.

GhostTrack is an OSINT (Open Source Intelligence) tool designed for tracking IP addresses, phone numbers, and usernames across social platforms. The project demonstrates open-source principles through its transparent codebase hosted in a public repository, allowing security researchers and developers to inspect, audit, and run the software locally.

What Defines GhostTrack as Open Source

A project qualifies as open source when its source code is made freely available for inspection, modification, and distribution. GhostTrack meets this definition by hosting its entire implementation in the public HunxByts/GhostTrack repository on GitHub. Users can clone the repository, examine the Python implementation in GhostTR.py, and execute the tool without restrictions on access.

However, the repository does not currently include a LICENSE file. Under standard copyright conventions, this omission implies an "all-rights-reserved" stance by the author, meaning that while the code is openly shared for educational purposes, legal redistribution or modification rights are not explicitly granted.

Repository Structure and Key Files

The GhostTrack codebase is organized as a minimal, single-script application with clear separation of concerns across three primary files:

• GhostTR.py – The main application file containing all tracking logic, menu systems, and API integrations (approximately 9,000+ lines).
• requirements.txt – Lists external Python dependencies including requests and phonenumbers.
• README.md – Provides installation instructions, usage examples, and screenshots.

This monolithic architecture simplifies auditing, as all functionality resides in one executable Python script rather than being distributed across multiple modules.

Architecture and Implementation Details

Entry Point and Control Flow

The application launches through a standard Python entry point at lines 9010‑9012 in GhostTR.py, where the if __name__ == '__main__': guard calls the main() function. The menu system implements a procedural dispatch pattern using a list named options (defined between lines 780‑7107) that maps numeric selections to callable functions including IP_Track, showIP, phoneGW, and TrackLu.

IP Address Tracking

The IP_Track function sends a GET request to http://ipwho.is/{ip} at line 445, parsing the JSON response (lines 446‑477) to extract geolocation data, ASN information, timezone details, and Google Maps coordinates. This implementation relies entirely on the external free API provided by ipwho.is.

Phone Number Intelligence

Phone number analysis is handled by the phoneGW function, which utilizes the phonenumbers library to parse international formats. At line 886, the code calls phonenumbers.parse(), then extracts region codes, carriers, validation status, and number types (mobile/fixed-line) through line 918. This feature requires the phonenumbers dependency specified in requirements.txt.

Username Enumeration Across Platforms

The TrackLu function performs username reconnaissance by iterating through a hard-coded list of platform URL templates defined between lines 227‑251. For each platform (including Facebook, Twitter, and Instagram), the script formats the URL with the target username and executes a GET request. Status code 200 responses indicate existing accounts, while other codes trigger "not found" notifications (handled at lines 255‑258).

How to Run GhostTrack Locally

You can deploy GhostTrack on any system with Python 3 installed by executing the following commands:

git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack
pip3 install -r requirements.txt
python3 GhostTR.py

Upon execution, the terminal displays a colored ASCII banner and presents an interactive menu:

[ 1 ] IP Tracker
[ 2 ] Show Your IP
[ 3 ] Phone Number Tracker
[ 4 ] Username Tracker
[ 0 ] Exit

Selecting option 1 initiates the IP_Track workflow, prompting for a target IP and displaying structured geolocation data. Option 3 triggers phoneGW, which requires phone numbers in E.164 format (e.g., +14155552671).

Licensing and Usage Rights

While GhostTrack is publicly shared as open-source code, the absence of a license file introduces legal ambiguity. According to GitHub's default terms and standard copyright law, publicly visible code without a license file retains all rights reserved by the author (HunxByts). This means that while you can view, clone, and run the code for personal use, you should not assume rights to redistribute modified versions or incorporate the code into commercial projects without explicit permission from the repository owner.

Summary

• GhostTrack is open-source software hosted publicly at HunxByts/GhostTrack, with all source code available for inspection and local execution.
• The project consists primarily of GhostTR.py, a monolithic Python script implementing IP tracking, phone number analysis, and username enumeration via procedural programming.
• Key dependencies include the requests library for HTTP operations and phonenumbers for telephony data parsing, both listed in requirements.txt.
• The repository lacks an explicit license, implying default copyright restrictions despite the code being publicly visible.
• All functionality is accessible through a CLI menu system with clearly defined entry points and dispatch logic, making the tool straightforward to audit and run locally.

Frequently Asked Questions

Is GhostTrack free to use?

Yes, GhostTrack is free to download, install, and run locally from the public GitHub repository. There are no paid features or subscription requirements. However, because the repository lacks a license file, "free" refers to cost rather than legal freedom to redistribute the code commercially.

What are the system requirements for GhostTrack?

GhostTrack requires Python 3 and two external packages listed in requirements.txt: requests for HTTP functionality and phonenumbers for telephone number parsing. The tool runs entirely in the terminal and does not require a graphical environment, making it compatible with Linux, macOS, and Windows systems.

Can I contribute to or modify the GhostTrack code?

Technically yes—you can fork the repository and modify the code for personal use. However, because HunxByts has not included an open-source license (such as MIT, GPL, or Apache), you do not have explicit legal permission to distribute your modifications or submit pull requests that the author is obligated to accept. Contact the repository owner directly for contribution guidelines.

Is it safe to run GhostTrack on my machine?

As with any open-source security tool, you should audit the code before execution. The GhostTR.py script makes outbound HTTP requests to external APIs (ipwho.is, api.ipify.org) and iterates through social media platforms. Review the source code—particularly the request handlers at lines 445 and 255‑258—to verify that no malicious operations are performed before running the tool with elevated privileges.

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