- Laut dem [Bluetooth SIG assigned numbers repo](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/www.bluetooth.com/specifications/assigned-numbers) dürfen wir diese Company IDs verwenden:
  - `0x01AB` für `Meta Platforms, Inc. (formerly Facebook)`
  - `0x058E` für `Meta Platforms Technologies, LLC`
  - `0x0D53` für `Luxottica Group S.p.A` (die Herstellerin der Meta Ray-Bans)
  - `0x03C2` für `Snapchat, Inc.` (die Herstellerin der SNAP Spectacles)
  - `0x05D6` für `Zhuhai Jieli Technology Co` (die Herstellerin von Rogbird VisionPro und Rollme VistaView)
  Sie sind **unveränderlich und verpflichtend**. Natürlich haben Meta und andere Hersteller auch andere Produkte mit Bluetooth und daher ihre ID, z. B. VR-Headsets. Daher ist die Verwendung dieser Company-ID-Codes für den Scanvorgang der App anfällig für False Positives. Aber wenn du niemanden mit einer Occulus Rift in deiner Umgebung siehst und es keine Gebäude gibt, in denen sie sich verstecken könnten, ist die Wahrscheinlichkeit hoch, dass es sich stattdessen um eine Smart Glasses handelt.
- Während des Pairings senden die Smart Glasses normalerweise ihren Produktnamen aus, sodass wir auch danach scannen können. Aber es ist selten, dass wir das im Feld sehen werden. Personen, die Smart Glasses in Bars, Pubs, auf der Straße und anderswo nutzen wollen, bereiten sich normalerweise im Voraus darauf vor.
- Wenn die App ein Bluetooth Low Energy (BLE)-Gerät mit ausreichender Signalstärke erkennt (siehe RSI unten), sendet sie eine Warnmeldung. Dies soll dir helfen, entsprechend zu handeln.
- Darüber hinaus scannen wir nach ausgestrahlten Gerätenamen, z. B. `rayban`, `ray-ban` oder `HeyCyan`. `HeyCyan` ist [ein bekanntes SDK für Smart Glasses verschiedener Marken](https://github.com/ebowwa/HeyCyanSmartGlassesSDK). Unter diesen *HeyCyan*-Geräten findest du möglicherweise auch die Nilox Smart AI Glasses, die von ALDI und Hofer (in Österreich) verkauft werden. Um dies abzusichern, suchen wir auch nach der `primary_UUID`, einem Service-Identifier, der auf der Softwareseite dieser Brillen festgelegt ist (`7905FFF0-B5CE-4E99-A40F-4B1E122D00D0`). Obwohl sich dies in Zukunft ändern könnte, ist es unwahrscheinlich, da es ältere Geräte unbrauchbar machen würde; daher könnten wir dann einfach weitere UUIDs zur Scanroutine hinzufügen.
## Features
- Die App *Nearby Glasses* zeigt eine Benachrichtigung an, wenn Smart Glasses in der Nähe sind (das bedeutet, ein BLE-Gerät mit einer der oben genannten Company IDs)
- **In der Nähe** bedeutet, dass der RSSI (Signalstärke) kleiner oder gleich einem bestimmten Wert ist: standardmäßig -75 dBm. Dieser Standardwert entspricht einer mittleren Entfernung und einem einigermaßen akzeptablen Signal.
  ### Was ist RSSI?
- Lass mich diesen RSSI-Wert etwas erklären:<br/>
RSSI steht für Received Signal Strength Indication. Der Wert ist ein Indikator für die Empfangsfeldstärke von drahtlosen Kommunikationsanwendungen. [Wikipedia hat einen recht guten Artikel](https://en.wikipedia.org/wiki/Received_signal_strength_indicator) darüber.
Kurz gesagt, RSSI hängt hauptsächlich ab von:<br/>
  - Sendeleistung des Geräts
  - Antennendesign
  - Wänden und Hindernissen
  - Menschlichen Körpern, die Signale absorbieren
  - Reflexion und Interferenz
  - Geräteausrichtung<br/>
Aber in typischen BLE (Bluetooth Low Energy)-Szenarien ist die grobe RSSI-Entfernung (offener Raum): <br/>
  - -60 dBm ~ 1 – 3 m<br/>
  - -70 dBm ~ 3 – 10 m<br/>
  - -80 dBm ~ 10 – 20 m<br/>
  - -90 dBm ~ 20 – 40 m<br/>
  - -100 dBm ~ 30 – 100+ m oder nahe Signalverlust<br/>
In Innenräumen sind die Entfernungen oft viel kürzer.<br/>
RSSI fällt ungefähr gemäß<br/>
    `RSSI ≈ -10 * n * log10(distance) + constant`<br/>
- Daher entspricht der Standard-RSSI-Schwellenwert von -75 dBm etwa 10 bis 15 Metern im offenen Raum und 3 bis 10 Metern in Innenräumen oder in überfüllten Bereichen. Du hast damit eine gute Chance, die Person mit der Smart Glasses zu entdecken.
- *Nearby Glasses* zeigt ein optionales Debug-Log, das exportierbar ist (als txt-Datei) und eine Copy-&-Paste-Funktion bietet. Diese sind für fortgeschrittene Benutzer (Nerds) und für weiteres Debugging gedacht.
- Unter *Settings* kannst du die Log-Länge und das Debugging festlegen (alle Scan-Elemente oder nur ADV-Frames anzeigen).
- Du kannst auch einige **Company IDs** als String aus Hex-Werten eingeben, z. B. `0x01AB,0x058E,0x0D53`. Dies überschreibt die integrierte Erkennung, sodass deine Benachrichtigung für die neuen Werte angezeigt wird.
- Für bessere Persistenz verwendet es Androids *Foreground Service*. Du kannst dies unter *Settings* deaktivieren, wenn du es nicht benötigst.
- Der *Notification Cooldown* unter *Settings* legt fest, wie viel Zeit zwischen zwei Warnungen vergehen muss. Standard ist 10000 ms, also 10 s. Dies gilt auch für den Kanarienvogel, z. B. bedeutet 10 s, dass er 10 s lang alarmiert bleibt, bevor er sich wieder beruhigt.
- Es ist jetzt etwas stärker lokalisiert: <img src="https://raw.githubusercontent.com/yjeanrenaud/yj_nearbyglasses/HEAD/img/canary_hide.svg" align="right" alt="Drawing of a canary that hides underneath a wing" height="100" width="100">
   - Englisch
   - Deutsch
   - Schweizerdeutsch
   - Französisch
   - Spanisch
   - Chinesisch
   - Italienisch
   - Portugiesisch (Brasilien)
   - Russisch
   - Türkisch
   - weitere folgen möglicherweise ([unterstütze dieses Projekt, indem du in deiner Sprache beiträgst!](https://github.com/yjeanrenaud/yj_nearbyglasses/issues/3))
- Der Hintergrund des App-Symbols ist jetzt nicht mehr transparent
- Jetzt scannen wir auch nach UUIDs
- *Nearby Glasses* unterstützt jetzt den Dunkelmodus (über Systemeinstellungen)
- Das Edge-to-Edge-Layout-Problem sollte ab [v1.0.4](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) behoben sein.
- Neu lizenziert unter AGPL 3.0
- Ich habe beschlossen, auf die CLA zu verzichten. Nach einigen Diskussionen mit Personen, die sich besser mit kollaborativen Projekten auskannten als ich, habe ich die Erkenntnis gewonnen, dass dies ein unnötiger Schritt war.
- Es hat jetzt ein etwas anderes Symbol, um AGPL 3.0 strenger zu entsprechen.
## iOS und Android
- Endlich, nach drei Wochen, ist der iOS-Port verfügbar. Er sollte auf den meisten iPhones und iPads funktionieren; sogar auf älteren (bis zurück zu iOS 16). [Quellcode und Projektdateien werden ebenfalls bereitgestellt](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS). Der Code ist hässlich und unorthodox. Viele Ansätze sind schnell und schmutzig (z. B. verwende ich die JSON-Dateien aus der Android-Lokalisierung wieder), aber bisher funktioniert es. *Nearby Glasses* ist im [Apple App Store](https://apps.apple.com/us/app/nearby-glasses-original/id6761056896) verfügbar. (Es heißt original, um es von diesen Nachahmern unterscheidbar zu machen). Eine .ipa ist zum Sideloading unter [releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) verfügbar.
  Die iOS-App funktioniert nicht im Hintergrund, weil ich keine Möglichkeit gefunden habe, etwas Ähnliches wie `ForegroundServices` zu verwenden, um aufgrund von iOS-Einschränkungen dauerhaft nach BTLE ADV zu scannen. Daher gibt es unter iOS in *Nearby Glasses* nur einen *Canary Mode*. Wenn du Swift und iOS besser kennst als ich (was wahrscheinlich ist), bitte trage bei!
- Da dieses Repository sowohl Android- als auch iOS-App-Code enthält, habe ich die Ordner neu organisiert. Daher gibt es [/iOS](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS) und [/Android](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android).

## Verwendung

- Siehe [Releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) für die APK zum Herunterladen oder nutze den Google Play Store. F-Droid und/oder Accrescent könnten folgen.
<img width="135" height="300" align ="right" alt="Screenshot Nearby Glasses: Settings" src="https://assets.kitploit.com/production/public/readmes/12083/71a0271ff9172cad52e8d83ed9a29ba43b509c7b250be2a0254a5a4371ee3401.png" />

<a href="https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses" target="_blank"><img width="239" height="71" alt="Get It On Google Play" src="https://assets.kitploit.com/production/public/readmes/12083/a7dbeba4623dd255798dd1159e543cdbeeb9e43faa6db7f859b0f9ed3699932c.png" /></a> <a href="https://apps.apple.com/us/app/nearby-glasses-original/id6761056896"><img width="213" height="71" alt="Download on the App Store" src="https://assets.kitploit.com/production/public/readmes/12083/a6fa504b048d52b4e9f5108021dce33af0d96b8b78c34095072971f4a34471fa.png" /></a>
1. Installiere die App (vorerst von [Releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) oder von [Google Play](https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses)) oder vom [Apple App Store](https://apps.apple.com/us/app/nearby-glasses-original/id6761056896), und öffne sie
2. Drücke die Schaltfläche *Start Scanning*
3. Erteile Berechtigungen zum Aktivieren von Bluetooth (falls nicht bereits aktiviert) und für den Zugriff auf Geräte in der Nähe. Einige Android-Versionen erfordern außerdem, dass du Berechtigungen für den Zugriff auf deinen Standort erteilst (meist vor Version 13). *Nearby Glasses* macht nichts mit deinen Standortinformationen. Wenn du mir nicht glaubst, schau bitte in den [Code](https://github.com/yjeanrenaud/yj_nearbyglasses/tree/main/app)
4. Wenn du nicht siehst, dass der Scan startet, musst du möglicherweise *Foreground Service* auf deinem speziellen Telefon im Menü *Settings* aktivieren (siehe unten)
5. Du bist startklar! Wenn Smart Glasses in der Nähe erkannt werden, erscheint eine Benachrichtigung. Dies geschieht so lange, bis du *Stop Scanning* drückst oder die App endgültig beendest
7. Im Menü (oben rechts, das Zahnrad) kannst du einige *Settings* vornehmen:
   1. *Enable Foreground Service*: Dadurch verhinderst du, dass Android die App pausiert und sie dich dadurch nicht mehr warnen kann. Ich empfehle, dies aktiviert zu lassen
   2. *RSSI threshold*: Diese negative Zahl legt fest, wie weit ein Gerät entfernt sein darf, um ein Grund für eine Warnung durch *Nearby Glasses* zu sein. Technisch gesehen bezieht sie sich darauf, wie stark das Signal empfangen wird. Näher an null bedeutet besseres Signal, also geringere Entfernung zwischen deinem Telefon und den Smart Glasses. Siehe [RSSI oben für Erklärungen und Orientierung](#how). Ich empfehle, es bei -75 zu belassen
   3. *Enable Notifications*: Das möchtest du wohl nicht deaktivieren 
   4. Canary Mode. Dies ist der neue Standard. Damit erhältst du keine Systembenachrichtigungen, die dich über Smart Glasses in der Nähe informieren, sondern du siehst einen Kanarienvogel, der anzeigt, dass keine Smart Glasses in der Nähe sind. Die iOS-App hat aufgrund technischer Einschränkungen nur einen Canary Mode. <img src="https://raw.githubusercontent.com/yjeanrenaud/yj_nearbyglasses/HEAD/img/canary.svg" alt="Drawing of a canary" width="100" height="100" alignt="left"> 
   5. *Notification/Canary Cooldown*: Hier legst du fest, wie viele Benachrichtigungen über gefundene Smart Glasses in der Nähe du erhalten möchtest oder wie lange sich der Kanarienvogel verstecken soll. Ich habe 10 Sekunden (10000 ms) als Standardwert gewählt. So verpasst du die Benachrichtigung nicht, während sie dich gleichzeitig nicht zu sehr stört oder deinen Akku zu schnell entlädt
   6. *Enable Log Display*: Das Deaktivieren könnte etwas Akku sparen. Dies ist im Canary Mode deaktiviert.
   7. *Debug*: Wird benötigt, um im Log-Anzeigebereich mehr als nur die passenden BLE-Frames zu sehen. Es ist nützlich, um zu sehen, ob die Dinge funktionieren. Dies ist im Canary Mode deaktiviert.
   8. *Max log lines*: Wie lang das Log werden darf. 200 scheint ein guter Kompromiss zwischen Akkulaufzeit und Nutzbarkeit des Logs zu sein (für Nerds wie mich). Dies ist im Canary Mode deaktiviert.
   9. *BLE ADV only*: Dies schließt andere Bluetooth-LE-Frames aus dem Log aus, um die Lesbarkeit zu verbessern. Dies ist im Canary Mode deaktiviert.
   10. *Override Company IDs*: Wenn du möchtest, kannst du *Nearby Glasses* so einstellen, dass es dich vor anderen Geräten als den oben angegebenen warnt. Nützlich zum Debuggen, zumindest für mich. Lass es leer, wenn du es nicht brauchst oder nicht weißt, was du damit anfangen sollst
   11. Jede Einstellung wird gespeichert und ist sofort wirksam. Um zurückzugehen, verwende deine Zurück-Taste oder -Geste
8. Die Exportfunktion ermöglicht es dir, eine Textdatei mit dem Log der App zu teilen. Für Nerds wie mich
9. Du kannst das Log auch kopieren und einfügen, indem du auf den Log-Anzeigebereich tippst

## ToDos
- **Es funktioniert jetzt in der Praxis!** Ich habe es geschafft, dass einige Leute es mit verifizierten Smart Glasses in ihrer Umgebung getestet haben. Besonderer Dank an Lena!
- Siehe [Releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) für die APK zum Herunterladen. 
- Ich habe [*Nearby Glasses* auch bei Google Play veröffentlicht](https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses). Ich werde jedoch immer [Releases hier auf GitHub](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) und [anderswo](https://yves.app/nearbyglasses/latest.apk) veröffentlichen, für diejenigen, die Google Play meiden.

---

- Eine Option hinzufügen, um False Positives auf eine Ignorierliste zu setzen. Vielleicht in der Benachrichtigung?
- Ich bin überhaupt kein BT- oder Android-Experte. Nach dem, was ich gelernt habe, könnte man auch tiefer in die Kommunikation der Smart Glasses eindringen, indem man den BLE-Verkehr sniffed. Dadurch müssten wir uns wahrscheinlich nicht darauf verlassen, dass sich das Gerät gemäß den BT-Spezifikationen verhält, sondern könnten auch Heuristiken auf die verschlüsselten Übertragungen anwenden, ohne viele False Positives. Aber ich habe mir seit über zehn Jahren keine BT-Verkehrspakete mehr angesehen. Ich bin froh, dass ich mich an ADV-Frames erinnert habe... Wenn also jemand dabei helfen könnte, wäre das sehr willkommen!
---
- **Weitere Hersteller-IDs** von Smart Glasses hinzufügen. Derzeit sind es Meta, Oakley und Snap. Eine Liste von Smart Glasses mit Kameras wäre ebenfalls hilfreich. Ich habe dafür ein [ISSUE eröffnet](https://github.com/yjeanrenaud/yj_nearbyglasses/issues/56), damit Leute **helfen** können, indem sie ihre Logs einsenden (die meiner Meinung nach völlig sicher sind), wenn sie andere aufzeichnende Smart Glasses antreffen
- Seit dem 24. März 2026 ist auch die iOS-Version verfügbar.
- Das **Layout-Problem** mit **Google Pixel-Geräten** scheint ab Version 1.0.3 behoben zu sein. Wenn du immer noch nicht auf das Menü zugreifen kannst, weil es irgendwie mit der Statusleiste vermischt ist. Ich werde das so schnell wie möglich untersuchen. Versuche in der Zwischenzeit, deinen Bildschirm in den Querformatmodus zu bringen und *im Uhrzeigersinn (nach rechts)* zu drehen. 

## Tech-Solutionism?
Ich weiß, dies mag ein seltsamer Ort dafür sein, aber hör mir bitte kurz zu. Mir ist bewusst, dass dies eine technische Lösung für ein soziales Problem ist, das selbst durch Technik verstärkt wird.
Ich möchte weder Techsolutionism fördern noch möchte ich, dass sich Menschen fälschlicherweise sicher fühlen. Es ist immer noch ein unvollkommener Ansatz und wird es wahrscheinlich immer bleiben. Es ist nicht alles gut, nur weil diese App jetzt existiert. Wir brauchen bessere Lösungen, um Überwachungstechnologie und Eingriffe in die Privatsphäre einzudämmen.

## Aus dem Quellcode bauen
Da *Nearby Glasses* Open Source ist, kannst du die App auch selbst aus dem Quellcode bauen. Dies stellt sicher, dass keine anderen Bibliotheken in der APK enthalten sind und du das bekommst, was du willst.

Bitte beachte, dass diese App auf Folgendem aufbaut:
- Gradle Wrapper: 9.3.1
- Android Gradle Plugin: 8.13.2
- Kotlin: 1.9.22
- compileSdk: 36
- targetSdk: 36
- minSdk: 26
- Keine Produkt-Flavors
- Repositories: nur google() und mavenCentral()
- Keine Google Services- oder Firebase-Plugins

### Voraussetzungen

- **JDK 17** (erforderlich — das Projekt zielt auf Java 17 ab)
- **Android SDK Platform 35** installiert  
  - compileSdk = 35  
  - targetSdk = 35  
- Git
### APK Schritt für Schritt bauen```bash
#Verify Java version:

 $java -version
#It must report Java 17.

#Get the source code
 $git clone https://github.com/yjeanrenaud/yj_nearbyglasses
 $cd yj_nearbyglasses

#Build Debug
 $./gradlew clean assembleDebug

#Build Release (with your own signature cert)
 $./gradlew clean assembleRelease

#Build unsigned Release for IzzyOnDroid / F-Droid
 $./gradlew clean izziFdroid 

#Run and Test
 $./gradlew test lint