Pixoo-64を操作する方法は3つあります。コード不要で創作を楽しめる公式Divoomアプリ、デバイスを直接制御したい開発者向けのローカルHTTP API、そしてPythonライブラリ、Home Assistant連携、IFTTT自動化など、両者の中間に位置する成長中のコミュニティツール群です。それぞれの方法は異なる目的やスキルレベルに適しており、相互に排他的ではありません。まずアプリから始め、後でPythonスクリプトを追加し、最終的にはディスプレイをスマートホームのダッシュボードに組み込むこともできます。
このガイドでは3つの方法をすべて取り上げ、それぞれがどんな人に向いているかを説明し、適切なスタート地点を選べるようにします。完全な初心者なら、アプリを使う方法だけで十分です。開発者やスマートホーム愛好家なら、自分の環境に合うセクションへ進んでください。
Pixoo 64をスマートホーム制御のためにHome Assistantへ接続する実践ガイドです。
3つの方法を一覧で比較
各方法を詳しく見ていく前に、自分に合うものを選ぶための簡単な比較をご紹介します。多くの読者はすぐに1つの方法に決めるでしょうが、3つすべてに目を通す価値はあります。知らなかった選択肢が見つかるかもしれません。
| 方法 | Divoomアプリ | ローカルHTTP API | コミュニティツール |
|---|---|---|---|
| おすすめの用途 | ドット絵、ギャラリー、ウィジェット、SNSカウンター | カスタムスクリプト、データダッシュボード、自動化 | スマートホーム、イベント自動化、Python |
| スキルレベル | 不要 | 開発者（ネットワークの基礎） | ノーコードから開発者向けまで |
| 公式サポート | あり | コミュニティのみ | コミュニティのみ |
| セットアップ時間 | 5～10分 | 30～60分 | 15～45分 |
「公式サポート」列は重要です。Divoomが直接サポートしている唯一の方法は、Divoomアプリです。ローカルAPIやコミュニティツールは、アプリとディスプレイ間の通信プロトコルをリバースエンジニアリングした独立開発者によって作られています。これらはうまく、しばしば非常に優れた動作をしますが、ファームウェアの更新によって、デバイスがカスタムリクエストに応答する方法が変わることがあります。
Divoomアプリ：ゼロコードで始める方法
Divoomアプリがデフォルトの操作方法なのには、確かな理由があります。BluetoothでPixoo-64に接続して素早く編集でき、WiFi経由でクラウド機能を利用できます。また、コードを1行も書かずにディスプレイのすべての機能にアクセスできます。
アプリ内には、テンプレート付きのドット絵エディター、数百万件のユーザー作成デザインが集まるコミュニティギャラリー、カスタマイズ可能な時計盤、天気ウィジェット、YouTube、Twitch、InstagramのリアルタイムSNSフォロワー数カウンターがあります。アニメーションの作成やコンテンツの予約、同じアカウントからの複数デバイス管理も可能です。
アプリの対象者
すべての人。Pixoo-64を箱から出したばかりで、ピクセルアートの作成、写真の表示、ソーシャルメディアのフォロワー数の追跡を始めたいだけなら、アプリですべて対応できます。また、Divoomが積極的にサポートとアップデートを行っている方法でもあるため、問題が発生した場合は直接サポートを受けられます。
アプリだけでは不十分な場合
自動化が必要になると、アプリには限界があります。たとえば、Pixoo-64に現在再生中のSpotifyのアルバムアートを自動表示したり、CI/CDパイプラインのステータスを表示したり、リアルタイムの株価で更新したり、スマートホームのセンサーデータに反応させたりしたい場合です。こうした用途には手動でアプリを操作する以上の仕組みが必要であり、そこで残り2つの方法が役立ちます。
セットアップのヒント
APIの各種パスを試す前に、App StoreまたはGoogle PlayからDivoomアプリをダウンロードしてください。開発者であっても、初回のWiFi設定とデバイスの検出にはこのアプリを使用します。
ローカルAPIの道筋：開発者向け
Pixoo-64は、HTTPリクエストを使ってローカルWiFiネットワーク経由でDivoomアプリと通信します。コミュニティの開発者たちはこのプロトコルをリバースエンジニアリングし、ピクセルデータの送信、表示チャンネルの切り替え、明るさの調整、アニメーションの直接制御に必要なエンドポイントとペイロード形式を文書化しています。アプリを仲介として使う必要はありません。
実際には、パソコン上でスクリプトを記述し、Pixoo-64のIPアドレスにHTTP POSTリクエストを送信すると、ディスプレイがリアルタイムで更新されます。リクエストを送信するマシンとデバイスは、同じWiFiネットワークに接続されている必要があります。
開発できるもの
ローカルAPIにより、アプリだけでは対応できないプロジェクトを開発できます。
- 外部データ（天気、株価、GitHubのアクティビティ）を利用したカスタム・ピクセルアートアニメーション
- デスクに表示するSpotifyの再生中アルバムアート
- CI/CDのビルドステータスインジケーター — 成功時は緑、失敗時は赤
- ディスプレイにアラートをプッシュする通知システム
- ストリーミング用のタイムラプス・ピクセルアート生成ツールやカウントダウンタイマー
ローカルAPI向けの主要なコミュニティツール
開発者の出発点として特に注目すべきプロジェクトは、次の2つです。
pixoo-restは、pixoo Pythonライブラリ上に構築されたRESTful APIラッパーです。Dockerで実行でき、エンドポイントのテスト用にSwagger UIを備えており、画像変換も自動的に処理します。スクリプトとディスプレイの間に置く、すぐに使えるHTTPサーバーが必要なら、これが最も早い方法です。
pixoo（SomethingWithComputers製）は、Pixoo-64と直接通信するための最も人気のあるPythonライブラリです。Python 3.12に対応し、組み込みのRESTインターフェースを備えているほか、画像を自動変換できます。任意の画像ファイルを送信でき、ライブラリがピクセルアートへの縮小変換を64x64で処理してくれます。
正直な制限事項
ローカルAPIはDivoomの公式製品ではありません。コミュニティによって保守され、リバースエンジニアリングされたものです。そのため、次のような制限があります。
- ファームウェアのアップデートによって、APIへのアクセスが変更されたり、一時的にブロックされたりすることがあります。コミュニティでは、一部の新しいファームウェアバージョンで、開放されているネットワークポートが変更されたと報告されています。
- ローカルネットワーク上のPixoo-64のIPアドレスを確認する必要があります（ルーターの管理画面や、Divoomアプリのデバイス情報画面が役立ちます）。
- API関連の問題について、Divoomには公式サポート窓口がありません。最も頼りになる情報源は、GitHubリポジトリのIssueトラッカーとr/Divoomサブレディットです。
- プロトコルの動作は、初代Pixoo-64と新しいPixoo-64 IIモデルで異なる場合があります。
ローカルAPIを詳しく調べる前に、ファームウェアのバージョンを確認してください。デバイスでローカルアクセスが機能しない場合は、GitHubのコミュニティリポジトリで、ファームウェア固有の回避策について議論されている未解決のIssueを確認するとよいでしょう。
コミュニティツールと統合
低レベルのローカルAPIに加えて、開発者コミュニティは、プロトコルをより使いやすいパッケージでラップした豊富なエコシステムを構築しています。Pythonによるスクリプト用ライブラリから、スマートホームプラットフォームとの完全な統合まで、さまざまなものがあります。
Pythonライブラリ
Pythonに慣れているなら、PyPIにはPixoo-64を簡単に制御できるライブラリがいくつかあります。
| ライブラリ | 焦点 | 最適な用途 |
|---|---|---|
| pixoo | フル機能：画像変換、RESTインターフェース、アニメーション対応 | 使い始めたばかりの開発者の多くに最適 |
| APIxoo | Divoomクラウド用サーバーAPIラッパー | クラウドベースの自動化 |
| pixoo-api | キャンバス操作メソッド | 低レベルのピクセル制御 |
| Pixoo64 Advanced Tools | 高度な機能を備えた拡張ツールセット | 追加機能を求めるパワーユーザー向け |
pixooライブラリは、最も広く使われている出発点です。pipでインストールし、デバイスのIPアドレスに接続すれば、数分でピクセルデータを送信できます。このライブラリは、フルカラー画像を64x64ピクセルのアートに変換する面倒な作業を処理してくれるため、データのフォーマット方法ではなく、何を表示するかに集中できます。
スマートホーム連携機能
カスタムスクリプトを書くのではなく、Pixoo-64をより広範なスマートホーム環境に組み込みたい場合、すでにいくつかのプラットフォームがコミュニティ開発の連携機能を提供しています。
Home Assistantは最も活発な連携です。橋渡し役としてpixoo-restライブラリを使うことで、Home Assistantの自動化をトリガーに、センサーデータ、通知、カレンダーイベント、カスタムピクセルアートを表示できます。天気センサーが降水を検知したときにPixoo-64が雨のアニメーションへ切り替わったり、Googleカレンダーから取得した「5分後に会議があります」というアラートを表示したりする様子を想像してみてください。
Homeyはスマートホームプラットフォーム内に専用のPixoo64アプリを用意しており、Homeyユーザー向けに同様の自動化機能を提供します。
IFTTTは、イベント駆動型の自動化によりPixoo-64を1,000以上のサービスに接続します。コーディングは不要です。IFTTTのビジュアルインターフェースで、トリガー（新着メール、動体検知、Instagramへの投稿）とアクション（Pixoo-64に特定のコンテンツを表示）を設定します。
Lumia Streamは、ストリーマーやコンテンツクリエイターにとって注目に値します。ライブ配信中のストリーミングオーバーレイ、チャットアラート、フォロワー通知向けにPixoo-64を操作できます。
方法の選び方
この3つの方法は競合するものではなく、それぞれが異なるレイヤーです。Pixoo-64を積極的に活用するユーザーの多くは、最終的にアプリと少なくとも1つの別の方法を組み合わせています。ただし、始めたばかりなら、次のように入口を選ぶとよいでしょう。
次のような場合はまずDivoomアプリから始めましょう：
- ピクセルアートを作成したり、コミュニティギャラリーを閲覧したり、ウィジェットや時計盤を設定したい
- IPアドレス、ターミナルコマンド、設定ファイルを扱いたくない
- 公式サポートと安定性の保証が必要
次のような場合はローカルAPIを利用しましょう：
- ディスプレイにデータを自動的に送信するカスタムスクリプトを作りたい
- Python、HTTPリクエスト、基本的なネットワーク操作に慣れている
- ダッシュボード、ビジュアライザー、通知システムなど、特定のものを構築している
次のような場合はコミュニティツールを選びましょう：
- すでにHome Assistant、Homey、またはIFTTTを使っていて、既存の自動化にPixoo-64を追加したい
- コードをゼロから書かずに自動化したい（IFTTTのビジュアルインターフェースなら対応できます）
- ライブオーバーレイ連携を探しているストリーマーの方
まだ迷っている場合は、まずアプリから始めてください。Pixoo-64でできることを確認する最も手早い方法であり、その経験を基盤にして次の段階へ進めます。さらに深く取り組みたくなったときには、APIとコミュニティツールをいつでも利用できます。
それぞれの道で最初に行うこと
アプリへの道：接続して探索する
Divoomアプリをダウンロードし、Bluetooth経由でPixoo-64に接続して、コミュニティギャラリーを10分ほど見てみましょう。他のユーザーが作成したドット絵デザイン、時計盤、アニメーションが数千点見つかります。いくつかをディスプレイにアップロードして、64×64パネルでどのような表示ができるか確認してください。ハードウェアの設定については、製品マニュアルで物理的な接続とWi-Fi設定を確認できます。
APIへの道：インストールして最初のフレームを送信する
パソコンにpixoo Pythonライブラリをインストールします。Pixoo-64のIPアドレスを確認します（ルーターの接続デバイス一覧またはアプリのデバイス情報を確認してください）。ディスプレイに単色を送信する簡単なスクリプトを実行します。正常に動作すれば、ローカルAPIにアクセスできることを確認でき、そこからさらに複雑なプロジェクトを構築できます。
スマートホームへの道：連携機能を見つける
Home Assistantを使用している場合は、コミュニティフォーラムでPixoo-64の連携ガイドを検索してください。通常、pixoo-restのDockerコンテナを実行し、Home AssistantでディスプレイのIPアドレスを設定します。IFTTTの場合は、利用可能なPixoo-64アプレットを参照し、すでに使用しているサービスに接続してください。どちらの方法にも、設定に関する質問をサポートしてくれる活発なコミュニティがあります。
よくある質問
Pixoo-64のAPIはDivoomの公式製品ですか？
いいえ。開発者が使用するローカルHTTP APIは、コミュニティがリバースエンジニアリングしたものであり、Divoomが公式に文書化またはサポートしているものではありません。公式の操作方法はDivoomアプリです。pixoo Pythonライブラリ、pixoo-rest、各種スマートホーム連携などのコミュニティツールは、独立した開発者によって保守されています。これらは問題なく動作しますが、ファームウェアの更新によってデバイスの挙動が変わることがあります。
Pythonを使ってPixoo-64を操作できますか？
はい。最も人気のある選択肢は、PyPIで入手できるpixoo Pythonライブラリです。Python 3.12に対応し、画像を64×64ピクセルのドット絵に自動変換でき、組み込みのRESTインターフェースも備えています。その他の選択肢として、クラウドAPIアクセス向けのAPIxooや、低レベルのキャンバス制御向けのpixoo-apiがあります。いずれもコミュニティによって保守されています。
新しいPixoo-64のファームウェアでもローカルAPIは動作しますか？
特定のファームウェアバージョンによって異なります。コミュニティの報告によると、一部の新しいファームウェアバージョンでは開いているネットワークポートが変更され、ローカルAPIアクセスに影響する場合があります。プロジェクトでAPIを利用する前に、現在のファームウェアで基本的な接続性をテストしてください。pixoo-restとpixooのGitHubリポジトリでは、ファームウェア固有の挙動や回避策について議論する未解決のIssueが掲載されていることがよくあります。
Home AssistantでPixoo-64にデータを表示できますか？
はい、コミュニティが保守している連携機能を利用できます。一般的な設定では、Home AssistantとPixoo-64の橋渡しとしてpixoo-rest Dockerコンテナを使用します。設定が完了すると、センサーデータ、カレンダーイベント、自動化などに基づいてドット絵を表示できます。最新の連携ガイドや互換性に関する注意事項については、Home Assistantコミュニティフォーラムをご確認ください。
Pixoo-64を自動化するにはプログラマーである必要がありますか？
必ずしもそうではありません。IFTTTなら、コードを書かずにPixoo-64を1,000以上のサービスに接続できるビジュアルインターフェースを利用できます。新着メール、モーション検知、ソーシャルメディアのアクティビティなどのイベントをきっかけに、ディスプレイの動作を実行する「アプレット」を作成します。Home Assistantにもビジュアル自動化ビルダーがありますが、初期設定にはより高度な技術知識が必要です。Divoomアプリ自体も、コーディングなしでスケジュール設定やソーシャルメディアのカウンター自動化に対応しています。
次に進むには
Pixoo-64は、Wi-Fi接続と活発な開発者コミュニティのおかげで、市場でも特にカスタマイズ性の高いドット絵ディスプレイの1つです。アプリを使い続ける場合でも、初めてPythonスクリプトを書く場合でも、スマートホームに組み込む場合でも、このディスプレイは静的な dekoration以上のものとなり、あなたの世界に反応するプログラム可能なキャンバスになります。
まだPixoo-64をお持ちでなく、デスク環境で64x64パネルがどのように見えるか確認したい場合は、スマートドットディスプレイコレクションでモデルを比較してみてください。すでにお持ちで、Wi-Fi設定、Bluetoothペアリング、アプリ設定など基本操作のサポートだけが必要な場合は、製品マニュアルで手順を確認できます。
次に学ぶこと
API機能を内蔵したディスプレイをお探しですか？開発者やダッシュボード愛好家向けに設計されたTimes Gateをチェックしてみてください。
一般的なドット絵の作成については、Divoomアプリガイドをご覧ください。
Divoom製品の評価方法について詳しくは、評価方法のページをご覧ください。
