Skip to content

v0.5.0: Command-line interface

Choose a tag to compare

View all tags
@darrylmorley darrylmorley released this 01 May 13:41
· 666 commits to main since this release
v0.5.0
fd566fe

What's new

  • Command-line interface. A whatcable binary now ships alongside the menu bar app, driven by the same diagnostic engine. Useful for scripting, dotfiles, CI, or just checking ports without opening the popover.

    • whatcable prints a colorised, human-readable summary of every USB-C / MagSafe port.
    • whatcable --json emits a structured JSON document for piping into jq or other tools.
    • whatcable --watch streams updates as cables are plugged and unplugged. Ctrl+C to exit.
    • whatcable --raw includes the underlying IOKit properties for each port.
    • whatcable --version, whatcable --help for the obvious things.

  • Refactored core. The diagnostic logic now lives in a WhatCableCore library shared by the menu bar app and the CLI. No behaviour change for the app, but the codebase is cleaner and easier to extend.

Install

Download WhatCable.zip, unzip, and drag WhatCable.app into /Applications. Notarised and stapled, no Gatekeeper warning.

The CLI binary ships inside the app bundle at WhatCable.app/Contents/MacOS/whatcable. To use it from the shell, either:

  • Install via Homebrew tap, which symlinks whatcable into your PATH automatically: 
    brew tap darrylmorley/whatcable
brew install --cask whatcable
  • Or symlink manually: 
    ln -s /Applications/WhatCable.app/Contents/MacOS/whatcable /usr/local/bin/whatcable

If you have v0.4.0 or later installed, the in-app updater will offer to install this version automatically.

Assets 3
Loading