Skip to content

c14it0n/TrackPix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🕵️‍♂️ TrackPix — Tracking People with Images (CLI Edition)

Banner de TrackPix

⚡ Versión: v1.0.0 (CLI)

TrackPix es una herramienta de ciberinteligencia que permite rastrear metadatos de conexión de usuarios a través de imágenes SVG instrumentadas.
Diseñada como una plataforma CLI (Command Line Interface), esta versión permite generar agentes de rastreo, recolectar evidencia remota y generar reportes HTML con geolocalización, IPs, navegador y más.


📖 Descripción general

TrackPix combina técnicas de tracking invisible mediante SVG y JavaScript para registrar eventos cuando un destinatario visualiza una imagen (por ejemplo, enviada en correo, documento o chat).
Cada agente genera un archivo .svg personalizado que, al abrirse, ejecuta código embebido para reportar al servidor de colección.

Toda la información se almacena en formato JSONL (JSON por línea) y puede visualizarse mediante reportes HTML automáticos.


⚙️ Funcionalidades principales

Módulo Descripción
🧩 Agentes SVG Generación automática de imágenes SVG con JS embebido que reportan IP, User-Agent, ubicación geográfica, etc.
🛰 Collector HTTP Servidor local en Go que recibe las conexiones y almacena evidencias.
🕐 Timestamp local y UTC Registra hora exacta de apertura con zona horaria detectada.
🌎 GeoIP Integración con IPinfo e IPAPI para geolocalización.
🧾 Reportes HTML Genera informes visuales por agente con datos enriquecidos.
🧠 Deduplicación inteligente Evita registros duplicados provenientes de XHR y Beacon.
🔐 Uso offline o vía ngrok Permite operación en entornos locales o cloud.

⚖️ Consideraciones legales

TrackPix está diseñado únicamente para fines forenses, educativos y de investigación judicial. Su uso debe estar amparado bajo el marco legal colombiano (Ley 1273 de 2009 y normativas complementarias). Cualquier uso no autorizado o con fines de vigilancia ilícita está prohibido.


🧪 Menú principal

  1. Generar un nuevo agente (SVG)
  2. Ver agentes generados
  3. Configurar URL pública del colector (ngrok/dom)
  4. Generar reporte HTML por Agente (desde JSONL)
  5. Salir

Cada opción permite ejecutar acciones forenses dentro del flujo de investigación:

  • (1) Genera un agente SVG que recolecta información del entorno del usuario al abrir la imagen.
  • (2) Muestra el historial de agentes creados y su timestamp de generación.
  • (3) Configura la URL pública del colector (por ejemplo, un túnel ngrok o dominio propio).
  • (4) Genera un reporte HTML consolidado de las capturas realizadas.
  • (5) Finaliza la sesión del colector.

🧰 Requisitos

  • Go 1.21 o superior
  • Cuenta gratuita en ngrok
  • Token IPinfo (opcional)

🚀 Instalación

# Clonar el repositorio
git clone https://github.com/c14it0n/TrackPix/
cd TrackPix

# Instalar dependencias
go mod tidy

# Compilar el ejecutable
go build -o trackpix.exe

About

🕵️‍♂️ TrackPix — Tracking People with Images (CLI Edition)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages