Você tem três maneiras de controlar um Pixoo-64: o aplicativo oficial Divoom, para criar sem código; uma API HTTP local, para desenvolvedores que querem controlar o dispositivo diretamente; e um ecossistema crescente de ferramentas da comunidade — bibliotecas Python, integrações com o Home Assistant e automações do IFTTT — que ficam em algum ponto intermediário. Cada caminho atende a objetivos e níveis de habilidade diferentes, e eles não são mutuamente excludentes. Você pode começar com o aplicativo, adicionar um script Python mais tarde e, por fim, integrar o display a um painel de casa inteligente.
Este guia apresenta os três métodos, explica para quem cada um é indicado e ajuda você a escolher o ponto de partida certo. Se você é iniciante, o caminho do aplicativo é tudo de que precisa. Se você é desenvolvedor ou entusiasta de casa inteligente, avance para as seções correspondentes à sua configuração.
Uma visão prática de como conectar o Pixoo 64 ao Home Assistant para controlar sua casa inteligente.
Os três caminhos de relance
Antes de entrar em cada método, veja uma comparação rápida para ajudar você a escolher. A maioria dos leitores seguirá imediatamente um dos caminhos, mas vale conferir os três — você pode descobrir uma opção que não sabia que existia.
| Método | Aplicativo Divoom | API HTTP local | Ferramentas da comunidade |
|---|---|---|---|
| Ideal para | Pixel art, galeria, widgets, contadores de redes sociais | Scripts personalizados, painéis de dados, automação | Casa inteligente, automação de eventos, Python |
| Nível de habilidade | Nenhum necessário | Desenvolvedor (noções básicas de redes) | De sem código a desenvolvedor |
| Suporte oficial | Sim | Somente comunidade | Somente comunidade |
| Tempo de configuração | 5–10 minutos | 30–60 minutos | 15–45 minutos |
A coluna “Suporte oficial” é importante. O aplicativo Divoom é o único caminho respaldado diretamente pela Divoom. A API local e as ferramentas da comunidade são desenvolvidas por programadores independentes que fizeram engenharia reversa do protocolo de comunicação entre o aplicativo e o display. Elas funcionam bem — muitas vezes de forma brilhante —, mas as atualizações de firmware podem ocasionalmente alterar a maneira como o dispositivo responde a solicitações personalizadas.
O aplicativo Divoom: seu ponto de partida sem código
O aplicativo Divoom é o método de controle padrão por um bom motivo. Ele se conecta ao Pixoo-64 via Bluetooth para edições rápidas e ao Wi‑Fi para recursos na nuvem, além de dar acesso a tudo o que o display pode fazer sem escrever uma única linha de código.
Dentro do aplicativo, você encontrará um editor de pixel art com modelos, uma galeria da comunidade com milhões de designs criados por usuários, mostradores de relógio personalizáveis, widgets de clima e contadores de seguidores em tempo real para YouTube, Twitch e Instagram. Você pode criar animações, programar conteúdo e gerenciar vários dispositivos na mesma conta.
Para quem é o aplicativo
Todo mundo. Se você acabou de tirar o Pixoo-64 da caixa e quer começar a criar pixel art, exibir fotos ou acompanhar o número de seguidores nas redes sociais, o aplicativo dá conta de tudo. Esse também é o caminho que a Divoom apoia e atualiza ativamente; portanto, se algo der errado, você tem um canal direto para obter ajuda.
Quando o aplicativo não é suficiente
O aplicativo se torna limitado quando você precisa de automação. Imagine que você queira que o Pixoo-64 exiba automaticamente a capa do álbum atual do Spotify, mostre o status do seu pipeline de CI/CD, seja atualizado com cotações de ações em tempo real ou reaja a dados de sensores de uma casa inteligente. Esses casos de uso exigem algo além da interação manual com o aplicativo — e é aí que entram os outros dois caminhos.
Dica de configuração
Baixe o aplicativo Divoom na App Store ou no Google Play antes de começar a explorar os caminhos da API abaixo. Até os desenvolvedores usam o aplicativo para configurar o Wi-Fi inicialmente e localizar dispositivos.
O caminho da API local: para desenvolvedores
O Pixoo-64 se comunica com o aplicativo Divoom pela sua rede Wi-Fi local usando solicitações HTTP. Desenvolvedores da comunidade fizeram engenharia reversa desse protocolo e documentaram os endpoints e formatos de payload necessários para enviar dados de pixel, trocar canais de exibição, ajustar o brilho e controlar animações diretamente — sem o aplicativo como intermediário.
Na prática, isso significa que você pode escrever um script no computador, enviar uma solicitação HTTP POST para o endereço IP do seu Pixoo-64 e acompanhar a atualização do display em tempo real. O dispositivo precisa estar conectado à mesma rede Wi-Fi que a máquina que envia a solicitação.
O que você pode criar
7|A API local permite criar projetos que o aplicativo, sozinho, não consegue executar:
- 6|Animações personalizadas de pixel art orientadas por dados externos (clima, ações, atividade no GitHub)
- 5|Capa do álbum reproduzido no Spotify exibida na sua mesa
- 4|Indicadores do status de compilação de CI/CD — verde para sucesso, vermelho para falha
- 3|Sistemas de notificação que enviam alertas para o display
- 2|Geradores de pixel art em time-lapse ou cronômetros regressivos para transmissões
1|Principais ferramentas da comunidade para a API local
Dois projetos se destacam como pontos de partida para desenvolvedores:
pixoo-rest é um wrapper de API RESTful criado sobre a biblioteca Python pixoo. Ele é executado no Docker, inclui uma interface do Swagger para testar endpoints e cuida da conversão de imagens automaticamente. Se você quer um servidor HTTP pronto que fique entre seus scripts e a tela, este é o caminho mais rápido.
pixoo (por SomethingWithComputers) é a biblioteca Python mais popular para comunicação direta com o Pixoo-64. Ela é compatível com Python 3.12, inclui uma interface REST integrada e oferece conversão automática de imagens — assim, você pode enviar qualquer arquivo de imagem e a biblioteca cuida da redução para pixel art de 64x64.
Limitações honestas
A API local não é um produto oficial da Divoom. Ela é mantida pela comunidade e foi obtida por engenharia reversa, o que significa:
- As atualizações de firmware podem alterar ou bloquear temporariamente o acesso à API. Membros da comunidade relataram que algumas versões mais recentes do firmware mudaram quais portas de rede ficam abertas.
- Você precisa encontrar o endereço IP do seu Pixoo-64 na rede local (o painel de administração do roteador ou a tela de informações do dispositivo no aplicativo Divoom podem ajudar).
- Não há um canal oficial de suporte da Divoom para problemas relacionados à API — os rastreadores de issues dos repositórios no GitHub e o subreddit r/Divoom são seus melhores recursos.
- O comportamento do protocolo pode variar entre o Pixoo-64 original e o modelo mais recente Pixoo-64 II.
Antes de explorar a API local, verifique a versão do firmware. Se o acesso local não funcionar no seu dispositivo, os repositórios da comunidade no GitHub geralmente têm issues abertas discutindo soluções alternativas específicas para cada versão do firmware.
Ferramentas e integrações da comunidade
Além da API local básica, a comunidade de desenvolvedores criou um rico ecossistema de ferramentas que encapsulam o protocolo em pacotes mais acessíveis. Elas vão de bibliotecas Python para scripts a integrações completas com plataformas de casa inteligente.
Bibliotecas Python
Se você se sente à vontade com Python, várias bibliotecas no PyPI facilitam o controle do Pixoo-64:
| Biblioteca | Foco | Ideal para |
|---|---|---|
| pixoo | Completa: conversão de imagens, interface REST, suporte a animações | A maioria dos desenvolvedores iniciantes |
| APIxoo | Wrapper da API do servidor para a nuvem Divoom | Automação baseada em nuvem |
| pixoo-api | Métodos de manipulação de tela | Controle de pixels em baixo nível |
| Ferramentas avançadas do Pixoo64 | Conjunto de ferramentas aprimorado com funcionalidades avançadas | Usuários avançados que desejam recursos extras |
A biblioteca pixoo é o ponto de partida mais usado. Instale-a com pip, conecte-se ao IP do seu dispositivo e, em poucos minutos, você estará enviando dados de pixels. A biblioteca cuida do trabalho tedioso de converter imagens coloridas em pixel art de 64x64 pixels, para que você possa se concentrar no que deseja exibir, em vez de se preocupar com a formatação dos dados.
Integrações de casa inteligente
Se o seu objetivo é integrar o Pixoo-64 a uma configuração mais ampla de casa inteligente, em vez de escrever scripts personalizados, várias plataformas já têm integrações desenvolvidas pela comunidade:
Home Assistant é a integração mais ativa. Usando a biblioteca pixoo-rest como ponte, você pode exibir dados de sensores, notificações, eventos do calendário e pixel art personalizada acionados por automações do Home Assistant. Imagine seu Pixoo-64 mudando para uma animação de chuva quando o sensor meteorológico detectar precipitação ou exibindo um alerta de "reunião em 5 minutos" obtido do seu Google Calendar.
Homey tem um aplicativo dedicado do Pixoo64 em sua plataforma de casa inteligente, oferecendo recursos de automação semelhantes para usuários do Homey.
IFTTT conecta o Pixoo-64 a mais de 1.000 serviços para automação baseada em eventos. Não é necessário programar — você configura gatilhos (novo e-mail, movimento detectado, publicação no Instagram) e ações (exibir conteúdo específico no Pixoo-64) pela interface visual do IFTTT.
Lumia Stream vale a pena ser mencionado para streamers e criadores de conteúdo. Ele controla o Pixoo-64 para sobreposições de transmissão, alertas do chat e notificações de novos seguidores durante transmissões ao vivo.
Como escolher seu caminho
Os três caminhos não competem entre si — eles são camadas. A maioria dos usuários mais ativos do Pixoo-64 acaba combinando o aplicativo com pelo menos um dos outros métodos. Mas, se você está começando agora, veja como escolher seu ponto de partida.
Comece pelo aplicativo Divoom se:
- Você quer criar pixel art, explorar a galeria da comunidade ou configurar widgets e mostradores de relógio
- Você não quer lidar com endereços IP, comandos de terminal ou arquivos de configuração
- Você precisa de suporte oficial e estabilidade garantida
Opte pela API Local se:
- Você quer criar scripts personalizados que enviem dados automaticamente para o display
- Você se sente à vontade com Python, requisições HTTP e conceitos básicos de rede
- Você está desenvolvendo algo específico — um painel, visualizador ou sistema de notificações
Escolha as Ferramentas da Comunidade se:
- Você já usa Home Assistant, Homey ou IFTTT e quer adicionar o Pixoo-64 às suas automações existentes
- Você quer automação sem escrever código do zero (a interface visual do IFTTT cuida disso)
- Você é um streamer procurando integração com sobreposição ao vivo
Se ainda estiver em dúvida, comece pelo aplicativo. É a maneira mais rápida de ver o que o Pixoo-64 pode fazer e oferece uma base para você começar. A API e as ferramentas da comunidade estarão sempre disponíveis quando você estiver pronto para se aprofundar.
Seu primeiro passo em cada caminho
Caminho do aplicativo: conecte-se e explore
Baixe o aplicativo Divoom, conecte-se ao seu Pixoo-64 via Bluetooth e passe dez minutos explorando a galeria da comunidade. Você encontrará milhares de designs de pixel art, mostradores de relógio e animações criados por outros usuários. Envie alguns para o seu display para ter uma ideia do que o painel de 64x64 pode exibir. Para dúvidas sobre a configuração do hardware, o manual do produto explica a conexão física e a configuração do Wi-Fi.
Caminho da API: instale e envie seu primeiro quadro
Instale a biblioteca Python pixoo no seu computador. Encontre o endereço IP do seu Pixoo-64 (consulte a lista de dispositivos conectados do seu roteador ou as informações do dispositivo no aplicativo). Execute um script simples que envie uma cor sólida para o display. Quando isso funcionar, você terá confirmado o acesso à API local — e poderá começar a criar projetos mais complexos a partir daí.
Caminho da casa inteligente: encontre sua integração
Se você usa o Home Assistant, pesquise nos fóruns da comunidade o guia de integração do Pixoo-64. A configuração normalmente envolve executar o contêiner Docker pixoo-rest e configurar o endereço IP do seu display no Home Assistant. Para o IFTTT, explore os applets disponíveis para o Pixoo-64 e conecte um serviço que você já usa. Ambas as opções têm comunidades ativas prontas para ajudar com dúvidas de configuração.
Perguntas frequentes
A API do Pixoo-64 é um produto oficial da Divoom?
Não. A API HTTP local usada por desenvolvedores foi criada por engenharia reversa pela comunidade e não é documentada nem compatível oficialmente pela Divoom. O método oficial de controle é o aplicativo Divoom. Ferramentas da comunidade, como a biblioteca Python pixoo, o pixoo-rest e várias integrações para casas inteligentes, são mantidas por desenvolvedores independentes. Elas funcionam bem, mas atualizações de firmware podem ocasionalmente alterar o comportamento do dispositivo.
Posso usar Python para controlar meu Pixoo-64?
Sim. A opção mais popular é a biblioteca Python pixoo, disponível no PyPI. Ela é compatível com o Python 3.12, converte imagens automaticamente em pixel art de 64x64 pixels e inclui uma interface REST integrada. Outras opções incluem a APIxoo (para acesso à API na nuvem) e a pixoo-api (para controle de baixo nível do canvas). Todas são mantidas pela comunidade.
A API local funciona em firmwares mais recentes do Pixoo-64?
Depende da versão específica do firmware. Relatos da comunidade indicam que algumas versões mais recentes do firmware alteraram quais portas de rede ficam abertas, o que pode afetar o acesso à API local. Antes de depender da API em um projeto, teste a conectividade básica com o firmware atual. Os repositórios do GitHub do pixoo-rest e do pixoo frequentemente têm problemas em aberto que discutem comportamentos específicos de cada firmware e possíveis soluções alternativas.
O Home Assistant pode exibir dados no meu Pixoo-64?
Sim, por meio de uma integração mantida pela comunidade. A configuração típica usa o contêiner Docker pixoo-rest como ponte entre o Home Assistant e o Pixoo-64. Depois de configurado, você pode acionar exibições de pixel art com base em dados de sensores, eventos do calendário, automações e muito mais. Consulte os fóruns da comunidade do Home Assistant para obter o guia de integração mais recente e observações sobre compatibilidade.
Preciso ser programador para automatizar meu Pixoo-64?
Não necessariamente. O IFTTT oferece uma interface visual para conectar o Pixoo-64 a mais de 1.000 serviços sem escrever código. Você cria “applets” que acionam ações na tela com base em eventos como novos e-mails, detecção de movimento ou atividades nas redes sociais. O Home Assistant também oferece criadores visuais de automações, embora a configuração inicial exija mais conhecimento técnico. O próprio aplicativo Divoom também oferece suporte a agendamento e contadores automatizados de redes sociais, sem necessidade de programação.
O que fazer em seguida
O Pixoo-64 é uma das telas de pixel art mais fáceis de personalizar do mercado, graças à conectividade Wi-Fi e à comunidade ativa de desenvolvedores ao seu redor. Seja usando apenas o aplicativo, escrevendo seu primeiro script em Python ou integrando-o à sua casa inteligente, a tela se torna mais do que uma decoração estática — transforma-se em uma tela programável que responde ao seu mundo.
Se você ainda não tem um Pixoo-64 e quer ver como é o painel de 64x64 em uma configuração de mesa, explore a coleção de telas de pixel inteligentes para comparar os modelos. Se você já tem um e só precisa de ajuda com o básico — configuração do Wi-Fi, pareamento Bluetooth ou configuração do aplicativo — consulte o manual do produto para obter orientações passo a passo.
Continue aprendendo
Procurando uma tela com recursos de API integrados? Confira o Times Gate — desenvolvido para desenvolvedores e entusiastas de painéis.
Para criação de pixel art em geral, consulte nosso guia do aplicativo Divoom.
Para saber mais sobre como avaliamos os produtos Divoom, consulte nossa página Como testamos.
