TGSherlock

Telegram-OSINT in einem lokalen Web-Panel: Live-Überwachung, Warnmeldungen, Nutzerverfolgung und Stichwort-Suchen.

Installation

pipx install tgsherlock

Neueste Version von GitHub: pipx install git+https://github.com/emrekybs/tgsherlock.git (falls tgsherlock danach nicht gefunden wird, führe pipx ensurepath aus und öffne ein neues Terminal).

Ausführen

tgsherlock

Das Panel öffnet sich in deinem Browser unter http://127.0.0.1:8765. Unter Linux wird beim ersten Start außerdem TGSherlock zum Anwendungsmenü hinzugefügt, sodass du es mit einem Klick starten kannst.

Erster Start: Erstelle eine App unter my.telegram.org → API development tools, gib deine API ID und deinen API Hash ein und scanne dann den QR-Code mit Telegram (Einstellungen → Geräte → Desktop-Gerät verknüpfen). Eine Anmeldung per Telefonnummer ist ebenfalls möglich.

Funktionen

• Live-Monitor: Echtzeit-Nachrichten von ausgewählten Nutzern, Gruppen und Kanälen, mit optionalem Medien-Download.
• Warnmeldungen: Überwache einen Nutzer, eine Gruppe oder alle Chats auf beliebige Nachrichten, Stichwörter, Regex, Medien oder Indikatoren. Erhalte Benachrichtigungen in der App, auf dem Desktop, per E-Mail (SMTP) oder per Webhook, mit Drosselung von Zusammenfassungen.
• Nutzerprofil: Bio, Benutzernamen, Flags, gemeinsame Gruppen, erstes und letztes Auftreten pro Gruppe, stündliche Aktivität und eine datierte Nachrichten-Zeitleiste.
• Suche: Nutzer, Gruppen und Kanäle, angezeigt mit ihren Profilbildern.
• Gruppenverlauf · Stichwort-Suche · Nutzer-Tracker: Hintergrundaufgaben mit Fortschrittsanzeige und automatischer FloodWait-Behandlung.
• Entitäten: E-Mails, Telefonnummern, URLs, IPs, Krypto-Wallets, Einladungslinks und Hashtags, automatisch extrahiert.
• Archiv & Export: Filtere alles, was du gesammelt hast, und exportiere es als CSV, JSON oder HTML-Bericht.
• Mehrere Konten: Hinzufügen, Wechseln und Abmelden über die Seitenleiste.

Aktualisieren: pipx upgrade tgsherlock

Optionen: --port 8790, --no-browser, --install-desktop, --uninstall-desktop. Daten bleiben lokal: ~/.config/tgsherlock (Einstellungen, Sitzungen) und ~/.local/share/tgsherlock (Datenbanken, Medien).

Verantwortungsvolle Nutzung

Entwickelt für defensives OSINT und Threat Intelligence. TGSherlock sieht nur, was dein eigenes Telegram-Konto sehen kann. Befolge lokales Recht und die Nutzungsbedingungen von Telegram.

Lizenz

MIT