Guide de démarrage à l’API Divoom Pixoo-64

Guide de démarrage à l’API Divoom Pixoo-64

Vous avez trois façons de contrôler un Pixoo-64 : l’application officielle Divoom pour créer sans code, une API HTTP locale pour les développeurs qui souhaitent contrôler directement l’appareil, et un écosystème croissant d’outils communautaires — bibliothèques Python, intégrations Home Assistant et automatisations IFTTT — qui se situent entre les deux. Chaque méthode convient à des objectifs et des niveaux de compétence différents, et elles ne s’excluent pas mutuellement. Vous pouvez commencer avec l’application, ajouter un script Python plus tard, puis intégrer votre écran à un tableau de bord de maison connectée.

Ce guide présente les trois méthodes, explique à qui chacune s’adresse et vous aide à choisir le bon point de départ. Si vous êtes complètement débutant, la méthode via l’application vous suffira. Si vous êtes développeur ou passionné de maison connectée, passez directement aux sections correspondant à votre configuration.

Un aperçu pratique de la connexion du Pixoo 64 à Home Assistant pour le contrôler dans une maison connectée.

Les trois voies en un coup d’œil

Avant d’examiner chaque méthode, voici une comparaison rapide pour vous aider à choisir. La plupart des lecteurs s’orienteront immédiatement vers l’une des options, mais il vaut la peine de parcourir les trois : vous découvrirez peut-être une possibilité dont vous ignoriez l’existence.

Méthode Application Divoom API HTTP locale Outils communautaires
Idéal pour Pixel art, galerie, widgets, compteurs sociaux Scripts personnalisés, tableaux de bord de données, automatisation Maison connectée, automatisation d’événements, Python
Niveau de compétence Aucune requise Développeur (bases des réseaux) Sans code à développeur
Assistance officielle Oui x Communauté uniquement x Communauté uniquement
Temps de configuration 5 à 10 minutes 30 à 60 minutes 15 à 45 minutes

La colonne « Assistance officielle » est importante. L’application Divoom est la seule solution directement prise en charge par Divoom. L’API locale et les outils communautaires sont développés par des développeurs indépendants qui ont rétroconçu le protocole de communication entre l’application et l’écran. Ils fonctionnent bien — souvent remarquablement bien —, mais les mises à jour du firmware peuvent parfois modifier la façon dont l’appareil répond aux requêtes personnalisées.

L’application Divoom : votre point de départ sans code

L’application Divoom est la méthode de contrôle par défaut, et ce n’est pas sans raison. Elle se connecte au Pixoo-64 via Bluetooth pour effectuer rapidement des modifications et via le Wi-Fi pour les fonctionnalités cloud. Elle vous donne accès à tout ce que l’écran peut faire, sans écrire une seule ligne de code.

Dans l’application, vous trouverez un éditeur de pixel art avec des modèles, une galerie communautaire contenant des millions de créations réalisées par les utilisateurs, des cadrans personnalisables, des widgets météo et des compteurs en temps réel des abonnés sur YouTube, Twitch et Instagram. Vous pouvez créer des animations, planifier du contenu et gérer plusieurs appareils depuis le même compte.

À qui s’adresse l’application

Tout le monde. Si vous venez de déballer votre Pixoo-64 et souhaitez commencer à créer du pixel art, afficher des photos ou suivre l’évolution de votre nombre d’abonnés sur les réseaux sociaux, l’application s’en charge entièrement. C’est également la voie activement prise en charge et mise à jour par Divoom ; ainsi, en cas de problème, vous disposez d’un canal direct pour obtenir de l’aide.

Quand l’application ne suffit plus

L’application montre ses limites dès que vous avez besoin d’automatisation. Vous souhaitez peut-être que votre Pixoo-64 affiche automatiquement la pochette de l’album Spotify en cours de lecture, indique l’état de votre pipeline CI/CD, se mette à jour avec les cours des actions en temps réel ou réagisse aux données de capteurs domotiques. Ces cas d’usage nécessitent autre chose qu’une interaction manuelle avec l’application — c’est là qu’interviennent les deux autres voies.

Écran Divoom Pixoo-64 affichant du pixel art avec des personnages de jeu à côté d’une configuration gaming à deux écrans
Le Pixoo-64 trouve naturellement sa place à côté d’un écran de gaming, affichant du pixel art qui complète l’aménagement du bureau.

Conseil de configuration

Téléchargez l’application Divoom depuis l’App Store ou Google Play avant de commencer à explorer les voies d’accès à l’API ci-dessous. Même les développeurs utilisent l’application pour la configuration initiale du Wi-Fi et la détection des appareils.

La voie de l’API locale : pour les développeurs

