Repolode
darrylmorley

darrylmorley/whatcable

Macのメニューバーから、各USB-Cケーブルでできることや充電が遅い理由を平易な言葉で確認できるアプリ。

スター
8,924
フォーク
270
未解決の Issue
33
最終コミット
6 日前

これは何?

USB-Cは、充電専用のUSB 2.0ケーブルから240W対応のThunderbolt 4ケーブルまで、見た目が同じでも機能が異なるケーブルで共通のコネクタが使われています。WhatCableは、macOSがIOKitを通じて公開するポート、充電器、デバイス、ケーブルの情報を読み取り、ポートごとのポップオーバーに表示します。ケーブルの速度と電流定格、充電器の電圧プロファイル、ネゴシエートされた電力、接続経路のどこがボトルネックになっているかを確認できます。

充電情報に加えて、ThunderboltとUSB4のファブリック、アクティブな転送方式、接続デバイス(ハブはデフォルトで非表示)、ケーブルのe-marker情報も解析します。バンドルされたデータベースに登録されているケーブルなら、ブランドとモデルも確認できます。CLIも同じエンジンを使い、JSON出力、watchモード、生のIOKitダンプに対応しています。

WhatCableを使うにはApple Silicon搭載のmacOS 14以降が必要です。一部の診断機能とダッシュボードは任意の有料Proプランで利用できますが、メニューバーアプリの基本機能とCLIは、寛容なライセンスのもとで無料のオープンソースとして提供されています。

主な機能

  • 01ポートごとに「充電のみ」「USBデバイス」「Thunderbolt / USB4」などの概要を表示します。
  • 02充電器より定格の低いケーブルなど、充電のボトルネックを診断します。
  • 03ケーブルの速度、電流定格、e-markerのチップベンダーを表示します。
  • 04充電器が提示するすべての電圧プロファイルを一覧表示し、ネゴシエートされたプロファイルを強調します。
  • 05複数段のドックについて、Thunderboltのレーン数、世代、スイッチのトポロジーを表示します。
  • 06JSON出力とwatchモードに対応したCLIを提供します。

ユースケース

  • 新しいケーブルや充電器に替えたあと、Macの充電が遅くなった理由を調べる。
  • ドックを購入する前に、ケーブルがThunderboltまたは40 Gbpsのデータ転送に対応しているか確認する。
  • USBデバイスやドックの動作が想定より遅い原因を調べる。
  • CLIのJSON出力を使って、ターミナルからUSB-Cポートの状態をスクリプトで確認する。

クイックスタート

  1. 1

    Homebrewでメニューバーアプリをインストール

    brew install --cask darrylmorley/whatcable/whatcable
  2. 2

    または、コマンドラインツールのみをインストール

    brew install darrylmorley/whatcable/whatcable-cli
  3. 3

    CLIを実行して、すべてのポートの概要を確認

    whatcable

使う前に知っておきたいこと

  • Apple Silicon搭載のMacのみ対応。Intel搭載のMacでは、必要なUSB-Cポートのデータを取得できません。
  • macOS 14(Sonoma)以降が必要です。
  • ライブ電力測定、診断、ダッシュボードなど一部の高度な機能には、有料のWhatCable Proライセンスが必要です。

トピック

よくある質問

whatcable とは?
Macのメニューバーから、各USB-Cケーブルでできることや充電が遅い理由を平易な言葉で確認できるアプリ。 USB-Cは、充電専用のUSB 2.0ケーブルから240W対応のThunderbolt 4ケーブルまで、見た目が同じでも機能が異なるケーブルで共通のコネクタが使われています。WhatCableは、macOSがIOKitを通じて公開するポート、充電器、デバイス、ケーブルの情報を読み取り、ポートごとのポップオーバーに表示します。ケーブルの速度と電流定格、充電器の電圧プロファイル、ネゴシエートされた電力、接続経路のどこがボトルネックになっているかを確認できます。
whatcable は無料で使えますか?ライセンスは?
whatcable は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
whatcable は今もメンテナンスされていますか?
活発にメンテナンス中。whatcable の最終コミットは 2026年10月13日 です。
whatcable は何に使えますか?
新しいケーブルや充電器に替えたあと、Macの充電が遅くなった理由を調べる。 ドックを購入する前に、ケーブルがThunderboltまたは40 Gbpsのデータ転送に対応しているか確認する。 USBデバイスやドックの動作が想定より遅い原因を調べる。 CLIのJSON出力を使って、ターミナルからUSB-Cポートの状態をスクリプトで確認する。
whatcable のインストール方法は?
Homebrewでメニューバーアプリをインストール: brew install --cask darrylmorley/whatcable/whatcable または、コマンドラインツールのみをインストール: brew install darrylmorley/whatcable/whatcable-cli CLIを実行して、すべてのポートの概要を確認: whatcable
whatcable はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/darrylmorley/whatcable

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト