JinxLite スタッフ用ガイド — 使い方と AI 利用

LED マトリクスへ DMX(Art-Net / USB)を送る社内アプリ ／ 受け側 ArtNetMatrixMonitor と組で使う ／ 版 2026-10-17 ／ スタッフ限定・社外に出さないこと

資料: このページの PDF 版 ／ 編集用 Word 版

0. 動画で見る

公開準備中

使い方ガイド(5 分 57 秒・音声つき・字幕あり)

1. 何のためのアプリか・画面の見方(左 JinxLite・右 ArtNetMatrixMonitor)
2. 送信を始める → エフェクトとテストパターン
3. 明るさと値の確認・配線/Pixel Mode/Universe を受け側と合わせる
4. AI 出力と録画・USB 出力(画面で説明)・AI から使う

動画では照明・USB 機器を使っていません。JinxLite と ArtNetMatrixMonitor をどちらも --local-only で起動し、Art-Net は同じパソコンの中(127.0.0.1)だけで送って受けています。操作はすべて HTTP の窓口(127.0.0.1)から行い、マウスは使っていません。音声: VOICEVOX:No.7

1. 何のアプリか

JinxLite は、LED マトリクス(LED パネル・テープを縦横に並べたもの)へ DMX を送る、軽い送出ツールです。Jinx! の代わりを目指した最小のつくりで、エフェクトやテストパターンを作って Art-Net か USB の DMX インターフェースへ送ります。配線やチャンネルの確認にも使えます。

• エフェクト 6 種(Solid・Color Cycle・Rainbow・Plasma・Scroll Text・Gradient)と、確認用のテストパターン 10 種。
• マトリクスの縦横・配線(Linear / Snake)・1 ピクセルのチャンネル構成(RGB・RGBW・RGBCW・W・WW+CW)。
• 1 ユニバースに入りきらない大きさは、列の単位で U+1, U+2 … へ自動で分けて送る。
• 送っている DMX を e:\tmp\ai_dmx\ に書き出し、録画(1 フレームずつ全チャンネル)もできる。
• AI から操作できる(11 章)。

受け側の ArtNetMatrixMonitor と組で使うのがおすすめです。ArtNetMatrixMonitor は届いた Art-Net を、同じ縦横・配線・Pixel Mode・ユニバースでマトリクスの絵に組み直して表示します。LED パネルに出る絵を、パネル無しで確かめられます。

2. 起動と設定

スタートメニューの「JinxLite」を開きます。起動したときは必ず停止中です(USB 機器が無いと固まるのを防ぐため)。

• 窓の位置・大きさ、エフェクト、明るさ・速さ、FPS、Solid 色、Text、マトリクス、配線、Pixel Mode、出力(Art-Net / USB)、送り先 IP、Universe、AI 出力の入り切りは config.json(exe と同じフォルダ)に覚え、閉じるときに書きます。
• 送り先 IP は、送信を始められた IP だけを最大 12 本の履歴に残します(▼ で選び直し、「履歴」ボタンで 1 件削除・全消去)。
• タイトルバーの括弧はビルドの時刻です。

起動オプション(2026-10-17 追加)

ArtNetMatrixMonitor にも同じ --local-only(127.0.0.1 だけで受ける)・--config・--no-http を足しました。

3. 画面の見方

4. 送信を始める・止める

1. 受け側(ArtNetMatrixMonitor)を送る側と同じ縦横・配線・Pixel Mode・Universe にして ▶ 受信開始。
2. JinxLite の ArtNet IP と Universe を確かめて ▶ 送信開始。ボタンが「■ 停止」に変わり、状態の行に送り先と fps・パケット数が出ます。
3. ■ 停止を押すと、送っていた全部のユニバースへ 0 を送ってから止まります(LED を消す)。アプリを閉じたときも同じです。

FPS は「1 秒に何回送るか」の目標です。Windows のタイマーの細かさのため、40 にしても実際は 32 前後になります(状態の行の fps が実測)。

5. エフェクトとテストパターン

6. 明るさと値の確認

プレビューも受け側に届く値も、Brightness を掛けた後の、実際に送っている値です。値を確かめるときは、両方のマトリクスを小さく(例 8×6)して、ArtNetMatrixMonitor の「セルに RGB 値を表示」を入れ、Levels を出します。

7. 配線・ピクセル構成・ユニバースを受け側と合わせる

ユニバースの自動分割

1 ユニバースは 510 チャンネルまで使います。RGB なら 170 ピクセル、RGBW 127、RGBCW 102。入りきらない分は列の単位で U+1、U+2 … へ分けます(1 ユニバースの列数 = 170 ÷ 縦 の切り捨て)。例: 31×42・RGB は 1 ユニバース 4 列 → U0〜U7 の 8 つ(最後の U7 は 3 列)。

