Guía para principiantes de la API de Divoom Pixoo-64

Guía para principiantes de la API de Divoom Pixoo-64

Tienes tres formas de controlar un Pixoo-64: la aplicación oficial de Divoom para crear sin código, una API HTTP local para desarrolladores que quieren controlar directamente el dispositivo y un ecosistema cada vez mayor de herramientas comunitarias —bibliotecas de Python, integraciones con Home Assistant y automatizaciones de IFTTT— que se sitúan en un punto intermedio. Cada opción se adapta a objetivos y niveles de conocimientos distintos, y no son mutuamente excluyentes. Puedes empezar con la aplicación, añadir después un script de Python y, finalmente, conectar la pantalla a un panel de hogar inteligente.

Esta guía explica los tres métodos, indica para quién es cada uno y te ayuda a elegir el punto de partida adecuado. Si eres principiante, con la aplicación es suficiente. Si eres desarrollador o entusiasta del hogar inteligente, ve directamente a las secciones que correspondan a tu configuración.

Una guía práctica para conectar el Pixoo 64 a Home Assistant y controlarlo como parte de tu hogar inteligente.

Las tres opciones de un vistazo

Antes de entrar en cada método, aquí tienes una comparación rápida que te ayudará a elegir. La mayoría de los lectores se decantará de inmediato por una opción, pero vale la pena revisar las tres: quizá descubras una opción que no sabías que existía.

Método Aplicación de Divoom API HTTP local Herramientas de la comunidad
Ideal para Pixel art, galería, widgets, contadores de redes sociales Scripts personalizados, paneles de datos, automatización Hogar inteligente, automatización de eventos, Python
Nivel de conocimientos No se requiere ninguna Desarrollador (nociones básicas de redes) De usuario sin conocimientos de código a desarrollador
Compatibilidad oficial x Solo la comunidad x Solo la comunidad
Tiempo de configuración 5–10 minutos 30–60 minutos 15–45 minutos

La columna «Compatibilidad oficial» es importante. La aplicación de Divoom es la única vía respaldada directamente por Divoom. La API local y las herramientas de la comunidad han sido creadas por desarrolladores independientes que sometieron a ingeniería inversa el protocolo de comunicación entre la aplicación y la pantalla. Funcionan bien —a menudo de forma excelente—, pero las actualizaciones del firmware pueden cambiar ocasionalmente la forma en que el dispositivo responde a solicitudes personalizadas.

La aplicación de Divoom: tu punto de partida sin código

La aplicación de Divoom es el método de control predeterminado por una buena razón. Se conecta al Pixoo-64 mediante Bluetooth para realizar ediciones rápidas y mediante Wi‑Fi para las funciones en la nube, y te da acceso a todo lo que la pantalla puede hacer sin escribir una sola línea de código.

Dentro de la aplicación encontrarás un editor de pixel art con plantillas, una galería comunitaria con millones de diseños creados por usuarios, esferas de reloj personalizables, widgets del tiempo y contadores de seguidores en redes sociales en tiempo real para YouTube, Twitch e Instagram. Puedes crear animaciones, programar contenido y gestionar varios dispositivos desde la misma cuenta.

Para quién es la aplicación

Todos. Si acabas de sacar tu Pixoo-64 de la caja y quieres empezar a crear pixel art, mostrar fotos o hacer un seguimiento de tus seguidores en redes sociales, la aplicación se encarga de todo. Además, es la ruta que Divoom admite y actualiza activamente, así que, si algo sale mal, tienes un canal directo para recibir ayuda.

Cuando la aplicación no es suficiente

La aplicación se vuelve limitada cuando necesitas automatización. Por ejemplo, quizá quieras que tu Pixoo-64 muestre automáticamente la carátula del álbum de Spotify que estás escuchando, indique el estado de tu canalización de CI/CD, se actualice con los precios de las acciones en tiempo real o reaccione a los datos de sensores de un hogar inteligente. Estos casos de uso requieren algo más que la interacción manual con la aplicación, y ahí es donde entran las otras dos rutas.

Pantalla de pixel art Divoom Pixoo-64 que muestra personajes de videojuegos junto a una configuración gaming con dos monitores
El Pixoo-64 se coloca naturalmente junto a un monitor gaming, mostrando pixel art que complementa la configuración del escritorio.

Consejo de configuración

Descarga la aplicación Divoom desde App Store o Google Play antes de comenzar a explorar las rutas de la API que aparecen a continuación. Incluso los desarrolladores usan la aplicación para configurar inicialmente la conexión WiFi y detectar el dispositivo.

La ruta de la API local: para desarrolladores

El Pixoo-64 se comunica con la aplicación Divoom a través de tu red WiFi local mediante solicitudes HTTP. Los desarrolladores de la comunidad han realizado ingeniería inversa de este protocolo y han documentado los endpoints y formatos de carga útil necesarios para enviar datos de píxeles, cambiar de canal de visualización, ajustar el brillo y controlar animaciones directamente, sin que la aplicación actúe como intermediaria.

En la práctica, esto significa que puedes escribir un script en tu computadora, enviar una solicitud HTTP POST a la dirección IP de tu Pixoo-64 y ver cómo la pantalla se actualiza en tiempo real. El dispositivo debe estar conectado a la misma red WiFi que el equipo que envía la solicitud.

Lo que puedes crear

La API local permite crear proyectos que la aplicación por sí sola no puede gestionar:

  • Animaciones de pixel art personalizadas impulsadas por datos externos (clima, acciones, actividad de GitHub)
  • Carátulas de álbumes de Spotify reproduciéndose en ese momento, mostradas en tu escritorio
  • Indicadores del estado de compilación de CI/CD: verde si pasa, rojo si falla
  • Sistemas de notificaciones que envían alertas a la pantalla
  • Generadores de pixel art en time-lapse o temporizadores de cuenta regresiva para transmisiones

Herramientas comunitarias clave para la API local

Dos proyectos destacan como puntos de partida para desarrolladores:

pixoo-rest es un envoltorio de API RESTful creado sobre la biblioteca de Python pixoo. Se ejecuta en Docker, incluye una interfaz de Swagger para probar los endpoints y gestiona automáticamente la conversión de imágenes. Si quieres un servidor HTTP listo para usar que se sitúe entre tus scripts y la pantalla, este es el camino más rápido.

pixoo (de SomethingWithComputers) es la biblioteca de Python más popular para la comunicación directa con Pixoo-64. Es compatible con Python 3.12, incluye una interfaz REST integrada y ofrece conversión automática de imágenes; así puedes enviar cualquier archivo de imagen y la biblioteca se encarga de reducirlo a pixel art de 64x64.

Limitaciones explicadas con franqueza

La API local no es un producto oficial de Divoom. La mantiene la comunidad y ha sido creada mediante ingeniería inversa, lo que significa que:

  • Las actualizaciones del firmware pueden cambiar el acceso a la API o bloquearlo temporalmente. Los miembros de la comunidad han informado de que algunas versiones de firmware más recientes cambiaron qué puertos de red están abiertos.
  • Debes encontrar la dirección IP de tu Pixoo-64 en tu red local; pueden ayudarte el panel de administración de tu router o la pantalla de información del dispositivo en la aplicación de Divoom.
  • No existe un canal oficial de asistencia de Divoom para problemas relacionados con la API; los rastreadores de incidencias de los repositorios de GitHub y el subreddit r/Divoom son tus mejores recursos.
  • El comportamiento del protocolo puede variar entre el Pixoo-64 original y el modelo Pixoo-64 II más reciente.

Antes de profundizar en la API local, comprueba la versión de tu firmware. Si el acceso local no funciona en tu dispositivo, los repositorios de la comunidad en GitHub suelen tener incidencias abiertas donde se analizan soluciones alternativas específicas para cada versión del firmware.

Herramientas e integraciones de la comunidad

Más allá de la API local sin procesar, la comunidad de desarrolladores ha creado un amplio ecosistema de herramientas que encapsulan el protocolo en paquetes más accesibles. Estas van desde bibliotecas de Python para crear scripts hasta integraciones completas con plataformas de hogares inteligentes.

Bibliotecas de Python

Si te sientes cómodo con Python, varias bibliotecas de PyPI facilitan el control de Pixoo-64:

Biblioteca Enfoque Ideal para
pixoo Completa: conversión de imágenes, interfaz REST y compatibilidad con animaciones Para la mayoría de los desarrolladores que están comenzando
APIxoo Envoltorio de la API del servidor para la nube de Divoom Automatización basada en la nube
pixoo-api Métodos de manipulación del lienzo Control de píxeles de bajo nivel
Herramientas avanzadas de Pixoo64 Conjunto de herramientas mejorado con funcionalidades avanzadas Para usuarios avanzados que quieren funciones adicionales

La biblioteca pixoo es el punto de partida más utilizado. Instálala con pip, conéctate a la IP de tu dispositivo y podrás enviar datos de píxeles en cuestión de minutos. La biblioteca se encarga del tedioso trabajo de convertir imágenes a todo color en pixel art de 64x64 píxeles, para que puedas concentrarte en lo que quieres mostrar en lugar de preocuparte por cómo dar formato a los datos.

Integraciones para el hogar inteligente

Si tu objetivo es integrar el Pixoo-64 en una configuración de hogar inteligente más amplia en lugar de escribir scripts personalizados, varias plataformas ya cuentan con integraciones desarrolladas por la comunidad:

Home Assistant es la integración más activa. Mediante la biblioteca pixoo-rest como puente, puedes mostrar datos de sensores, notificaciones, eventos del calendario y pixel art personalizado activado por automatizaciones de Home Assistant. Imagina que tu Pixoo-64 cambia a una animación de lluvia cuando el sensor meteorológico detecta precipitaciones o muestra una alerta de «reunión en 5 minutos» obtenida de tu Google Calendar.

Homey cuenta con una aplicación específica para Pixoo64 en su plataforma de hogar inteligente, que ofrece capacidades de automatización similares para los usuarios de Homey.

IFTTT conecta el Pixoo-64 con más de 1.000 servicios para automatizar acciones basadas en eventos. No requiere programación: configuras activadores (un correo nuevo, movimiento detectado o una publicación de Instagram) y acciones (mostrar contenido específico en el Pixoo-64) mediante la interfaz visual de IFTTT.

Lumia Stream merece una mención para streamers y creadores de contenido. Controla el Pixoo-64 para superposiciones de streaming, alertas del chat y notificaciones de nuevos seguidores durante las transmisiones en directo.

Cómo elegir tu opción

Las tres opciones no compiten entre sí, sino que son capas. La mayoría de los usuarios más activos del Pixoo-64 terminan combinando la aplicación con al menos otro método. Pero si acabas de empezar, así puedes elegir tu punto de entrada.

Empieza con la aplicación Divoom si:

  • Quieres crear pixel art, explorar la galería de la comunidad o configurar widgets y esferas de reloj
  • No quieres lidiar con direcciones IP, comandos de terminal ni archivos de configuración
  • Necesitas asistencia oficial y estabilidad garantizada

Opta por la API local si:

  • Quieres crear scripts personalizados que envíen datos automáticamente a la pantalla
  • Te sientes cómodo con Python, las solicitudes HTTP y los conceptos básicos de redes
  • Estás creando algo específico: un panel, un visualizador o un sistema de notificaciones

Elige Herramientas de la comunidad si:

  • Ya utilizas Home Assistant, Homey o IFTTT y quieres añadir el Pixoo-64 a tus automatizaciones existentes
  • Quieres automatizar sin escribir código desde cero (la interfaz visual de IFTTT se encarga de ello)
  • Eres streamer y buscas una integración de superposición en directo

Si aún no estás seguro, empieza por la aplicación. Es la forma más rápida de ver lo que puede hacer el Pixoo-64 y te proporciona una base sobre la que construir. La API y las herramientas de la comunidad estarán siempre disponibles cuando quieras profundizar.

Tu primer paso en cada ruta

Ruta de la aplicación: conecta y explora

Descarga la aplicación de Divoom, conecta tu Pixoo-64 por Bluetooth y dedica diez minutos a explorar la galería de la comunidad. Encontrarás miles de diseños de pixel art, esferas de reloj y animaciones creados por otros usuarios. Sube algunos a tu pantalla para familiarizarte con lo que puede mostrar el panel de 64x64. Para dudas sobre la configuración del hardware, el manual del producto explica la conexión física y la configuración de WiFi.

Ruta de la API: instala y envía tu primer fotograma

Instala la biblioteca de Python pixoo en tu ordenador. Encuentra la dirección IP de tu Pixoo-64 (consulta la lista de dispositivos conectados de tu router o la información del dispositivo en la aplicación). Ejecuta un script sencillo que envíe un color sólido a la pantalla. Cuando funcione, habrás confirmado el acceso a la API local y podrás empezar a crear proyectos más complejos.

Ruta de hogar inteligente: encuentra tu integración

Si usas Home Assistant, busca en los foros de la comunidad la guía de integración del Pixoo-64. La configuración normalmente implica ejecutar el contenedor Docker pixoo-rest y configurar la dirección IP de tu pantalla en Home Assistant. Para IFTTT, explora los applets disponibles para Pixoo-64 y conecta un servicio que ya utilices. Ambas opciones cuentan con comunidades activas dispuestas a ayudar con las dudas de configuración.

Preguntas frecuentes

¿La API del Pixoo-64 es un producto oficial de Divoom?

