🕵️Sleuth – Metadatenanalyse🔍 & Forensik Toolkit🧰

• ✅ Sleuth ist ein vollständig Web-Toolkit zur Analyse von Metadaten aus Bildern, Webseiten und Dokumenten.
• ✅ Online/Offline
• ✅ Inklusive EXIF-Analyse, URL-Scan, Exportfunktionen und visueller Darstellung.

---

📦 Projektstruktur

Sleuth/
├── index.html                   # Haupt-UI
├── style.css                   # Neon-Design & Theme (Dark/Light)
├── script.js                   # Hauptlogik (Routing & Analyse)
├── README.md                   # Diese Anleitung
├── sleuth_test_exif.jpg        # Beispielbild mit EXIF
├── start_all.bat               # Startet Proxy + Webserver + öffnet Browser
├── generate_exif.bat           # Erzeugt Testbild mit EXIF-Daten
├── exif_gen.py                 # Python-Skript für Bild mit EXIF
├── py312/                      # (optional) portable Python 3.12 Umgebung
└── modules/
    ├── imageMeta.js            # EXIF-Analyse
    ├── urlMeta.js              # Webseitenanalyse
    ├── exportModule.js         # JSON-Export
    ├── exportCSV.js            # CSV-Export
    ├── reportGenerator.js      # PDF-Export mit jsPDF
    ├── darklightToggle.js      # Theme-Umschaltung

---

🚀 Installation & Setup (Windows – Offlinefähig)

✅ Python portable (3.12) installieren

• Lade herunter:
  • 👉DOWNLOAD - Python 3.12.3

• Entpacke das Archiv nach:

Sleuth/py312/

• Öffne py312/python312._pth und trage folgendes ein:

python312.zip
.
import site

Damit pip und Pakete funktionieren

---

✅ pip, Pillow und piexif installieren

• Im Terminal:

cd Sleuth
py312\python.exe get-pip.py
py312\python.exe -m pip install pillow piexif

Falls get-pip.py fehlt, lade hier herunter:

• 👉DOWNLOAD - get-pip

---

🖼️ Beispielbild mit EXIF erzeugen

• Verwende:

ImageCreator.exe → Doppelklick

oder direkt:

py312\python.exe exif_gen.py

Das Bild sleuth_test_exif.jpg wird erstellt und kann anschließend über Sleuth analysiert werden.

---

🧪 Projekt starten

• ✅ Variante 1: Alles automatisch

Doppelklick auf ServerStarter.exe

• startet Proxy (Port 8000)
  • startet Python Webserver (Port 8000)
    • öffnet Browser mit Sleuth

✅ Variante 2: manuell

node proxy.js
py312\python.exe -m http.server 8000

Dann im Browser: 👉LOCALHOST

---

🌐 Proxy notwendig für URL-Analyse

• Sleuth verwendet fetch() über Proxy:

http://localhost:3000/proxy?url=https://example.com

Daher:

• node proxy.js muss laufen
  • Port *8000 darf nicht blockiert sein

---

🧠 Kompatibilitäten & Hinweise

Komponente	Version / Voraussetzung	Inkompatibel
Python	✅ Nur 3.12.x empfohlen (nicht 3.13+/3.14)
Pillow	✅ ab 9.x – 11.x kompatibel
piexif	✅ funktioniert mit Python 3.12,	❌ nicht mit 3.14
jsPDF	📦 eingebunden via CDN
exifr	🚀 verwendet für moderne EXIF-Analyse

---

🧪 Unterstützte Dateitypen

Typ	Funktion
JPG	✅ EXIF-Analyse
PNG	⚠️ Teilweise unterstützt – keine klassischen EXIF-Daten
PDF	📝 Basis-Metadaten (z. B. Titel, Ersteller, Erstellungsdatum)
URL	🌐 Analyse von <title>, Meta-Description, OpenGraph via Proxy

---

📁 Hinweise zu Verzeichnissen

Ordner	Inhalt
/modules/	🔧 Alle JavaScript-Funktionen modular
/py312/	🐍 Portable Python 3.12 inkl. Pip & Pillow
Root (/)	📄 index.html, style.css, script.js

---

🧩 Optional: Erweiterungen

• 📍 GeoMap (Leaflet)
• 📈 Timeline (Chart.js)
• ⚡ Drag&Drop-Unterstützung
• 🧪 Vergleichsansicht
• 🔌 Plugin-System

Diese erscheinen in der nächsten Version

---

👨‍💻 Entwickler

• Erstellt & strukturiert von Thorsten Bylicki

---