配線(Wiring)

• Linear: 全部の列を上から下へ数える。
• Snake: 偶数列は上から、奇数列は下から(ジグザグ)。

配線は列の方向(縦に数えて次の列へ)です。送る側と受ける側(実際の LED パネル)で必ず合わせます。違うと、プレビューは正しくても受け側では 1 列おきに上下が逆になります。

Pixel Mode

Universe

Universe は先頭の番号です。送る側を 4 にすると U4〜U11 を送ります。受け側が U0 から受けていると、左半分が黒くなり絵がずれます。受け側も 4 にすれば元どおりです。

8. AI 出力(ai_dmx)と録画

「ai_dmx へ出力」に印があると、送っている DMX を e:\tmp\ai_dmx\ に書き出します(1 秒に約 6 回)。値は Brightness を掛けた後の実際の値です。

● 録画を押すと記録を始め、状態の行に ●REC とフレーム数が出ます。もう一度押すか、送信を止めると録画も止まります。

録画には DMX Record Test (XY+Walk) が向いています。暗い背景の色が座標を表し(R≒列、G≒行)、白い点が 1 つ列の順に歩きます。全チャンネルが毎フレームちょうど 1 ずつ動く(乱数なし)ので、送り側の記録と受け側の記録をフレーム単位で突き合わせられます。

9. USB 出力(Enttec Pro / Serial)

Output を「Enttec Pro / Serial (USB)」にすると、USB の DMX インターフェースへ送ります。本物の ENTTEC(FTDI)と、COM ポートでつながる互換機(StampS3 など)が同じ一覧に出ます。「再検索」で探し直します。

• USB は 1 ユニバースだけ。Universe 欄の番号のユニバースを送ります(無ければ先頭)。
• COM の互換機は、状態の行の ok と fail の数で、本当に書き込めているかを確かめます(「送信中」の表示だけでは分かりません)。
• 「Enttec 接続失敗」は、ENTTEC の純正ユーティリティなど別のアプリが機器を開いていないかを見ます。

10. 困ったとき

11. AI から使う

JinxLite と ArtNetMatrixMonitor は、AI(Claude Code など)が HTTP の窓口から読み取り・操作できます(2026-10-17 追加)。動画の操作もすべてこの方法で行っています。どちらも 127.0.0.1 だけで受け、認証はありません。

JinxLite

ArtNetMatrixMonitor

USB(Enttec Pro / Serial)への切り替え・受信は、どちらの窓口からもできません(画面で人が行う)。/・/status・/effects 以外は POST です。curl では本文が空でも -d "" を付けます。失敗は {"ok":false,"error":"…"}、成功は {"ok":true,"did":"…","status":{…}}。

curl -s http://127.0.0.1:55740/status
curl -s -d "" "http://127.0.0.1:55750/start"
curl -s -d "" "http://127.0.0.1:55740/target?ip=127.0.0.1&universe=0"
curl -s -d "" "http://127.0.0.1:55740/effect?name=Rainbow"
curl -s -d "" "http://127.0.0.1:55740/start"
curl -s -d "" "http://127.0.0.1:55740/record?on=1"

状態ファイル

• e:\tmp\ai_dmx\ — JinxLite が送っている DMX(8 章)。
• e:\tmp\ai_matrixmon\ — ArtNetMatrixMonitor が受けて戻した絵(latest.txt の濃淡、status.json の pixelsHex)。

両方を読めば、AI は「送った絵」と「受けた絵」を突き合わせられます。

AI への頼み方の例

• 「JinxLite で今何を送っているか、ai_dmx を見て教えて」
• 「JinxLite を 31×42・Snake・RGB にして Rainbow を 127.0.0.1 の Universe 0 へ。Matrix Monitor も同じにして、受けた絵が合っているか確かめて」
• 「DMX Record Test を 10 秒録画して、録画の 1 フレーム目と Matrix Monitor の絵を突き合わせて」

止まっているときや再ビルドは、AI が tools/restart_app.ps1 -AppName JinxLite で強制停止 → ビルド → 起動できます(開発担当の作業です)。

JinxLite 2026-10-17 ／ スタッフ限定。図と動画の画面は、照明・USB 機器を使わず、Art-Net を 127.0.0.1 の中だけで送受信して撮った画面です(図は動画から切り出したもの)。概要は同じフォルダの OVERVIEW.md、詳しい設定は MANUAL.md・取扱説明書_JinxLite.html。