Skip to content

Instantly share code, notes, and snippets.

@GOROman
Created August 7, 2026 07:19
Show Gist options
  • Select an option

  • Save GOROman/b2fe139ae38435c61479e336ce28912d to your computer and use it in GitHub Desktop.

Select an option

Save GOROman/b2fe139ae38435c61479e336ce28912d to your computer and use it in GitHub Desktop.
Codex Micro / Work Louder JSON-RPCメソッド一覧

Codex Micro / Work Louder JSON-RPCメソッド一覧

解析日: 2026-08-07

Codexアプリ統合で確認したメソッド

Method 方向 用途
device.status Host → Device Firmware、Profile、Layer、Battery取得
sys.version Host → Device Firmware version取得
host.focused_app Host → Device フォーカス中アプリ通知
v.oai.thstatus Host → Device 6個のAgent LED
v.oai.rgbcfg Host → Device 通常キー・外周LED
v.oai.hid Device → Host Agent、Action、Micキー通知
v.oai.rad Device → Host アナログスティック通知

System / Diagnostics

Method 用途
sys.version Firmware version
sys.bootloader Bootloaderへ再起動
sys.selftest Self-test / diagnostic mode
device.status Device状態取得

Media

Method 用途
mp.write_info 曲名、Artist、再生位置、Duration、再生状態
mp.write_artwork Base64分割したArtwork送信

Filesystem

Method 用途
fs.list File一覧、任意でChecksum・再帰
fs.read JSONとしてFile読込
fs.write JSONとしてFile書込
fs.readbin Binary分割読込
fs.writebin Base64 Binary分割書込
fs.delete File削除
fs.rmdir Directory削除
fs.txbegin 複数File transaction開始
fs.txcommit Transaction commit

Binary transferのSDK上限は1 chunkあたりBase64 4096文字、raw data換算3072 bytes。

App Manager / UI

Method 用途
appmgr.list_active Firmware上で有効なApp一覧
appmgr.list_installed Install済みCustom App一覧
ui.active_screen 現在のScreen取得
ui.home_accent_color Home画面Accent color設定
lights.preview 一般的なBacklight / Underglow preview

実装範囲

Codex Micro互換クローンとしてCodexデスクトップアプリを動かす最小実装は次の通り。

  1. device.status
  2. v.oai.thstatus
  3. v.oai.rgbcfg
  4. host.focused_appへの成功応答
  5. v.oai.hid通知
  6. v.oai.rad通知(Joystickを使う場合)

Filesystem、Media、App Manager、一般照明PreviewはWork Louder基盤SDKに存在するが、Codex Micro統合の基本動作には必須ではない。

sys.bootloaderはデバイスを切断・再起動させるため、互換Firmwareで実装・試験する際は注意する。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment