Documentazione BTicz

Cos'è BTicz

BTicz è un'app gratuita e multi-piattaforma che ti permette di monitorare e controllare il tuo sistema domotico Domoticz direttamente dallo smartphone, tablet o desktop — ovunque tu sia.

L'app si connette direttamente alla tua installazione Domoticz tramite rete locale o internet, senza intermediari cloud, garantendo privacy e velocità.

Requisiti

Dispositivo

• Android 8.0 (Oreo) o superiore
• Linux (Ubuntu 20.04+, Debian 11+, Fedora 36+)
• Windows 10 / 11 (64-bit)
• iOS / macOS — in arrivo

Domoticz

• Domoticz versione 2020.x o superiore
• API JSON abilitata (attiva per default)
• Domoticz raggiungibile dalla rete del tuo dispositivo

Quick Start

Segui questi passaggi per essere operativo in meno di 5 minuti.

Installazione Android

1. Scarica il file .apk dalla pagina Download.
2. Sul dispositivo Android, vai in Impostazioni → Sicurezza e abilita Origini sconosciute (o Installa app sconosciute nelle versioni più recenti).
3. Apri il file APK scaricato dal gestore file e segui le istruzioni di installazione.
4. Una volta installata, l'app appare nella lista delle app.

Installazione Linux

BTicz è distribuito come archivio .tar.xz con uno script di installazione automatica.

# Estrai l'archivio
tar -xf BTicz-v0.1-linux-x64.tar.xz
cd BTicz-v0.1-linux-x64

# Installa (richiede sudo)
sudo ./install-linux.sh

Lo script installa:

• Binario → /usr/local/bin/BTicz
• Icona → /usr/share/pixmaps/bticz.png
• Voce menu → /usr/share/applications/BTicz.desktop

Dopo l'installazione, avvia BTicz dal menu applicazioni oppure da terminale con il comando BTicz.

Disinstallazione

sudo rm /usr/local/bin/BTicz
sudo rm /usr/share/pixmaps/bticz.png
sudo rm /usr/share/applications/BTicz.desktop

Installazione Windows

BTicz per Windows è un eseguibile standalone, senza installazione:

1. Scarica il file .zip dalla pagina Download.
2. Estrai lo zip in una cartella a tua scelta (es. C:\Programmi\BTicz\).
3. Fai doppio clic su BTicz.exe per avviare l'app.
4. Se Windows Defender SmartScreen mostra un avviso, clicca "Ulteriori informazioni" poi "Esegui comunque".

Aggiungere Domoticz

Per collegare BTicz al tuo server Domoticz:

1. Apri il menu laterale (icona ☰ in basso a sinistra).
2. Vai su Impostazioni.
3. Nella sezione Backend, tocca "Aggiungi Domoticz".
4. Compila il modulo:

Una volta salvato, il backend appare nella lista. Verrà impostato automaticamente come attivo se è il primo configurato.

Connessione SSL/HTTPS

Se il tuo Domoticz è configurato con HTTPS (consigliato per accesso remoto):

• Abilita l'opzione "Usa HTTPS/SSL" nel modulo di configurazione.
• Se usi un certificato self-signed, abilita anche "Ignora verifica certificato".
• La porta tipica per HTTPS è 443 o 8443.

Impostazioni generali

Accessibili da Menu → Impostazioni → sezione Generale:

• Lingua — Italiano o English. Richiede riavvio dell'app.
• Tema — Chiaro, Scuro, o segui il sistema operativo.
• Intervallo aggiornamento — Con quale frequenza l'app ricarica i dati (in secondi).
• Dimensione card — Normale (3 per riga) o Grande (2 per riga) su mobile.

Navigazione nell'app

BTicz usa una barra laterale a scomparsa:

• Tocca l'icona ☰ (hamburger) in basso a sinistra per aprirla o chiuderla.
• Le voci di menu portano alle diverse sezioni dell'app.
• Il pulsante Aggiorna nel footer ricarica i dati della pagina corrente.

Home — Preferiti

La pagina Home mostra i dispositivi che hai contrassegnato come preferiti in Domoticz. È il modo più rapido per accedere ai dispositivi più utilizzati.

Dashboard

La Dashboard mostra tutti i dispositivi presenti nel tuo Domoticz, organizzati per tipo. Puoi scorrere l'elenco e interagire con ciascun dispositivo.

Comandi (Switches)

La pagina Comandi filtra i soli dispositivi di tipo interruttore, luce o attuatore. Per ogni dispositivo puoi:

• Attivare / disattivare — tap sul pulsante nella card.
• Vedere lo stato — Acceso/Spento con colore indicativo.
• Aprire lo storico — tap sull'icona del grafico.

Temperature e sensori

La pagina Temperature mostra tutti i sensori di temperatura, umidità e altri sensori ambientali. I valori si aggiornano secondo l'intervallo configurato.

Pannello Allarme

Se il tuo Domoticz ha un pannello allarme configurato, puoi gestirlo da BTicz. Il dialogo allarme permette di:

• Armamento Casa — Attiva il perimetro esterno.
• Armamento Fuori — Attiva tutto il sistema.
• Disarmo — Disattiva l'allarme.

Per le operazioni sensibili è richiesto l'inserimento del codice PIN.

Storico dispositivi

Per ogni dispositivo puoi aprire lo storico degli eventi toccando l'icona grafico (📈) nella card. Lo storico mostra gli ultimi eventi o valori registrati da Domoticz.

FAQ — Domande frequenti

L'app non si connette a Domoticz. Cosa faccio?

Verifica che:

• L'IP e la porta siano corretti (prova ad aprire http://<IP>:<porta> nel browser).
• Il dispositivo con BTicz e il server Domoticz siano sulla stessa rete.
• Il firewall di Domoticz o del router non blocchi la porta.
• Se usi SSL, che il certificato sia valido o che "Ignora verifica" sia attivo.

Non vedo i miei dispositivi preferiti nella Home

I preferiti si sincronizzano da Domoticz. Assicurati di aver contrassegnato almeno un dispositivo come preferito dall'interfaccia web di Domoticz, poi premi Aggiorna nell'app.

Come cambio la lingua?

Vai in Impostazioni → Generale → Lingua, seleziona la lingua desiderata e salva. L'app chiederà di riavviarsi per applicare il cambio.

La versione beta ha una scadenza?

Sì, la versione beta ha una data di scadenza. Riceverai un avviso quando mancano pochi giorni. Tieni l'app aggiornata scaricando le nuove versioni dalla pagina Download.

I dati di configurazione (password) sono sicuri?

Sì. Le credenziali vengono salvate in modo sicuro nel keystore del sistema operativo (Android Keystore su Android, sistema di credenziali protette su desktop). Non vengono mai trasmesse a server esterni.

Risoluzione problemi

Schermo bianco o app che non si avvia (Linux)

Verifica di avere i driver OpenGL installati. Su Debian/Ubuntu:

sudo apt install libgl1-mesa-dri libgl1-mesa-glx

Errore "certificato SSL non valido"

Hai due opzioni:

• Usa un certificato valido (es. Let's Encrypt) nel tuo Domoticz.
• In BTicz, nella configurazione backend, attiva "Ignora verifica certificato SSL".

L'app è lenta ad aggiornare i dati

Controlla l'impostazione Intervallo aggiornamento in Impostazioni Generali. Un valore basso (es. 5 secondi) fa ricaricare i dati più spesso, ma consuma più batteria.

Contatti e supporto

Non hai trovato risposta al tuo problema? Contattaci:

• 📧 Email: info@bticz.app
• 🐛 Bug report: GitHub Issues