darrylmorley /whatcable
macOS menu bar app that tells you, in plain English, what each USB-C cable plugged into your Mac can actually do
★ 9,126⑂ 279👁 16⑃ 175● 452▤ 138
Download: v1.5.0: Devices in the right box, displays read from macOS, and live chargingv1.5.0 ↓1.5.02026-10-13
+7
Daily
9,126
stars
279
forks
16
watchers
175
prs
452
issues
138
releases
README
WhatCable What can this USB-C cable actually do? Website: whatcable.uk (overview, screenshots, and CLI docs) A small macOS menu bar app that tells you, in plain English, what each USB-C cable plugged into your Mac can actually do, and why your Mac might be charging slowly. USB-C hides a lot under one connector. Anything from a USB 2.0 charge-only cable to a 240W / 40 Gbps Thunderbolt 4 cable, all looking identical in your drawer. macOS already exposes the relevant info via IOKit; WhatCable surfaces it as a friendly menu bar popover. Part of a family: WhatBattery for battery health and charging, WhatPort for every port at once. !WhatCable popover What it shows Per port, in plain English: - At-a-glance headline: Thunderbolt / USB4, USB device, Display connected, Charging only, Slow USB / charge-only cable, Nothing connected - Charging diagnostic: when something's plugged in, a banner identifies the bottleneck: - "Cable is limiting charging speed" (cable rated below the charger) - "Charging at 30W (charger can do up to 96W)" (Mac is asking for less, e.g. battery near full) - "Charging well at 96W" (everything matches) - "Battery full, not charging" (plugged in, battery full, so the Mac isn't drawing power) - Mid-session fault warnings: if a cable develops trouble while it's plugged in (a power overcurrent, or the connection dropping and coming back), a banner appears on the port. It reads the port's own fault counters, so it catches faults that only show up once a cable is under load. - Data-speed diagnostic: a plain-English verdict on what's limiting the link, the Mac port, the cable, or the device. For example "Cable is limiting data speed", "Device runs at 10 Gbps, this is the fastest it supports, not a cable problem", or "Running slower than expected" when the link came up degraded. Shown inline, in the CLI, and in JSON. - Cable e-marker info: the cable's actual speed (USB 2.0, 5 / 10 / 20 / 40 / 80 Gbps), current rating (3 A / 5 A up to 60W / 100W / 240W), and the chip's vendor - USB-IF certification: cables that carry a certificate ID (XID) get a "USB-IF certified" line naming the manufacturer. The ID is read off the cable itself and matched against a list of USB-IF certifications bundled with the app, which is where the manufacturer name comes from. Nothing is looked up over the network. A cable advertising an ID that USB-IF doesn't publish gets a neutral "certified but unlisted" line instead. Certification is voluntary and Apple's own cables land there, so it's a fact about the ID, never a verdict on the cable. The raw XID is in the JSON output. - Cable trust signals: an orange card appears when the e-marker reports values that look unusual against the USB-PD spec, like a zero vendor ID, a reserved bit pattern in the speed / current / cable-latency fields, or a VID that isn't in USB-IF's published list. Wording is hedged on purpose: a flag means "this looks unusual," not "this cable is fake." - Charger PDO list: eve
Top issues
#430Looking for beta testers for pre-release builds22 comments · 2026-07-15#81Help translate WhatCable into your language12 comments · 2026-05-07#627[Bug] One front C port and one A port mixed up on M5 Max Mac Studio7 comments · 2026-09-25#554E-marker shown as "Present, but not read" with some chargers (Anker Prime 160W)6 comments · 2026-08-21#650[Bug] Separate controller information from cable information5 comments · 2026-10-16#594[Bug] My whatcable can't use5 comments · 2026-08-31#664[Cable Report] No vendor reported, USB 3.2 Gen 1 (5 Gbps)3 comments · 2026-11-07#439[Feature] Write uk.whatcable into /private/etc/paths.d to Find whatcable CLI Executable File3 comments · 2026-07-15
Discussions
#652No USB detected - M1 Air0 comments · 2026-10-17#642What would you like WhatCable to do next?1 comments · 2026-10-10#637v1.5.0-beta.10 is up0 comments · 2026-10-10#634v1.5.0-beta.9 is up9 comments · 2026-10-09#610Inquiry: [email protected] email bouncing / Requesting EDU discount1 comments · 2026-09-12#603Ethernet support in USB docks1 comments · 2026-09-07#595Hide menu bar when not in use0 comments · 2026-08-31#590v1.5.0-beta.8 is up6 comments · 2026-08-31
Latest release
v1.5.0: Devices in the right box, displays read from macOS, and live charging v1.5.0 2026-10-13Devices in the right box, displays read from macOS, and live charging A big one. Ten betas went into this, and most of what changed started with a tester's report. Credits inline. Connected devices - Devices on a Thunderbolt chain show under a dock or display only when the hardware proves they are inside it. Before, a device could look as if it sat in the first box in the chain just because nothing said otherwise. Anything unproven now appears under "Other USB devices on this port", and a dock's own hubs nest where they belong. - Thunderbolt 5 daisy chains are sorted. On a Mac to display t