explaingit

hunxbyts/ghosttrack

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

TLDR

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
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

Tech stack

Python

Getting it running

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.

In plain English

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.

Copy-paste 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?
Open on GitHub → Explain another repo

← hunxbyts on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.