No. La API HTTP local que usan los desarrolladores ha sido sometida a ingeniería inversa por la comunidad; Divoom no la documenta ni ofrece soporte oficial para ella. El método de control oficial es la aplicación de Divoom. Herramientas comunitarias como la biblioteca de Python pixoo, pixoo-rest y diversas integraciones para hogares inteligentes reciben mantenimiento de desarrolladores independientes. Funcionan bien, pero las actualizaciones del firmware pueden cambiar ocasionalmente el comportamiento del dispositivo.

¿Puedo usar Python para controlar mi Pixoo-64?

Sí. La opción más popular es la biblioteca de Python pixoo, disponible en PyPI. Es compatible con Python 3.12, gestiona la conversión automática de imágenes a pixel art de 64x64 píxeles e incluye una interfaz REST integrada. Otras opciones son APIxoo (para acceder a la API en la nube) y pixoo-api (para controlar el lienzo a bajo nivel). Todas reciben mantenimiento de la comunidad.

¿La API local funciona con el firmware más reciente del Pixoo-64?

Depende de la versión específica del firmware. Los informes de la comunidad indican que algunas versiones de firmware más recientes han cambiado los puertos de red que están abiertos, lo que puede afectar al acceso a la API local. Antes de depender de la API para un proyecto, prueba la conectividad básica con tu firmware actual. Los repositorios de GitHub de pixoo-rest y pixoo suelen tener incidencias abiertas en las que se analizan comportamientos específicos del firmware y posibles soluciones.

¿Puede Home Assistant mostrar datos en mi Pixoo-64?

Sí, mediante una integración mantenida por la comunidad. La configuración habitual utiliza el contenedor Docker pixoo-rest como puente entre Home Assistant y el Pixoo-64. Una vez configurado, puedes activar pantallas de arte pixelado basadas en datos de sensores, eventos del calendario, automatizaciones y mucho más. Consulta los foros de la comunidad de Home Assistant para obtener la guía de integración más reciente y las notas de compatibilidad.

¿Necesito ser programador para automatizar mi Pixoo-64?

No necesariamente. IFTTT ofrece una interfaz visual para conectar el Pixoo-64 con más de 1.000 servicios sin escribir código. Puedes crear «applets» que activen acciones de la pantalla en respuesta a eventos como nuevos correos electrónicos, detección de movimiento o actividad en redes sociales. Home Assistant también ofrece herramientas visuales para crear automatizaciones, aunque la configuración inicial requiere más conocimientos técnicos. La propia aplicación Divoom también permite programar horarios y automatizar contadores de redes sociales sin necesidad de programar.

Adónde ir después

El Pixoo-64 es una de las pantallas de arte pixelado más fáciles de modificar del mercado gracias a su conectividad Wi‑Fi y a la activa comunidad de desarrolladores que lo rodea. Tanto si sigues usando la aplicación como si escribes tu primer script de Python o lo integras en tu hogar inteligente, la pantalla se convierte en algo más que una decoración estática: se convierte en un lienzo programable que responde a tu mundo.

Si aún no tienes un Pixoo-64 y quieres ver cómo luce el panel de 64x64 en un escritorio, explora la colección de pantallas inteligentes de píxeles para comparar modelos. Si ya tienes uno y solo necesitas ayuda con los aspectos básicos —configuración de Wi‑Fi, emparejamiento por Bluetooth o configuración de la aplicación—, consulta el manual del producto para obtener instrucciones paso a paso.

Sigue aprendiendo

¿Buscas una pantalla con funciones de API integradas? Echa un vistazo a Times Gate, diseñada para desarrolladores y entusiastas de los paneles de control.

Para la creación general de arte pixelado, consulta nuestra guía de la aplicación Divoom.

Para obtener más información sobre cómo evaluamos los productos Divoom, consulta nuestra página Cómo hacemos las pruebas.

Pixoo-64 + Home Assistant: Crea un panel inteligente para el hogar con píxeles App Guide Pixoo-64 + Home Assistant: Crea un panel inteligente para el hogar con píxeles El Divoom Pixoo-64 es una de las pantallas más apreciadas por la comunidad de Home Assi... Cómo animar pixel art para una pantalla Divoom (guía fotograma a fotograma) animate pixel art divoom Cómo animar pixel art para una pantalla Divoom (guía fotograma a fotograma) Aprende a crear animaciones de pixel art fotograma a fotograma para tu pantalla Divoom.... Guía para desarrolladores de la API de Divoom Times Gate App Guide Guía para desarrolladores de la API de Divoom Times Gate Una guía para desarrolladores sobre la API de Divoom Times Gate: cómo se comunica la pa...
Volver al blog
Deja un comentario

Tenga en cuenta que los comentarios deben ser aprobados antes de ser publicados.