Installare l'app
L'app JZ Companion sul computer: cosa contiene, come si installa e dove tiene i dati.
L'app è quello che l'utente installa: una finestra con il configuratore, l'icona nella barra dei menu (o nell'area di notifica) e dentro il cervello, che parte con l'app e riparte da solo se si ferma.
Cosa serve
- Un computer con macOS, Windows o Linux. Il cervello è stato provato dal vero su macOS; i percorsi per Windows e Linux sono scritti ma non ancora provati su un computer vero, e ogni integrazione lo dice nel registro.
- Una scheda Waveshare ESP32-S3-Touch-LCD-4B con il firmware di JZ Companion, e un cavo USB.
- Per il Wi-Fi o il Bluetooth, il computer e la scheda nella stessa rete.
Installazione
Scarica l'installer
Un pacchetto per sistema: .dmg su macOS, .msi o .exe su Windows, .deb, .rpm o .AppImage su Linux.
I pacchetti si trovano nelle release del progetto (il link "Scarica l'app" del sito).
Installa e apri
Trascina l'app in Applicazioni (macOS) o lancia l'installer. L'app ammette una sola istanza: aprirla di nuovo porta in primo piano la finestra che c'è già.
Aspetta il configuratore
Finché il cervello non è pronto la finestra mostra una pagina di attesa; poi si apre il configuratore. Da qui puoi abbinare la scheda.
Dove tiene i dati
Tutto sta nella tua cartella personale, in ~/.jz-desk:
| Cosa | Dove |
|---|---|
| Configurazione | config.json |
| Chiavi delle integrazioni | chiavi/, cifrate (vedi sicurezza e privacy) |
| Schede abbinate | schede.json |
| Registri | logs.db (SQLite, 30 giorni) e un file di testo per fonte in logs/ |
| Immagini scaricate | immagini/ |
Per usare un cervello di prova separato, la variabile JZ_DIR cambia la cartella.
La porta
Il cervello ascolta su una porta sola, la 8765. Se è occupata, all'avvio sceglie la successiva libera (o te
lo chiede, se c'è un terminale) e si ricorda la scelta. Il configuratore è su http://localhost:<porta> e si apre
solo da questo computer.
Dai sorgenti
Servono Bun e, per l'app, Rust. Dalla radice della repo:
bun install
bun run dev # solo il cervello, con il configuratore
bun run desktop:build # l'app: .app e .dmg, .msi e .exe, .deb, .rpm e .AppImagePer provare la UI senza la scheda c'è il simulatore sul Mac (SDL) o nel browser: vedi il README della repo.