Introduzione

WhatCable

Cosa può fare veramente questo cavo USB-C?

Sito web: whatcable.uk (panoramica, screenshot e documentazione CLI).

WhatCable è una piccola app per la barra dei menu macOS che spiega in modo semplice cosa può fare ogni cavo USB-C collegato al Mac e perché la ricarica potrebbe essere lenta.

Caratteristiche

Per ogni porta, mostra in modo chiaro:

• Titolo d'impatto: Thunderbolt / USB4, dispositivo USB, display collegato, solo ricarica, cavo lento / solo carica, o assenza di connessione
• Diagnostica ricarica: messaggi come "Il cavo limita la velocità di ricarica" o "Ricarica a 30W (il caricatore arriva a 96W)" o "Ricarica correttamente a 96W"
• Informazioni sul chip e-marker del cavo: velocità effettiva (USB 2.0, 5/10/20/40/80 Gbps), corrente supportata (3A/5A fino a 240W) e vendor del chip
• Segnali di fiducia: avvisi sul chip e-marker con valori insoliti rispetto alle specifiche USB-PD (come ID vendor zero o bit riservati), indicati come "possibile anomalia" ma senza confermare contraffazione
• Profilo PDO del caricatore: lista di tutti i profili di voltaggio offerti con evidenza a quello negoziato in tempo reale
• Identità dispositivo collegato: nome vendor e tipo prodotto derivati dal messaggio PD Discover Identity
• Dispositivi USB collegati: elencati sotto la rispettiva porta con velocità negoziate
• Informazioni Thunderbolt: velocità per canale, generazione (TB3, TB4, TB5) e topologia completa del collegamento
• Identificazione cavo: se il chip e-marker corrisponde a un modello noto, mostra brand e modello oltre alle specifiche raw
• Trasporti attivi: USB 2 / USB 3 / Thunderbolt / DisplayPort
• Widget per il desktop: disponibili in tre dimensioni con stato cavi in tempo reale
• ⌥-click sull'icona della barra menu per mostrare le proprietà IOKit sottostanti per utenti avanzati

Nel menu impostazioni si possono configurare:

• Nascondere porte vuote
• Avvio automatico all'accesso
• Usare come app dock anziché icona barra menu
• Regolare dimensione del font
• Cambiare lingua (inglese, armeno, italiano, polacco, cinese semplificato o default di sistema)
• Attivare notifiche per connessioni/disconnessioni cavo
• Contribuire con dati anonimi per migliorare il supporto hardware (opt-in)

Dal clic destro sull'icona è possibile aggiornare, mantenere la finestra aperta, controllare aggiornamenti, vedere info e uscire.

WhatCable Pro

La versione base è gratuita e open source. Supporta il progetto la versione Pro a pagamento, che aggiunge:

• Monitoraggio energetico live e ispezione del contratto PD
• Finestra dedicata con grafico live di potenza in ingresso
• Contatori di salute delle porte e stima della resistenza del cavo
• Diagrammi dei pin e stato di rilevamento liquidi
• Compatibilità anche con Mac senza lettura live per porta

Acquisto una tantum valido su due Mac. Dettagli su whatcable.uk/pro.

Installazione

Scarica l'ultima versione da qui, decomprimi e copia WhatCable.app in /Applications.

Richiede macOS 14 Sonoma su Apple Silicon. Non disponibile su App Store per limitazioni Sandbox.

Installazione con Homebrew

brew tap darrylmorley/whatcable
brew install --cask whatcable

Questa procedura installa l'app e collega la CLI whatcable nel PATH.

Utilizzo CLI

Comandi principali:

whatcable                # riepilogo leggibile
whatcable --json         # output JSON
whatcable --watch        # monitoraggio eventi
whatcable --raw          # proprietà IOKit dettagliate
whatcable --report       # apri issue precompilata
whatcable --test-kit     # test diagnostici e invio dati anonimi
whatcable --version
whatcable --help

In installazione manuale, per usarla da shell creare un symlink:

ln -s /Applications/WhatCable.app/Contents/Helpers/whatcable /usr/local/bin/whatcable

Come funziona

WhatCable legge quattro famiglie di servizi IOKit senza entitlements o API private:

La decodifica velocità e potenza segue USB-PD R3.2 V1.2. Vendor provenienti da database SQLite unito di liste USB-IF, usb.ids e fingerprints raccolti dalla community.

Compilazione da sorgenti

swift build                  # compila
swift run WhatCable          # esegue app barra menu (dev)
swift run whatcable-cli      # esegue CLI
swift test                   # esegue test

Richiede Swift 5.9+ e Xcode 15+.

Costruzione pacchetto .app distributivo

./scripts/smoke-test.sh

Costruisce, firma, notarizza (se configurato) e verifica l'app, producendo dist/WhatCable.app e dist/WhatCable.zip.

Verifica firma e caricamento sulle varie repository e GitHub.

Avvertenze

• Le informazioni e-marker compaiono solo se il cavo ha un chip e-marker.
• Alcuni cavi mostrano il chip solo se è collegato un dispositivo all'altra estremità.
• WhatCable si fida delle informazioni e-marker; se il cavo dichiara specifiche false, l'app non può verificarlo, ma segnala anomalie.
• Supporta specifiche USB-PD fino a R3.2 V1.2 marzo 2026.
• Il database vendor è aggiornato a un certo snapshot; vendor nuovi possono apparire sconosciuti.

Porting Linux

Un porting Rust chiamato usbeehive è in sviluppo con interfaccia GNOME, indipendente da WhatCable e basato su sysfs Linux.

Privacy

I dati letti sono locali e non inviati automaticamente.

• Il tasto "Report this cable" apre un issue GitHub precompilata per l'utente.
• Gli aggiornamenti controllano solo la versione, senza dati personali.
• Dati diagnostici anonimi sono raccolti solo se l'utente attiva manualmente la funzione.

Contributi

Issue e pull request sono benvenuti. Il codice è contenuto e leggibile.