
Passiver Gerätetracker (Android)TrackEm Mobile ist ein Echtzeit-Passiv-Scanner für Wi-Fi- und Bluetooth-LE-Probe-Requests, entwickelt für OSINT, Red-Team-Operationen und drahtlose Forschung. Es horcht auf Client-Geräte (Handys, Laptops, IoT), die aktiv die Namen von Wi-Fi-Netzwerken senden.
Ein passiver Wi-Fi- + Bluetooth-LE-Beobachter für Android. TrackEm lauscht auf das, was Geräte in der Nähe ohnehin bereits ausstrahlen — Wi-Fi-Probe-Requests, BLE-Advertisements und sichtbare Access Points — und verwandelt dies in ein Live-, filterbares Inventar der Funkgeräte in deiner Umgebung. Entwickelt für Funkforschung, RF-Geländevermessungen, Red-Team-Aufklärung und OSINT-Arbeit, bei der du beobachten statt eingreifen möchtest.
TrackEm sendet niemals Wi-Fi- oder Bluetooth-Frames. Es ist ein Beobachter: keine Probe- Requests, keine Association-Frames, keine Deauthentication, keine Frame-Injection. Siehe Was TrackEm NICHT tut.
Paket: com.veteranop.trackem · Lizenz: MIT · Android 7.0+ (API 24)
TrackEm bietet drei Scan-Modi, jeweils vom Startbildschirm aus:
| Modus | Was er beobachtet | Typische Verwendung |
|---|---|---|
| Mobile Geräte | Wi-Fi-Probe-Requests plus BLE-Advertisements von Smartphones, Laptops, Uhren, IoT | Anwesenheitserkennung, Gerätezählung, Probe-Request-Forschung |
| Bluetooth LE | Nur BLE-Advertiser (kein Wi-Fi-Funk nötig) | Beacon- / Tracker- / BLE-Gerätevermessungen |
| Wi-Fi-Access-Points | Sichtbare APs (SSID, BSSID, RSSI) sowie zugehörige Clients, sofern die Plattform sie meldet | Geländevermessungen, Suche nach Rogue-APs |
api.maclookup.app)
und die optionale WiGLE-Abfrage — beide senden eine MAC/BSSID und sonst nichts.Analytics, ehrlich gesagt: Wenn du deine eigene
app/google-services.jsonbereitstellst, zeichnet Firebase Analytics drei App-Ereignisse auf —app_opened,start_scan(mit dem Scan-Modus) unddevice_renamed(nur mit einem Boolean, niemals der MAC). Es wird keine Kennung eines beobachteten Geräts gesendet. Ohne diese Datei lässt sich die App bauen und läuft mit deaktivierter Analytics: Die Aufrufe sind nullable, sodass eine fehlende Firebase-Konfiguration niemals den Start zum Absturz bringen kann.
Dies ist sowohl für die Lizenzierung als auch für die Erwartungen wichtig, daher wird es klar gesagt:
WifiManager.startScan()), was einem stillen
Gerät eine weitere Chance gibt, im nächsten Scan-Fenster zu erscheinen. Diese Schaltfläche ist mit
FORCE WI-FI RESCAN (10x) beschriftet, und mehr tut sie nicht — zehn erneute Scans.api.maclookup.app aus.
Über die beobachteten Geräte wird nichts irgendwohin gesendet.Wenn Sie aktive Funkmessungen durchführen möchten, verwenden Sie dafür dedizierte Hardware und Werkzeuge (und holen Sie sich vorher eine schriftliche Genehmigung für das Netzwerk ein).
| Berechtigung | Warum |
|---|---|
ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION | Android verlangt die Standortberechtigung, bevor es einer App Wi-Fi-Scanergebnisse oder BLE-Scanergebnisse überlässt. Dies ist eine Betriebssystemanforderung, keine TrackEm-Einstellung. |
ACCESS_BACKGROUND_LOCATION | Optional — nur, wenn Scans weiterlaufen sollen, während die App im Hintergrund ist. |
BLUETOOTH_SCAN (neverForLocation) / BLUETOOTH_CONNECT | BLE-Scannen und Verbinden mit einem Peripheriegerät. |
ACCESS_WIFI_STATE / CHANGE_WIFI_STATE | Scanergebnisse lesen; einen erneuten Wi-Fi-Scan auslösen. |
INTERNET / ACCESS_NETWORK_STATE | Herstellerabfrage (maclookup.app) und die optionale WiGLE-Abfrage. |
Der Standort wird verwendet, um Scanergebnisse aufzulösen, und (bei Verwendung des Jagd-/Kartenmodus), um Samples auf einer Karte zu platzieren. TrackEm speichert nirgendwo außerhalb des Geräts einen Standortverlauf.
Voraussetzungen: Android Studio (oder nur das SDK + JDK 17), Android SDK Platform 34.
git clone https://github.com/veteranop/trackem.git
cd trackem
Der API-Schlüssel von maclookup.app ist nicht in diesem Repository enthalten (er war in einem früheren Commit fest kodiert
und wurde seitdem rotiert und aus der Historie entfernt). Stellen Sie Ihren eigenen bereit — entweder in
local.properties (von Git ignoriert):
sdk.dir=/path/to/Android/Sdk
MACLOOKUP_API_KEY=your-key-from-maclookup.app
…oder in der Umgebung für CI:
export MACLOOKUP_API_KEY=...
Der Wert wird als BuildConfig.MACLOOKUP_API_KEY injiziert. Ohne gesetzten Schlüssel wird die App
weiterhin gebaut und ausgeführt — die Anbieter-Suche wird einfach übersprungen.
app/google-services.json ist in .gitignore eingetragen, da sie einen Firebase-API-Schlüssel enthält. Wenn du
Firebase Analytics möchtest, erstelle deinen eigenen Android-App-Eintrag in der Firebase-Konsole für
das Paket com.veteranop.trackem und lege die generierte google-services.json in app/ ab.
Ohne die Datei wird das Google Services Gradle Plugin nicht angewendet und die App wird
ohne Firebase gebaut.
./gradlew :app:assembleDebug # debug APK
./gradlew :app:test # JVM unit tests
Installiere den Debug-Build mit adb install -r app/build/outputs/apk/debug/app-debug.apk.
Installierst du einen älteren Build? Die Anwendungs-ID lautet jetzt
com.veteranop.trackem(zuvorcom.example.trackemmobile), sodass sie neben einer alten Kopie installiert wird, anstatt sie zu ersetzen. Deinstalliere die alte, um Verwirrung zu vermeiden.
Zwei Zugangsdaten haben in der Geschichte dieses Repos Probleme verursacht; beide werden jetzt auf dieselbe Weise behandelt: