Hai tre modi per controllare un Pixoo-64: l'app ufficiale Divoom per creare senza codice, un'API HTTP locale per gli sviluppatori che desiderano il controllo diretto del dispositivo e un ecosistema in crescita di strumenti della community — librerie Python, integrazioni per Home Assistant e automazioni IFTTT — che si collocano a metà strada. Ogni percorso è adatto a obiettivi e livelli di competenza diversi e non si escludono a vicenda. Potresti iniziare con l'app, aggiungere in seguito uno script Python e infine integrare il display in una dashboard per la casa intelligente.
Questa guida illustra tutti e tre i metodi, spiega a chi è adatto ciascuno e ti aiuta a scegliere il punto di partenza giusto. Se sei alle prime armi, ti basta il percorso dell'app. Se sei uno sviluppatore o un appassionato di casa intelligente, passa alle sezioni corrispondenti alla tua configurazione.
Uno sguardo pratico alla connessione del Pixoo 64 a Home Assistant per il controllo della casa intelligente.
I tre percorsi in breve
Prima di esaminare ogni metodo, ecco un rapido confronto per aiutarti a scegliere il percorso più adatto. La maggior parte dei lettori sceglierà subito una delle opzioni, ma vale la pena dare un'occhiata a tutte e tre: potresti scoprire un'opzione che non sapevi esistesse.
| Metodo | App Divoom | API HTTP locale | Strumenti della community |
|---|---|---|---|
| Ideale per | Pixel art, galleria, widget, contatori social | Script personalizzati, dashboard di dati, automazione | Casa intelligente, automazione di eventi, Python |
| Livello di competenza | Nessuna richiesta | Sviluppatore (nozioni di base sul networking) | Da nessun codice allo sviluppo |
| Supporto ufficiale | Sì | Solo community | Solo community |
| Tempo di configurazione | 5–10 minuti | 30–60 minuti | 15–45 minuti |
La colonna «Supporto ufficiale» è importante. L'app Divoom è l'unico percorso supportato direttamente da Divoom. L'API locale e gli strumenti della community sono sviluppati da sviluppatori indipendenti che hanno effettuato il reverse engineering del protocollo di comunicazione tra l'app e il display. Funzionano bene, spesso in modo eccellente, ma gli aggiornamenti del firmware possono occasionalmente modificare il modo in cui il dispositivo risponde alle richieste personalizzate.
L'app Divoom: il tuo punto di partenza senza codice
L'app Divoom è il metodo di controllo predefinito per un buon motivo. Si connette al Pixoo-64 tramite Bluetooth per modifiche rapide e tramite Wi-Fi per le funzionalità cloud, offrendoti accesso a tutto ciò che il display può fare senza scrivere una sola riga di codice.
Nell'app troverai un editor di pixel art con modelli, una galleria della community con milioni di creazioni degli utenti, quadranti personalizzabili, widget meteo e contatori in tempo reale dei follower sui social media per YouTube, Twitch e Instagram. Puoi creare animazioni, programmare i contenuti e gestire più dispositivi dallo stesso account.
A chi è rivolta l'app
Tutti. Se hai appena tolto dalla confezione il tuo Pixoo-64 e vuoi iniziare a creare pixel art, visualizzare foto o monitorare il numero di follower sui social media, l'app gestisce tutto. È anche il percorso supportato e aggiornato attivamente da Divoom, quindi, se qualcosa va storto, hai un canale diretto per ricevere assistenza.
Quando l'app non basta
L'app diventa limitante quando hai bisogno di automazione. Supponiamo che tu voglia far visualizzare automaticamente al tuo Pixoo-64 la copertina dell'album Spotify attualmente in riproduzione, mostrare lo stato della pipeline CI/CD, aggiornarsi con i prezzi delle azioni in tempo reale o reagire ai dati dei sensori della casa intelligente. Questi casi d'uso richiedono qualcosa di più dell'interazione manuale con l'app — ed è qui che entrano in gioco gli altri due percorsi.
Consiglio per la configurazione
Scarica l'app Divoom dall'App Store o da Google Play prima di iniziare a esplorare i percorsi API riportati di seguito. Anche gli sviluppatori usano l'app per la configurazione iniziale del Wi-Fi e per rilevare i dispositivi.
Il percorso dell'API locale: per gli sviluppatori
Il Pixoo-64 comunica con l'app Divoom sulla rete Wi-Fi locale tramite richieste HTTP. Gli sviluppatori della community hanno sottoposto questo protocollo a reverse engineering, documentando gli endpoint e i formati dei payload necessari per inviare dati pixel, cambiare canale di visualizzazione, regolare la luminosità e controllare direttamente le animazioni, senza usare l'app come intermediario.
In pratica, puoi scrivere uno script sul tuo computer, inviare una richiesta HTTP POST all'indirizzo IP del tuo Pixoo-64 e guardare il display aggiornarsi in tempo reale. Il dispositivo deve essere connesso alla stessa rete Wi-Fi del computer che invia la richiesta.
Cosa puoi creare
L'API locale apre la strada a progetti che la sola app non può gestire:
- Animazioni di pixel art personalizzate alimentate da dati esterni (meteo, azioni, attività su GitHub)
- La copertina dell'album in riproduzione su Spotify visualizzata sulla scrivania
- Indicatori dello stato delle build CI/CD — verde se superate, rosso se fallite
- Sistemi di notifica che inviano avvisi al display
- Generatori di pixel art in time-lapse o timer per il conto alla rovescia durante le dirette streaming
Strumenti essenziali della community per l'API locale
Due progetti si distinguono come punti di partenza per gli sviluppatori:
pixoo-rest è un wrapper API RESTful basato sulla libreria Python pixoo. Funziona in Docker, include una Swagger UI per testare gli endpoint e gestisce automaticamente la conversione delle immagini. Se vuoi un server HTTP già pronto che faccia da tramite tra i tuoi script e il display, è il percorso più rapido.
pixoo (di SomethingWithComputers) è la libreria Python più popolare per la comunicazione diretta con Pixoo-64. Supporta Python 3.12, include un'interfaccia REST integrata e offre la conversione automatica delle immagini: puoi quindi inviare qualsiasi file immagine e la libreria gestirà il ridimensionamento in pixel art a 64x64.
Limitazioni senza giri di parole
L'API locale non è un prodotto ufficiale Divoom. È gestita dalla community e ottenuta tramite reverse engineering, il che significa:
- Gli aggiornamenti del firmware possono modificare o bloccare temporaneamente l'accesso all'API. I membri della community hanno segnalato che alcune versioni più recenti del firmware hanno modificato le porte di rete aperte.
- Devi trovare l'indirizzo IP del tuo Pixoo-64 sulla rete locale (puoi consultare il pannello di amministrazione del router o la schermata delle informazioni sul dispositivo nell'app Divoom).
- Non esiste un canale di supporto ufficiale Divoom per i problemi relativi all'API: i tracker delle issue dei repository GitHub e il subreddit r/Divoom sono le risorse migliori.
- Il comportamento del protocollo può variare tra il Pixoo-64 originale e il modello più recente Pixoo-64 II.
Prima di addentrarti nell'API locale, controlla la versione del firmware. Se l'accesso locale non funziona sul tuo dispositivo, nei repository della community su GitHub troverai spesso issue aperte che discutono soluzioni alternative specifiche per il firmware.
Strumenti e integrazioni della community
Oltre all'API locale di base, la community di sviluppatori ha creato un ricco ecosistema di strumenti che racchiudono il protocollo in pacchetti più accessibili. Si va dalle librerie Python per gli script alle integrazioni complete con le piattaforme per la casa intelligente.
Librerie Python
Se hai dimestichezza con Python, diverse librerie su PyPI rendono semplice il controllo di Pixoo-64:
| Libreria | Focus | Ideale per |
|---|---|---|
| pixoo | Completa: conversione delle immagini, interfaccia REST, supporto per le animazioni | La maggior parte degli sviluppatori agli inizi |
| APIxoo | Wrapper dell'API server per il cloud Divoom | Automazione basata sul cloud |
| pixoo-api | Metodi per la manipolazione della tela | Controllo dei pixel a basso livello |
| Strumenti avanzati per Pixoo64 | Set di strumenti avanzato con funzionalità evolute | Utenti esperti che desiderano funzionalità aggiuntive |
La libreria pixoo è il punto di partenza più utilizzato. Installala con pip, connettiti all'indirizzo IP del tuo dispositivo e potrai inviare dati pixel in pochi minuti. La libreria gestisce il noioso lavoro di conversione delle immagini a colori in pixel art 64x64, così puoi concentrarti su ciò che vuoi visualizzare invece che sulla formattazione dei dati.
Integrazioni per la smart home
Se il tuo obiettivo è integrare Pixoo-64 in una configurazione domotica più ampia anziché scrivere script personalizzati, diverse piattaforme dispongono già di integrazioni sviluppate dalla community:
Home Assistant è l'integrazione più attiva. Utilizzando la libreria pixoo-rest come ponte, puoi visualizzare dati dei sensori, notifiche, eventi del calendario e pixel art personalizzata attivati dalle automazioni di Home Assistant. Immagina Pixoo-64 che passa a un'animazione della pioggia quando il sensore meteo rileva precipitazioni, oppure che mostra un avviso "riunione tra 5 minuti" ricavato dal tuo Google Calendar.
Homey dispone di un'app Pixoo64 dedicata nella sua piattaforma per la smart home, offrendo funzionalità di automazione simili agli utenti Homey.
IFTTT collega Pixoo-64 a oltre 1.000 servizi per automatizzare eventi. Non serve programmare: configuri trigger (nuova email, movimento rilevato, post su Instagram) e azioni (visualizzare contenuti specifici su Pixoo-64) tramite l'interfaccia visiva di IFTTT.
Lumia Stream merita una menzione per streamer e creator. Controlla Pixoo-64 per sovrimpressioni durante le dirette, avvisi della chat e notifiche sui nuovi follower durante le trasmissioni dal vivo.
Come scegliere il percorso
I tre percorsi non sono in concorrenza: sono livelli diversi. La maggior parte degli utenti più assidui di Pixoo-64 finisce per combinare l'app con almeno un altro metodo. Ma se hai appena iniziato, ecco come scegliere il punto di partenza.
Inizia con l'app Divoom se:
- Vuoi creare pixel art, esplorare la galleria della community o configurare widget e quadranti dell'orologio
- Non vuoi occuparti di indirizzi IP, comandi da terminale o file di configurazione
- Hai bisogno del supporto ufficiale e di una stabilità garantita
Scegli l'API locale se:
- Vuoi creare script personalizzati che inviino automaticamente dati al display
- Hai dimestichezza con Python, le richieste HTTP e le nozioni di base del networking
- Stai realizzando qualcosa di specifico: una dashboard, un visualizzatore o un sistema di notifiche
Scegli gli strumenti della community se:
- Utilizzi già Home Assistant, Homey o IFTTT e vuoi aggiungere Pixoo-64 alle automazioni esistenti
- Vuoi l'automazione senza scrivere codice da zero (l'interfaccia visiva di IFTTT gestisce tutto)
- Sei uno streamer alla ricerca di un'integrazione per overlay in tempo reale
Se hai ancora dubbi, inizia dall'app. È il modo più rapido per scoprire cosa può fare Pixoo-64 e ti offre una base su cui costruire. L'API e gli strumenti della community saranno sempre disponibili quando vorrai approfondire.
Il tuo primo passo per ciascun percorso
Percorso app: collega ed esplora
Scarica l'app Divoom, collega il tuo Pixoo-64 tramite Bluetooth e dedica dieci minuti a esplorare la galleria della community. Troverai migliaia di creazioni di pixel art, quadranti e animazioni realizzate da altri utenti. Caricane alcune sul display per farti un'idea di ciò che può mostrare il pannello 64x64. Per domande sulla configurazione hardware, il manuale del prodotto illustra il collegamento fisico e la configurazione WiFi.
Percorso API: installa e invia il tuo primo frame
Installa la libreria Python pixoo sul tuo computer. Trova l'indirizzo IP del tuo Pixoo-64 (controlla l'elenco dei dispositivi connessi nel router o le informazioni sul dispositivo nell'app). Esegui un semplice script che invii un colore uniforme al display. Quando funziona, avrai confermato l'accesso all'API locale e potrai iniziare a creare progetti più complessi.
Percorso smart home: trova la tua integrazione
Se usi Home Assistant, cerca nei forum della community la guida all'integrazione di Pixoo-64. La configurazione prevede in genere l'esecuzione del container Docker pixoo-rest e l'impostazione dell'indirizzo IP del display in Home Assistant. Per IFTTT, consulta le applet Pixoo-64 disponibili e collega un servizio che già utilizzi. Entrambi i percorsi hanno community attive pronte ad aiutarti per le domande sulla configurazione.
Domande frequenti
L'API di Pixoo-64 è un prodotto ufficiale Divoom?
No. L'API HTTP locale utilizzata dagli sviluppatori è stata sottoposta a reverse engineering dalla community; non è documentata né supportata ufficialmente da Divoom. Il metodo di controllo ufficiale è l'app Divoom. Strumenti della community come la libreria Python pixoo, pixoo-rest e varie integrazioni per la smart home sono gestiti da sviluppatori indipendenti. Funzionano bene, ma gli aggiornamenti del firmware possono occasionalmente modificare il comportamento del dispositivo.
Posso usare Python per controllare il mio Pixoo-64?
Sì. L'opzione più popolare è la libreria Python pixoo, disponibile su PyPI. Supporta Python 3.12, gestisce la conversione automatica delle immagini in pixel art 64x64 e include un'interfaccia REST integrata. Altre opzioni includono APIxoo (per l'accesso all'API cloud) e pixoo-api (per il controllo del canvas a basso livello). Tutte sono gestite dalla community.
L'API locale funziona con i firmware più recenti di Pixoo-64?
Dipende dalla versione specifica del firmware. Le segnalazioni della community indicano che alcune versioni più recenti del firmware hanno modificato le porte di rete aperte, cosa che può influire sull’accesso all’API locale. Prima di affidarti all’API per un progetto, verifica la connettività di base con il firmware attualmente installato. Nei repository GitHub di pixoo-rest e pixoo si trovano spesso issue aperte che discutono il comportamento specifico delle versioni del firmware e le relative soluzioni alternative.
Home Assistant può visualizzare dati sul mio Pixoo-64?
Sì, tramite un’integrazione gestita dalla community. La configurazione tipica utilizza il container Docker pixoo-rest come ponte tra Home Assistant e Pixoo-64. Una volta configurato, puoi attivare display di pixel art in base ai dati dei sensori, agli eventi del calendario, alle automazioni e molto altro. Consulta i forum della community di Home Assistant per la guida all’integrazione più recente e le note sulla compatibilità.
Devo essere un programmatore per automatizzare il mio Pixoo-64?
Non necessariamente. IFTTT offre un’interfaccia visiva per collegare Pixoo-64 a oltre 1.000 servizi senza scrivere codice. Puoi creare “applet” che attivano azioni sul display in base a eventi come nuove e-mail, rilevamento di movimenti o attività sui social media. Anche Home Assistant offre strumenti visivi per creare automazioni, sebbene la configurazione iniziale richieda maggiori competenze tecniche. La stessa app Divoom supporta inoltre la programmazione e i contatori automatici dei social media senza bisogno di scrivere codice.
Cosa fare dopo
Il Pixoo-64 è uno dei display per pixel art più personalizzabili sul mercato, grazie alla connettività Wi-Fi e alla vivace community di sviluppatori che lo circonda. Che tu scelga di usare l’app, scriva il tuo primo script Python o lo integri nella tua smart home, il display diventa più di una decorazione statica: diventa una tela programmabile che reagisce al mondo che ti circonda.
Se non hai ancora un Pixoo-64 e vuoi vedere com’è il pannello 64x64 in una configurazione da scrivania, esplora la collezione di smart display pixel per confrontare i modelli. Se ne possiedi già uno e ti serve solo aiuto con le nozioni di base — configurazione Wi-Fi, associazione Bluetooth o configurazione dell’app — consulta il manuale del prodotto per una guida passo passo.
Continua a imparare
Cerchi un display con funzionalità API integrate? Dai un’occhiata a Times Gate — progettato per sviluppatori e appassionati di dashboard.
Per la creazione generica di pixel art, consulta la nostra guida all’app Divoom.
Per saperne di più su come valutiamo i prodotti Divoom, consulta la nostra pagina Come eseguiamo i test.