Le Pixoo-64 communique avec l’application Divoom sur votre réseau Wi-Fi local à l’aide de requêtes HTTP. Les développeurs de la communauté ont procédé à la rétro-ingénierie de ce protocole et documenté les points de terminaison ainsi que les formats de charge utile nécessaires pour envoyer des données de pixels, changer de canal d’affichage, régler la luminosité et contrôler directement les animations — sans que l’application serve d’intermédiaire.

En pratique, cela signifie que vous pouvez écrire un script sur votre ordinateur, envoyer une requête HTTP POST à l’adresse IP de votre Pixoo-64 et voir l’écran se mettre à jour en temps réel. L’appareil doit être connecté au même réseau Wi-Fi que la machine qui envoie la requête.

Ce que vous pouvez créer

7. L’API locale permet de réaliser des projets que l’application seule ne peut pas gérer :

  • 6. Des animations en pixel art personnalisées alimentées par des données externes (météo, cours des actions, activité GitHub)
  • 5. La pochette de l’album en cours de lecture sur Spotify affichée sur votre bureau
  • 4. Des indicateurs d’état des compilations CI/CD — vert en cas de réussite, rouge en cas d’échec
  • 3. Des systèmes de notification qui envoient des alertes à l’écran
  • 2. Des générateurs de pixel art en accéléré ou des comptes à rebours pour le streaming

1. Des outils communautaires clés pour l’API locale

Deux projets se distinguent comme points de départ pour les développeurs :

pixoo-rest est un wrapper d’API RESTful basé sur la bibliothèque Python pixoo. Il s’exécute dans Docker, inclut une interface utilisateur Swagger pour tester les points de terminaison et gère automatiquement la conversion des images. Si vous souhaitez disposer d’un serveur HTTP prêt à l’emploi entre vos scripts et l’écran, c’est la solution la plus rapide.

pixoo (par SomethingWithComputers) est la bibliothèque Python la plus populaire pour communiquer directement avec le Pixoo-64. Elle prend en charge Python 3.12, inclut une interface REST intégrée et offre une conversion automatique des images : vous pouvez ainsi envoyer n’importe quel fichier image, la bibliothèque se chargeant de réduire l’image en pixel art de 64x64.

Limitations honnêtes

L’API locale n’est pas un produit officiel de Divoom. Elle est maintenue par la communauté et issue de la rétro-ingénierie, ce qui signifie :

  • Les mises à jour du firmware peuvent modifier ou bloquer temporairement l’accès à l’API. Des membres de la communauté ont signalé que certaines versions plus récentes du firmware avaient modifié les ports réseau ouverts.
  • Vous devez trouver l’adresse IP de votre Pixoo-64 sur votre réseau local (le panneau d’administration de votre routeur ou l’écran d’informations sur l’appareil dans l’application Divoom peuvent vous aider).
  • Il n’existe pas de canal d’assistance officiel de Divoom pour les problèmes liés à l’API ; les outils de suivi des problèmes des dépôts GitHub et le subreddit r/Divoom sont vos meilleures ressources.
  • Le comportement du protocole peut varier entre le Pixoo-64 original et le modèle plus récent Pixoo-64 II.

Avant de vous plonger dans l’API locale, vérifiez la version de votre firmware. Si l’accès local ne fonctionne pas sur votre appareil, les dépôts communautaires sur GitHub contiennent souvent des problèmes ouverts consacrés aux solutions de contournement propres à certaines versions du firmware.

Outils et intégrations communautaires

Au-delà de l’API locale brute, la communauté des développeurs a créé un riche écosystème d’outils qui encapsulent le protocole dans des packages plus accessibles. Cela va des bibliothèques Python pour l’écriture de scripts aux intégrations complètes avec les plateformes domotiques.

Bibliothèques Python

Si vous êtes à l’aise avec Python, plusieurs bibliothèques disponibles sur PyPI permettent de contrôler facilement le Pixoo-64 :

Bibliothèque Domaine d’intérêt Idéal pour
pixoo Fonctionnalités complètes : conversion d’images, interface REST, prise en charge des animations La plupart des développeurs débutants
APIxoo Wrapper d’API serveur pour le cloud Divoom Automatisation basée sur le cloud
pixoo-api Méthodes de manipulation du canevas Contrôle des pixels de bas niveau
Outils avancés Pixoo64 Ensemble d’outils enrichi avec des fonctionnalités avancées Utilisateurs avancés souhaitant des fonctionnalités supplémentaires

La bibliothèque pixoo est le point de départ le plus utilisé. Installez-la avec pip, connectez-vous à l’adresse IP de votre appareil et envoyez des données de pixels en quelques minutes. La bibliothèque se charge du travail fastidieux consistant à convertir des images en couleurs réelles en pixel art de 64x64 pixels, afin que vous puissiez vous concentrer sur ce que vous voulez afficher plutôt que sur la manière de formater les données.

Intégrations domotiques

