Healko

Un iPhone con iOS 17 o successivo, una configurazione Apple Health con almeno una metrica registrata (Apple Watch aiuta) e un'istanza Home Assistant in esecuzione — rete locale o Nabu Casa Cloud. Nessuna creazione di account, nessuna iscrizione email.

In Home Assistant: clicca sul profilo (in basso a sinistra) → scorri in fondo alla pagina del profilo → «Long-Lived Access Tokens» → «Create Token» → chiamalo «Healko» → copia il token. Incollalo nella schermata di configurazione di Healko. Lo stesso token funziona sia per collegarsi localmente che tramite Nabu Casa Cloud.

Entrambi funzionano. Locale (es. http://homeassistant.local:8123) è più veloce e non usa banda internet — ma funziona solo quando il tuo iPhone è sulla stessa Wi-Fi di HA. Nabu Casa Cloud (https://abc12345.ui.nabu.casa) funziona ovunque — cellulare, in viaggio, ecc. Molti utenti aggiungono entrambi gli URL e li alternano. Healko usa l'URL configurato al momento.

Sì. Tocca «Salta — Modalità Demo» nella schermata di benvenuto. L'app popola dati sintetici e ti permette di raggiungere Oggi / Tendenze / Impostazioni senza alcuna configurazione HA o autorizzazione HealthKit. Utile per valutare prima di impegnarsi.

Tipicamente sotto i 30 secondi dal momento in cui Apple Health registra un campione. Healko usa HKObserverQuery con enableBackgroundDelivery, così iOS sveglia l'app anche con lo schermo spento. La consegna in background è opportunistica — iOS può ritardarla un po' se il telefono è in modalità risparmio energetico o sotto stress termico.

38 in v1.0, che coprono: attività (passi, distanza, energia attiva/basale, minuti di esercizio, push count, piani saliti, velocità di camminata, lunghezza del passo), vitali (battiti, FC riposo, HRV SDNN, pressione, SpO2, temperatura corporea, frequenza respiratoria), corpo (peso, BMI, % grasso corporeo, massa magra, altezza, vita), sonno (fasi, tempo a letto), nutrizione (acqua, caffeina) e altre. La schermata Impostazioni le elenca tutte.

HKObserverQuery + enableBackgroundDelivery di Apple ha costi reali (batteria, profondità della coda del kernel) che crescono col numero di tipi osservati. Per gli utenti gratuiti limitiamo a 5 per mantenere l'esperienza fluida su iPhone più vecchi. Pro rimuove il limite.

No. Ogni POST di metrica va dal tuo iPhone direttamente alla tua istanza HA tramite l'URL configurato. Healko non ha backend. Le uniche chiamate in uscita di Healko sono: (a) al tuo Home Assistant, e (b) a ipinfo.io come parte di un lookup IP pubblico opzionale se acconsenti. Nessuna analitica, nessuna telemetria, nessun cloud AI.

Mappi un sensore HA (es. sensor.bedroom_scale) a una metrica Apple Health (es. Peso). Healko interroga il sensore HA secondo la cadenza scelta (10s / 30s / 5min) e quando il valore cambia scrive un nuovo HKQuantitySample in Apple Health. Il campione è etichettato con l'ID entità HA così puoi vedere in Apple Health esattamente da quale sensore proviene ogni lettura. Il bridge inverso è una funzione Pro.

Nel Portachiavi iOS solo su questo dispositivo. Specificamente con kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly, il che significa che il token è cifrato a riposo e disponibile solo dopo che il dispositivo è stato sbloccato almeno una volta dopo l'avvio. Non lascia mai il tuo telefono.

I dati sanitari sono raccolti per la funzionalità dell'app, non collegati all'identità, non usati per il tracciamento. È l'unica categoria spuntata. Healko non ha analitica, annunci o SDK di terze parti.

No. Nessun account, nessuna email, nessuna password. L'unica credenziale che Healko memorizza è il tuo URL HA e token. Disconnetti in qualsiasi momento dalle Impostazioni per cancellarli.

Gratis: 5 metriche simultanee in direzione diretta, sincronizzazione manuale, dashboard completa. Pro: tutte le 38 metriche, il bridge inverso, la libreria Comandi rapidi completa, timing di push prioritario, funzioni Watch al rilascio.

Acquisto non-consumabile una tantum di $79.99 che sblocca le funzioni Pro per sempre su ogni dispositivo legato al tuo Apple ID. Nessun addebito ricorrente. Include tutte le funzioni Pro attuali e future. Progettato per la community HA che non vuole abbonamenti.

Sì. Cancella l'abbonamento dalle impostazioni Apple ID (il tuo mensile continuerà fino alla fine del periodo), poi compra a Vita separatamente. Apple attualmente non offre un percorso di «credito verso upgrade» tra abbonamenti e acquisti una tantum, ma i conti tornano dopo uno o due anni.

Cause più comuni:

• Formato URL errato: includi il protocollo (http:// o https://) e la porta. Locale: http://homeassistant.local:8123. Cloud: https://abc.ui.nabu.casa (senza porta).
• Mismatch Wi-Fi: per URL locali il telefono deve essere sulla stessa rete. Se sei su cellulare, usa l'URL Cloud.
• Token scaduto o ruotato: genera un nuovo Long-Lived Access Token in HA e incollalo.
• HA in riavvio: se hai appena riavviato HA, aspetta 30 secondi.

Il tuo token non è valido per questa istanza HA. In HA: profilo → Long-Lived Access Tokens → controlla che il token esista ancora o generane uno nuovo. Nota: rigenerare un token esistente invalida il vecchio — incolla quello nuovo in Healko.

Le entità REST-API di HA vivono solo in memoria runtime — riavviare HA le cancella. Apri Healko → Impostazioni → «Invia tutte le metriche a HA ora». Questo ripubblica ogni metrica abilitata e le entità riappaiono immediatamente. Healko ripubblica anche in foreground per questa ragione.

Apri l'app una volta per svegliarla. iOS potrebbe aver sospeso i privilegi background di Healko per: (a) modalità risparmio energetico, (b) limitazione termica, (c) hai chiuso forzatamente l'app dallo switcher multitasking (che disabilita il background fino al prossimo avvio). Riaprire ripristina sempre la sincronizzazione.

Verifica che la metrica sia abilitata in Impostazioni → Metriche. Se è una metrica che Healko ha ma Apple Health no (nessun dato storico), Healko non ha nulla da inviare. Indossa Apple Watch o aggiungi dati di test in Apple Health → Sfoglia → Aggiungi dati, poi attiva una sincronizzazione manuale.

Apple nasconde lo stato di lettura per design — anche se hai concesso accesso nell'onboarding, Apple Health → Sorgenti → Healko mostra cosa viene effettivamente letto. Se un tipo è disattivato, abilitalo lì.

Il bridge inverso interroga in foreground o mentre l'app è in esecuzione. iOS sospenderà i poll a lungo termine. Le funzioni Pro includono task background più duraturi. Se un sensore smette di apparire in Apple Health, apri Healko una volta — questo riavvia sempre il loop.

La Modalità Demo cortocircuita tutte le letture HK reali e scritture HA — nessuna notifica reale dovrebbe partire. Se ne vedi una, invia un'email a [email protected] con la tua versione iOS e uno screenshot. La copertura demo è testata ad ogni rilascio.

Impostazioni → «Disconnetti e riavvia onboarding». Questo cancella URL HA e token salvati dal dispositivo e mostra di nuovo la schermata di benvenuto. I permessi HealthKit restano nelle Impostazioni iOS — vai a Impostazioni → Salute → Healko per revocarli completamente.