Skip to content

aviscaerulea/sysmeters

Repository files navigation

sysmeters

Windows 11 用リアルタイムシステムリソース監視 HUD アプリケーション。

CPU、GPU、メモリ、ディスク I/O、ネットワーク通信量に加え、
Claude Code のレートリミット使用状況をコンパクトなオーバーレイ GUI でモニタリングする。

sysmeters

タスクトレイアイコンの右クリックメニュー「表示項目」から、CPU、GPU、メモリ、ディスク、ネットワーク、Claude の各セクションを個別にオン/オフできる。必要なカテゴリのみを残してウィンドウを最小化する用途にも対応する。下図は CPU と Claude のみを表示した例だ。

表示項目を絞った例

各種警告閾値を超えたタイミングで Toast 通知が表示される。通知の ON/OFF はシステムトレイアイコンの右クリックメニューから切り替え可能。

Toast 通知

機能

  • CPU:全体使用率(面グラフ)+ ハードフォールト(重畳面グラフ)+ 論理コア別使用率(縦バー、実際の論理コア数分)+ 温度(横バー)+ システム統計(Proc/Thread/Handle、閾値超過で赤文字)
  • GPU:使用率(面グラフ)+ 温度(横バー)、NVIDIA NVML 経由
  • RAM:使用率(横バー)+ 使用量/総量
  • VRAM:使用率(面グラフ)+ 使用量/総量、NVIDIA NVML 経由
  • Disk I/O:C: / D: パーティション別、Read/Write 分離(面グラフ + MB/s)
  • Network:全 NIC 合算、送信/受信分離(面グラフ + KB/s or MB/s)
  • IP:グローバル IP アドレス表示(5 分ごとに取得、オフライン時は NO INTERNET📵)
  • Claude Code:5h / 7d レートリミット使用率(横バー)+ リセット時刻、セッション数。横バー上の緑の縦線は均等消費ペースマーカー(リセットまでの残り時間で均等に消費した場合の理想消費位置)。5h バーには PT 平日 5:00-10:59 を暗赤色で示すピーク時間帯表示があるが、2026-05 の Anthropic によるレート制限撤廃に伴いデフォルト OFF(sysmeters.toml[claude] show_peak_bar = true で有効化可能)。毎時 0 分に最新データを強制取得する。緑の理想位置からの超過率が閾値を超えると赤文字・警告音・Toast 通知を発する
  • Claude Code 制限強化時間 通知:ローカル平日 21:00 に Toast 通知を発する(PT 5:00 消費ピーク時間帯の開始予告)。起動時点でピーク期間内なら即時通知する。2026-05 のレート制限撤廃に伴いデフォルト OFF。ON/OFF・通知文言・警告音の有無は sysmeters.toml[notify] セクションで調整可能
  • Claude Code nudge:5h 使用率が指定ペースを下回ったタイミングで claude.exe(設定可能)を自動起動し、レートリミットの消費を促す機能。Usage 取得間隔も設定可能。sysmeters.toml[claude] nudge_enable = true で有効化。デフォルト OFF
  • 更新確認:起動時に GitHub の最新リリースを確認し、新版があれば Toast 通知とトレイメニューで知らせる。同一版への繰り返し通知はしない。sysmeters.toml[update] enabled = false で無効化可能
  • 警告音:いずれかの監視項目が警告閾値を超えると alert.wav を再生。ヒステリシス付きで再開閾値を下回るまで再鳴動しない。BLE ヘッドフォン対策として前後に 19kHz 不可聴トーンを挿入
  • Toast 通知:閾値超過時に OS のトースト通知を表示し、どの項目が超過したかを通知する

Direct2D による GPU アクセラレーション描画で滑らかな表示を実現。

警告色

各メトリクスが設定ファイルの閾値を超えると、該当するテキストやバーが赤色に変化する。温度は 3 段階(通常:グレー → 注意:オレンジ → 危険:赤)で色分けされる。警告色の判定は瞬間値に基づく。

警告音

いずれかの監視項目が閾値を超えると alert.wav を再生する。ヒステリシス機構により、リセット閾値を下回るまで同一項目の警告音は再鳴動しない。CPU と GPU の警告音は瞬間スパイクによる誤警告を防ぐため、直近数サンプルの平均値で判定する。

  • BLE ヘッドフォンの省電力移行で冒頭が途切れる問題に対応し、再生前後に 19kHz 不可聴トーンを挿入。長さは sysmeters.toml[guard] tone_ms で調整可能(0 で無効化)
  • WASAPI 共有モードで再生するため、他のアプリケーションの音声と共存
  • 閾値・リセット閾値・警告音の有効/無効は sysmeters.toml[threshold] セクションで設定可能
  • Toast 通知の有効/無効はタスクトレイアイコンの右クリックメニューで切り替え可能(設定はレジストリに保持)
  • フルスクリーンアプリ(ゲーム・プレゼン等)の実行中は Toast 通知と警告音を自動抑制する。タスクトレイメニューの「フルスクリーン時は通知しない」で ON/OFF 切り替え可能(デフォルト ON)
  • タスクトレイの右クリックメニューから Windows スタートアップ登録の ON/OFF を切り替え可能

インストール

Scoop でインストールできる。

scoop bucket add aviscaerulea https://github.com/aviscaerulea/scoop-bucket
scoop install sysmeters

実行

out\sysmeters.exe

タスクトレイ(通知領域)にアイコンが表示される。右クリックメニューで常に最前面・Toast 通知の切り替え、表示項目の選択、設定ファイルを開く、終了などの操作ができる。

設定

sysmeters.toml で外観(背景色、グラフ色)、警告閾値、プロセス優先度の自動制御等をカスタマイズできる。sysmeters.local.toml が存在する場合、その値が sysmeters.toml の設定を上書きする。個人設定はこちらに記述すると更新時の差分が出にくい。

動作要件

  • Windows 11(64bit)
  • CPU 温度を表示するには PawnIO ドライバ のインストールが必要(winget install namazso.PawnIO

ビルド

# 依存ライブラリの取得(初回のみ)
pwsh.exe scripts/fetch-deps.ps1

# ビルド
task build

# リリースビルド(zip パッケージング)
task release

About

Real-time system HUD for Windows 11 — CPU/GPU/Memory/Disk/Network + Claude Code rate limit overlay via Direct2D

Topics

Resources

License

Stars

Watchers

Forks

Contributors