Show HN: 38ドルのThermalright Trofeo Vision LCD用ライブClaude利用状況HUD
Show HN: Live Claude Usage HUD for a $38 Thermalright Trofeo Vision LCD (github.com)
要約
このプロジェクトは、38ドルのThermalright Trofeo Vision LCDディスプレイを使用して、AIチャットボットClaudeの利用状況をリアルタイムで表示するデスクトップHUDです。macOS上でPythonとClaudeのローカルログを利用し、Pro/Maxセッションの制限バー、今日のトークン数、APIコスト、セッション情報などを表示します。USB-C接続のLCDにJPEGフレームをストリーミングすることで動作します。
全文翻訳
claude-trofeo-hud
Thermalright Trofeo Vision 6.86" LCD(1280×480、USB-C、約38ドル)に、macOSからClaudeの利用状況をリアルタイムで表示するデスクトップHUD。
r/ClaudeAIの「$38 Claude LCD Table Display」の投稿に触発されて作成されました。
表示内容:Claude Pro/Maxのセッションおよび週ごとの制限バー(Anthropicの利用状況エンドポイントから取得したリセットまでのカウントダウン付き)、その日のトークン数と推定APIコスト(ccusage経由)、ライブセッション(プロジェクト、モデル、消費レート)、時計、そして時間ごとのトークン使用量スパークライン。
ハードウェア
要件
- macOS、Python 3.12+、uv、Node(
npx ccusage用) brew install hidapi(hidapiPythonパッケージの背後にあるCライブラリ)- Claude Codeがインストールされ、ログイン済みであること(HUDはローカルログとKeychainからOAuthトークンを読み取ります — 読み取り専用で、あなたのマシンから api.anthropic.com への利用状況クエリ以外のものは送信されません)
セットアップ
uv sync
uv run python -m claude_trofeo_hud preview # 出力ファイル out/preview.png にモックレイアウトをレンダリング
uv run python -m claude_trofeo_hud run # LCDにライブHUDを表示(Ctrl-Cで停止)
uv run python -m claude_trofeo_hud install-agent # launchd経由でログイン時に開始
最初の run の際に、macOSから「Claude Code-credentials」へのKeychainアクセス許可を求められます — デーモンが自動実行できるように 常に許可 を選択してください。
uninstall-agent は launchd エージェントを停止・削除します。設定は config.toml(fps、JPEG品質、夜間の輝度調整/オフ時間)に保存されます。ログは ~/Library/Logs/claude-trofeo-hud/ に出力されます。
ディスプレイの駆動方法
このパネルはモニターではなく、リバースエンジニアリングされたプロトコルを介してJPEGフレームを受け付けるUSB HIDデバイス(VID:PID 0416:5302)です。macOSはHIDデバイスに対してlibusbをブロックするため、thermalright-trcc-linux のデバイスクラスとHidApiTransport(IOHIDManager)を使用し、そのCLIをバイパスしています。ファームウェアはアイドル時に画面を消去するため、HUDは継続的にストリーミングします(デフォルトは2 fps)。完全なプロトコルノートについては PLANNING.md を参照してください。
トラブルシューティング
- 「アクセス拒否(権限不足)」 — hidapiではなくlibusb経由でデバイスを開こうとしている可能性があります。必ず私たちのCLIを実行し、
trccを直接実行しないでください。 - パネルに起動ロゴが表示される/画面が消える — フレームが届いていません。
~/Library/Logs/claude-trofeo-hud/hud.logを確認してください。再接続はバックオフ処理付きで自動的に処理されます。 - コスト/トークンが空欄 — まずターミナルで
npx ccusageが動作することを確認してください。launchdエージェントは、インストール時にNodeのパスをplistに焼き込むため、Nodeのアップグレード後はinstall-agentを再実行してください。 - 制限が更新されない — Keychainアクセスが許可されていないか、Claude Codeからログアウトしています。