- Secondo il [repository dei numeri assegnati del Bluetooth SIG](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/www.bluetooth.com/specifications/assigned-numbers), possiamo utilizzare questi company ID:
  - `0x01AB` per `Meta Platforms, Inc. (formerly Facebook)`
  - `0x058E` per `Meta Platforms Technologies, LLC`
  - `0x0D53` per `Luxottica Group S.p.A` (che produce i Meta Ray-Bans)
  - `0x03C2` per `Snapchat, Inc.` (che produce gli SNAP Spectacles)
  - `0x05D6` per `Zhuhai Jieli Technology Co` (che produce Rogbird VisionPro e Rollme VistaView)
  Sono **immutabili e obbligatori**. Naturalmente, Meta e altri produttori hanno anche altri prodotti dotati di Bluetooth e quindi il loro ID, ad esempio i visori VR. Pertanto, utilizzare questi codici di company ID per il processo di scansione dell'app è soggetto a falsi positivi. Ma se non vedi qualcuno che indossa un Occulus Rift intorno a te e non ci sono edifici dove potrebbe nascondersi, è probabile che si tratti invece di smart glasses.
- Durante l'abbinamento, gli smart glasses di solito emettono il loro nome prodotto, quindi possiamo cercare anche quello. Ma è raro vederlo sul campo. Le persone che intendono usare gli smart glasses nei bar, nei pub, per strada e altrove di solito si preparano in anticipo.
- Quando l'app riconosce un dispositivo Bluetooth Low Energy (BLE) con una potenza del segnale sufficiente (vedi RSI sotto), invia un messaggio di avviso. Questo dovrebbe aiutarti ad agire di conseguenza.
- Inoltre, cerchiamo i nomi dei dispositivi trasmessi, ad esempio `rayban`, `ray-ban` o `HeyCyan`. `HeyCyan` è [un famoso SDK per smart glasses di varie marche](https://github.com/ebowwa/HeyCyanSmartGlassesSDK). Tra quei dispositivi *HeyCyan*, potresti trovare anche i Nilox Smart AI Glasses venduti da ALDI e Hofer (in Austria). Per rafforzare questo, cerchiamo anche il `primary_UUID`, un identificatore di servizio fissato al lato software di quegli occhiali (`7905FFF0-B5CE-4E99-A40F-4B1E122D00D0`). Sebbene questo potrebbe cambiare in futuro, è improbabile poiché renderebbe inutilizzabili i dispositivi più vecchi, quindi potremmo semplicemente aggiungere più UUID alla routine di scansione.
## Funzionalità
- L'app *Nearby Glasses* mostra una notifica quando degli smart glasses sono nelle vicinanze (ovvero, un dispositivo BLE con uno dei company ID menzionati sopra)
- **Nelle vicinanze** significa che l'RSSI (potenza del segnale) è inferiore o uguale a un valore dato: -75 dBm per impostazione predefinita. Questo valore predefinito corrisponde a una distanza media e a un segnale accettabile.
  ### Cos'è l'RSSI?
- Lasciami spiegare un po' quel valore RSSI:<br/>
RSSI è l'acronimo di Received Signal Strength Indication. Il valore è un'indicazione dell'intensità del campo di ricezione delle applicazioni di comunicazione wireless. [Wikipedia ha un articolo piuttosto buono](https://en.wikipedia.org/wiki/Received_signal_strength_indicator) a riguardo.
In breve, l'RSSI dipende principalmente da:<br/>
  - Potenza di trasmissione del dispositivo
  - Design dell'antenna
  - Muri e ostacoli
  - Corpi umani che assorbono il segnale
  - Riflessione e interferenza
  - Orientamento del dispositivo<br/>
Ma negli scenari BLE (Bluetooth Low Energy) tipici, la distanza approssimativa in base all'RSSI (spazio aperto) è: <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 o quasi perdita del segnale<br/>
Al chiuso, le distanze sono spesso molto più brevi.<br/>
L'RSSI diminuisce approssimativamente secondo<br/>
    `RSSI ≈ -10 * n * log10(distance) + constant`<br/>
- Pertanto, la soglia RSSI predefinita di -75 dBm corrisponde a circa 10-15 metri in spazio aperto e 3-10 metri al chiuso o in spazi affollati. Hai buone probabilità di individuare così la persona che indossa gli smart glasses.
- *Nearby Glasses* mostra un log di debug opzionale esportabile (come file txt) e dispone di una funzione copia&incolla. Questi sono per utenti avanzati (nerd) e per ulteriore debug.
- In *Impostazioni*, puoi specificare la lunghezza del log e il debug (mostrare tutti gli elementi di scansione o solo i frame ADV).
- Puoi anche inserire alcuni **company ID** come stringa di valori esadecimali, ad esempio `0x01AB,0x058E,0x0D53`. Questo sovrascrive il rilevamento integrato, così la tua notifica appare per i nuovi valori.
- Per una migliore persistenza, utilizza il *Foreground Service* di Android. Puoi disabilitarlo in *Impostazioni* se non ti serve.
- Il *Notification Cooldown* in *Impostazioni* specifica quanto tempo deve passare tra due avvisi. Il valore predefinito è 10000 ms, ovvero 10 s. Questo vale anche per il canarino, ad esempio 10s significa che rimarrà in allerta per 10s prima di calmarsi di nuovo.
- Ora è un po' più localizzata: <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">
   - Inglese
   - Tedesco
   - Svizzero tedesco
   - Francese
   - Spagnolo
   - Cinese
   - Italiano
   - Portoghese (Brasile)
   - Russo
   - Turco
   - altri in arrivo, eventualmente ([supporta questo progetto contribuendo nella tua lingua!](https://github.com/yjeanrenaud/yj_nearbyglasses/issues/3))
- Ora lo sfondo dell'icona dell'app non è più trasparente
- Ora cerchiamo anche gli UUID
- *Nearby Glasses* ora supporta la modalità scura (tramite le impostazioni di sistema)
- Il problema del layout edge-to-edge dovrebbe essere risolto dalla [v1.0.4](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) in poi.
- Nuova licenza AGPL 3.0
- Ho deciso di rinunciare al CLA. Dopo alcune discussioni con persone che ne sapevano più di me sui progetti collaborativi, ho capito che era un passo inutile.
- ora ha un'icona leggermente diversa per aderire più rigorosamente alla AGPL 3.0.
## iOS e Android
- Finalmente, dopo tre settimane, il port per iOS è disponibile. Dovrebbe funzionare sulla maggior parte di iPhone e iPad; anche su quelli più vecchi (fino a iOS 16). [Il codice sorgente e i file di progetto sono forniti](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS) anch'essi. Il codice è brutto e non ortodosso. Molti approcci sono rapidi e sporchi (ad esempio riutilizzo i file json dalla localizzazione Android), ma finora funziona. *Nearby Glasses* è disponibile tramite l'[Apple App Store](https://apps.apple.com/us/app/nearby-glasses-original/id6761056896). (Si chiama original per distinguerlo da quegli imitatori). Un .ipa è disponibile per il sideloading sotto [releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases).
  L'app iOS non funziona in background, perché non ho trovato la possibilità di usare qualcosa di simile ai `ForegroundServices` per scansionare permanentemente i BTLE ADV a causa delle restrizioni di iOS. Quindi, c'è solo una *Canary Mode* disponibile in *Nearby Glasses* su iOS. Se conosci Swift e iOS meglio di me (cosa probabile), contribuisci per favore!
- Poiché questo repository contiene sia il codice dell'app Android che quello iOS, ho riorganizzato le cartelle. Quindi, ci sono [/iOS](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/iOS) e [/Android](https://github.com/yjeanrenaud/yj_nearbyglasses/blob/main/Android).

## Utilizzo

- Vedi [Releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) per scaricare l'APK o usa il Google Play Store. F-Droid e/o Accrescent potrebbero seguire.
<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. Installa l'app (da [Releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) o da [Google Play](https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses), per ora) o dall'[Apple App Store](https://apps.apple.com/us/app/nearby-glasses-original/id6761056896), e aprila
2. Premi il pulsante *Start Scanning*
3. Concedi i permessi per attivare il Bluetooth (se non già abilitato) e per accedere ai dispositivi nelle vicinanze. Alcune versioni di Android richiedono anche di concedere i permessi per accedere alla tua posizione (prima della versione 13, per lo più). *Nearby Glasses* non fa nulla con le tue informazioni sulla posizione. Se non mi credi, dai un'occhiata al [codice](https://github.com/yjeanrenaud/yj_nearbyglasses/tree/main/app)
4. se non vedi partire la scansione, potresti dover abilitare il *Foreground Service* sul tuo particolare telefono nel menu *Impostazioni* (vedi sotto)
5. Tutto pronto! Quando vengono rilevati smart glasses nelle vicinanze, apparirà una notifica. Lo fa finché non premi *Stop Scanning* o non termini definitivamente l'app
7. Nel menu (in alto a destra, l'ingranaggio), puoi fare alcune *Impostazioni*:
   1. *Enable Foreground Service*: In questo modo, impedisci ad Android di mettere in pausa l'app, evitando così che ti avvisi. Consiglio di lasciarlo abilitato
   2. *RSSI threshold*: Questo numero negativo specifica quanto lontano può essere un dispositivo per essere motivo di avviso da parte di *Nearby Glasses*. Tecnicamente, si riferisce a quanto è forte il segnale ricevuto. Più vicino a zero significa segnale migliore, quindi minore distanza tra il tuo telefono e gli smart glasses. Vedi [RSSI sopra per spiegazioni e indicazioni](#how). Consiglio di lasciarlo a -75
   3. *Enable Notifications*: Non vorresti disabilitarlo 
   4. Canary Mode. Questa è la nuova impostazione predefinita. Con questa, non riceverai notifiche di sistema che ti avvisano di smart glasses nelle vicinanze, ma invece vedrai un canarino che indica che non ci sono smart glasses intorno. L'app iOS ha solo una canary mode a causa di vincoli tecnici. <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*: Qui specifichi quante notifiche sugli smart glasses trovati nelle vicinanze vuoi ricevere o per quanto tempo il canarino dovrebbe nascondersi. Ho scelto 10 secondi (10000 ms) come valore predefinito. In questo modo, non perderai la notifica e allo stesso tempo non sarai troppo infastidito né scaricherai troppo velocemente la batteria
   6. *Enable Log Display*: Disabilitarlo potrebbe risparmiarti un po' di batteria. È disabilitato in canary mode.
   7. *Debug*: È necessario per vedere più dei soli frame BLE corrispondenti nel riquadro di visualizzazione del log. È utile per vedere se le cose funzionano. È disabilitato in canary mode.
   8. *Max log lines*: Quanto può diventare lungo il log. 200 sembra un buon equilibrio tra durata della batteria e usabilità del log (per nerd come me). È disabilitato in canary mode.
   9. *BLE ADV only*: Questo esclude altri frame Bluetooth LE dal log per una migliore leggibilità. È disabilitato in canary mode.
   10. *Override Company IDs*: Se vuoi, puoi far avvisare *Nearby Glasses* di altri dispositivi rispetto a quelli specificati sopra. Utile per il debug, almeno per me. Lascialo vuoto se non ti serve o non sai cosa farne
   11. Ogni impostazione viene salvata ed è effettiva immediatamente. Per tornare indietro, usa il pulsante o il gesto indietro
8. La funzione di esportazione ti consente di condividere un file di testo del log dell'app. Per nerd come me
9. Puoi anche copiare&incollare il log toccando il riquadro di visualizzazione del log

## ToDos
- **Ora funziona sul campo!** Sono riuscito a far testare l'app ad alcune persone con smart glasses verificati intorno a loro. Un ringraziamento speciale a Lena!
- Vedi [Releases](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) per scaricare l'APK. 
- Ho pubblicato [*Nearby Glasses* anche su Google Play](https://play.google.com/store/apps/details?id=ch.pocketpc.nearbyglasses). Tuttavia, pubblicherò sempre [le release qui su GitHub](https://github.com/yjeanrenaud/yj_nearbyglasses/releases) e [altrove](https://yves.app/nearbyglasses/latest.apk), per coloro che evitano il Google Play.

---

- Aggiungere un'opzione per inserire i falsi positivi in una lista di ignorati. Forse nella notifica?
- Non sono affatto un esperto di BT o Android. Per quello che ho imparato, si potrebbe anche scavare più a fondo nella comunicazione degli smart glasses intercettando il traffico BLE. Così facendo, probabilmente non avremmo bisogno di affidarci al fatto che il dispositivo si comporti secondo le specifiche BT, ma potremmo anche usare euristiche sulle trasmissioni di traffico cifrato senza molti falsi positivi. Ma non esamino pacchetti di traffico BT da più di dieci anni. Sono contento di essermi ricordato dei frame ADV... Quindi se qualcuno potesse aiutare su questo, sarebbe molto apprezzato!
---
- Aggiungere **più ID di produttori** di smart glasses. Al momento, sono Meta, Oakley e Snap. Sarebbe utile anche una lista di smart glasses con telecamere disponibili. Ho aperto una [ISSUE per questo](https://github.com/yjeanrenaud/yj_nearbyglasses/issues/56), così le persone possono **contribuire** inviando i loro log (che sono perfettamente sicuri, secondo me) quando incontrano altri smart glasses che registrano
- dal 24 marzo 2026, è disponibile anche la versione iOS.
- Il **problema di layout** con i **dispositivi Google Pixel** sembra risolto dalla versione 1.0.3. Se ancora non riesci a raggiungere il menu perché è in qualche modo mescolato con la barra di stato. Ci guarderò il prima possibile. Nel frattempo, prova a mettere lo schermo in modalità orizzontale e ruotalo *in senso orario (verso destra)*. 

## Tech-Solutionism?
So che questo potrebbe sembrare un posto strano per farlo, ma ascoltami su questo. Sono consapevole che questa è una soluzione tecnica a un problema sociale, che è a sua volta amplificato dalla tecnologia.
Non voglio promuovere il techsolutionism né voglio che le persone si sentano falsamente al sicuro. È comunque un approccio imperfetto e probabilmente lo sarà sempre. Non è tutto positivo solo perché questa app ora esiste. Abbiamo bisogno di soluzioni migliori per frenare la tecnologia di sorveglianza e l'invasione della privacy.

## Compilare dal sorgente
Poiché *Nearby Glasses* è open source, puoi anche compilare l'app da solo dal codice sorgente. Questo assicura che non ci siano altre librerie incluse nell'APK e che tu ottenga ciò che vuoi.

Nota che questa app si basa su:
- Gradle Wrapper: 9.3.1
- Android Gradle Plugin: 8.13.2
- Kotlin: 1.9.22
- compileSdk: 36
- targetSdk: 36
- minSdk: 26
- Nessun product flavor
- Repository: solo google() e mavenCentral()
- Nessun plugin Google Services o Firebase

### Requisiti

- **JDK 17** (richiesto — il progetto ha come target Java 17)
- **Android SDK Platform 35** installato  
  - compileSdk = 35  
  - targetSdk = 35  
- Git
### Compilazione dell'APK passo dopo passo```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