Si votre objectif est d’intégrer le Pixoo-64 à une installation domotique plus vaste plutôt que d’écrire des scripts personnalisés, plusieurs plateformes disposent déjà d’intégrations développées par leur communauté :

Home Assistant est l’intégration la plus active. En utilisant la bibliothèque pixoo-rest comme passerelle, vous pouvez afficher des données de capteurs, des notifications, des événements de calendrier et du pixel art personnalisé déclenché par les automatisations de Home Assistant. Imaginez votre Pixoo-64 qui passe à une animation de pluie lorsque votre capteur météo détecte des précipitations, ou qui affiche une alerte « réunion dans 5 minutes » extraite de votre agenda Google.

Homey dispose d’une application Pixoo64 dédiée sur sa plateforme domotique, offrant des fonctionnalités d’automatisation similaires aux utilisateurs de Homey.

IFTTT connecte le Pixoo-64 à plus de 1 000 services pour automatiser des actions déclenchées par des événements. Aucun codage requis — vous configurez des déclencheurs (nouvel e-mail, mouvement détecté, publication Instagram) et des actions (afficher un contenu spécifique sur le Pixoo-64) grâce à l’interface visuelle d’IFTTT.

Lumia Stream mérite d’être mentionné pour les streamers et les créateurs de contenu. Il contrôle le Pixoo-64 pour les incrustations de streaming, les alertes du chat et les notifications de nouveaux abonnés pendant les diffusions en direct.

Comment choisir votre approche

Les trois options ne sont pas concurrentes — ce sont des couches. La plupart des utilisateurs les plus impliqués du Pixoo-64 finissent par combiner l’application avec au moins une autre méthode. Mais si vous débutez, voici comment choisir votre point de départ.

Commencez par l’application Divoom si :

  • Vous souhaitez créer du pixel art, parcourir la galerie communautaire ou configurer des widgets et des cadrans d’horloge
  • Vous ne souhaitez pas gérer les adresses IP, les commandes du terminal ou les fichiers de configuration
  • Vous avez besoin d’une assistance officielle et d’une stabilité garantie

Optez pour l’API locale si :

  • Vous souhaitez créer des scripts personnalisés qui envoient automatiquement des données à l’écran
  • Vous êtes à l’aise avec Python, les requêtes HTTP et les notions de base des réseaux
  • Vous développez quelque chose de spécifique — un tableau de bord, un visualiseur ou un système de notifications

Choisissez les outils communautaires si :

  • Vous utilisez déjà Home Assistant, Homey ou IFTTT et souhaitez ajouter le Pixoo-64 à vos automatisations existantes
  • Vous souhaitez automatiser sans écrire du code à partir de zéro (l’interface visuelle d’IFTTT s’en charge)
  • Vous êtes un streamer à la recherche d’une intégration de superposition en direct

Si vous hésitez encore, commencez par l’application. C’est le moyen le plus rapide de découvrir ce que le Pixoo-64 peut faire, et cela vous donne une base sur laquelle vous appuyer. L’API et les outils communautaires seront toujours là lorsque vous serez prêt à aller plus loin.

Votre première étape pour chaque solution

Solution via l’application : connectez-vous et explorez

Téléchargez l’application Divoom, connectez votre Pixoo-64 via Bluetooth et passez dix minutes à parcourir la galerie communautaire. Vous y trouverez des milliers de créations en pixel art, de cadrans d’horloge et d’animations réalisés par d’autres utilisateurs. Téléversez-en quelques-unes sur votre écran pour découvrir ce que le panneau de 64 × 64 pixels peut afficher. Pour les questions concernant l’installation matérielle, le manuel du produit explique la connexion physique et la configuration du Wi-Fi.

Solution API : installez-la et envoyez votre première image

Installez la bibliothèque Python pixoo sur votre ordinateur. Trouvez l’adresse IP de votre Pixoo-64 (consultez la liste des appareils connectés de votre routeur ou les informations de l’appareil dans l’application). Exécutez un script simple qui envoie une couleur unie à l’écran. Une fois cette opération réussie, vous aurez confirmé l’accès à l’API locale et pourrez commencer à créer des projets plus complexes.

Solution domotique : trouvez votre intégration

Si vous utilisez Home Assistant, recherchez le guide d’intégration du Pixoo-64 sur les forums de la communauté. La configuration consiste généralement à exécuter le conteneur Docker pixoo-rest et à configurer l’adresse IP de votre écran dans Home Assistant. Pour IFTTT, parcourez les applets Pixoo-64 disponibles et connectez un service que vous utilisez déjà. Ces deux solutions bénéficient de communautés actives prêtes à vous aider pour toute question de configuration.

Foire aux questions

L’API du Pixoo-64 est-elle un produit officiel de Divoom ?

Non. L’API HTTP locale utilisée par les développeurs a été rétroconçue par la communauté ; elle n’est ni documentée ni prise en charge officiellement par Divoom. La méthode de contrôle officielle est l’application Divoom. Les outils communautaires comme la bibliothèque Python pixoo, pixoo-rest et diverses intégrations domotiques sont maintenus par des développeurs indépendants. Ils fonctionnent bien, mais les mises à jour du micrologiciel peuvent parfois modifier le comportement de l’appareil.

Puis-je utiliser Python pour contrôler mon Pixoo-64 ?

Oui. L’option la plus populaire est la bibliothèque Python pixoo, disponible sur PyPI. Elle prend en charge Python 3.12, convertit automatiquement les images en pixel art de 64 × 64 pixels et inclut une interface REST intégrée. Parmi les autres options figurent APIxoo (pour l’accès à l’API cloud) et pixoo-api (pour le contrôle de bas niveau de la zone de dessin). Toutes sont maintenues par la communauté.

L’API locale fonctionne-t-elle avec les micrologiciels plus récents du Pixoo-64 ?

Cela dépend de la version spécifique du micrologiciel. D’après les retours de la communauté, certaines versions plus récentes du micrologiciel ont modifié les ports réseau ouverts, ce qui peut affecter l’accès à l’API locale. Avant de vous appuyer sur l’API pour un projet, testez la connectivité de base avec votre micrologiciel actuel. Les dépôts GitHub de pixoo-rest et de pixoo contiennent souvent des problèmes ouverts traitant du comportement propre à certaines versions du micrologiciel et des solutions de contournement.

Home Assistant peut-il afficher des données sur mon Pixoo-64 ?

Oui, grâce à une intégration maintenue par la communauté. La configuration habituelle utilise le conteneur Docker pixoo-rest comme passerelle entre Home Assistant et le Pixoo-64. Une fois configuré, vous pouvez déclencher l’affichage de pixel art en fonction des données de capteurs, d’événements du calendrier, d’automatisations et plus encore. Consultez les forums de la communauté Home Assistant pour obtenir le guide d’intégration et les informations de compatibilité les plus récents.

Dois-je être programmeur pour automatiser mon Pixoo-64 ?

Pas nécessairement. IFTTT propose une interface visuelle permettant de connecter le Pixoo-64 à plus de 1 000 services sans écrire de code. Vous créez des « applets » qui déclenchent des actions sur l’écran en fonction d’événements tels que de nouveaux e-mails, la détection de mouvements ou l’activité sur les réseaux sociaux. Home Assistant propose également des outils visuels de création d’automatisations, même si la configuration initiale nécessite davantage de connaissances techniques. L’application Divoom prend elle aussi en charge la programmation et les compteurs automatisés des réseaux sociaux, sans aucun codage.

Et maintenant ?

Le Pixoo-64 est l’un des écrans de pixel art les plus faciles à personnaliser du marché, grâce à sa connectivité Wi-Fi et à sa communauté active de développeurs. Que vous utilisiez l’application, écriviez votre premier script Python ou l’intégriez à votre maison connectée, l’écran devient bien plus qu’une décoration statique : il devient une toile programmable qui réagit à votre environnement.

Si vous n’avez pas encore de Pixoo-64 et souhaitez voir à quoi ressemble le panneau 64x64 installé sur un bureau, explorez la collection d’écrans pixel intelligents pour comparer les modèles. Si vous en avez déjà un et avez simplement besoin d’aide pour les bases — configuration du Wi-Fi, association Bluetooth ou configuration de l’application — consultez le manuel du produit pour obtenir des instructions détaillées, étape par étape.

Poursuivre l’apprentissage

Vous recherchez un écran doté de fonctionnalités API intégrées ? Découvrez le Times Gate — conçu pour les développeurs et les passionnés de tableaux de bord.

Pour la création générale de pixel art, consultez notre guide de l’application Divoom.

Pour en savoir plus sur notre méthode d’évaluation des produits Divoom, consultez notre page Comment nous testons.

Pixoo-64 + Home Assistant : créez un tableau de bord domotique en pixels App Guide Pixoo-64 + Home Assistant : créez un tableau de bord domotique en pixels Le Divoom Pixoo-64 est l’un des afficheurs les plus appréciés de la communauté Home Ass... Comment animer du pixel art pour un écran Divoom (guide image par image) animate pixel art divoom Comment animer du pixel art pour un écran Divoom (guide image par image) Apprenez à créer des animations en pixel art image par image pour votre écran Divoom. C... Guide du développeur de l’API Divoom Times Gate App Guide Guide du développeur de l’API Divoom Times Gate Guide destiné aux développeurs sur l’API Divoom Times Gate : découvrez comment l’écran ...
Retour au blog
Laisser un commentaire

Veuillez noter que les commentaires doivent être approuvés avant d'être publiés.