gitwtfhub

wtf is ghosttrack?

hunxbyts/ghosttrack — explained in plain English

Analysis updated 2026-06-24

13,158PythonAudience · ops devopsComplexity · 2/5Setup · easy

TL;DR

Command-line OSINT tool that looks up publicly available information tied to an IP address, phone number, or social media username from a single menu-driven interface.

Mindmap

mindmap
  root((repo))
    What it does
      IP address lookup
      Phone number search
      Username tracking
    Tech Stack
      Python
      CLI menu interface
    Platforms
      Debian Linux
      Android Termux
    Audience
      Security researchers
      Cybersecurity learners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Look up geolocation and network information for an IP address from the command line.

REASON 2

Search for publicly available information linked to a phone number across available sources.

REASON 3

Find social media accounts associated with a given username across multiple platforms at once.

What's in the stack?

Python

How it stacks up

hunxbyts/ghosttrackdbcli/pgcliteng-lin/notebooklm-py
Stars13,15813,15713,163
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audienceops devopsdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Clone the repo, run `pip install -r requirements.txt`, then `python3 main.py`, works on Linux and Android Termux.

Wtf does this do

GhostTrack is a Python-based information-gathering tool, also described in its README as an OSINT tool. OSINT stands for Open Source Intelligence, which refers to collecting information from publicly available sources. The tool is designed to look up details associated with an IP address, a phone number, or a social media username, all from a single command-line interface with a menu. The tool presents three main options when you run it. The IP Tracker option lets you look up geolocation and related information tied to an IP address. The README also notes that this menu can be combined with a separate third-party tool called Seeker to help obtain a target's IP address. The Phone Tracker option lets you search for information associated with a given phone number. The Username Tracker option searches for a given username across social media platforms. Installation is described for two environments. On Debian-based Linux systems, you install Git and Python 3 through the system's package manager. On Termux, which is a terminal emulator application for Android phones, you use Termux's package manager instead. In both cases, you clone the repository, install the Python dependencies listed in a requirements file, and run the main Python script. The README itself is brief. It covers installation commands and includes screenshots of the menus but does not document which data sources each tracker queries or what specific fields are returned. The current version noted in the file is 2.2. The repository tags include cybersecurity, hacking, and information-gathering, and the author appears to be based in Indonesia.

Yoink these prompts

Prompt 1
I've cloned GhostTrack and installed the requirements. Show me how to run the IP tracker and interpret the geolocation output.
Prompt 2
Walk me through installing GhostTrack on Termux on my Android phone and running a username search.
Prompt 3
What Python dependencies does GhostTrack need and how do I install them on a Debian Linux system?
Prompt 4
I want to call GhostTrack's phone tracker from a Python script instead of using the menu. How would I approach that?

Frequently asked questions

wtf is ghosttrack?

Command-line OSINT tool that looks up publicly available information tied to an IP address, phone number, or social media username from a single menu-driven interface.

What language is ghosttrack written in?

Mainly Python. The stack also includes Python.

How hard is ghosttrack to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ghosttrack for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.