Repolode
Enviar
darrylmorley

darrylmorley/whatcable

Um app para a barra de menus do macOS que explica, em linguagem simples, o que cada cabo USB-C conectado ao Mac pode fazer e por que o carregamento pode ser lento.

Ver no GitHubSite
Estrelas
8,924
Forks
270
Issues abertas
33
Último commit
há 7 dias

O que é?

O USB-C usa um único conector para tudo, desde cabos USB 2.0 que só carregam até cabos Thunderbolt 4 de 240 W, embora todos pareçam iguais. O WhatCable lê os dados de portas, carregadores, dispositivos e cabos que o macOS disponibiliza pelo IOKit e os mostra em um popover para cada porta. Ele informa a velocidade e a corrente nominal do cabo, os perfis de tensão do carregador, a potência negociada e qual parte da conexão está limitando o desempenho.

Além do carregamento, ele decodifica a malha Thunderbolt e USB4, os transportes ativos, os dispositivos conectados (com hubs ocultos por padrão) e os dados do e-marker do cabo, incluindo marca e modelo para os cabos presentes no banco de dados incluído. Uma CLI usa o mesmo mecanismo e oferece saída JSON, modo de monitoramento e dumps brutos do IOKit.

O WhatCable requer macOS 14 ou posterior em Apple Silicon. Alguns diagnósticos e painéis fazem parte de um plano Pro pago opcional, enquanto o app para a barra de menus e a CLI são gratuitos e de código aberto sob uma licença permissiva.

Recursos principais

  • 01Mostra o status principal de cada porta, como apenas carregamento, dispositivo USB ou Thunderbolt / USB4.
  • 02Diagnostica gargalos no carregamento, como um cabo com classificação inferior à do carregador.
  • 03Exibe a velocidade e a corrente nominal do cabo, além do fabricante do chip indicado pelo e-marker.
  • 04Lista todos os perfis de tensão anunciados pelo carregador e destaca o perfil negociado.
  • 05Mostra as lanes Thunderbolt, a geração e a topologia dos switches em docks com vários saltos.
  • 06Oferece uma CLI com saída JSON e modo de monitoramento.

Casos de uso

  • Descobrir por que um Mac carrega lentamente após trocar de cabo ou carregador.
  • Verificar se um cabo é compatível com Thunderbolt ou com transferência de dados a 40 Gbps antes de comprar um dock.
  • Diagnosticar um dispositivo USB ou dock que está funcionando mais lentamente do que o esperado.
  • Criar scripts no terminal para verificar portas USB-C usando a saída JSON da CLI.

Início rápido

  1. 1

    Instale o app da barra de menus com o Homebrew

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

    Ou instale apenas a ferramenta de linha de comando

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

    Execute o CLI para ver um resumo de todas as portas

    whatcable

Antes de usar

  • Apenas para Macs com Apple Silicon; Macs com Intel não disponibilizam os dados necessários das portas USB-C.
  • Requer macOS 14 (Sonoma) ou posterior.
  • Alguns recursos avançados (medição de energia em tempo real, diagnóstico e painel) exigem uma licença paga do WhatCable Pro.

Tópicos

#macos#usb-c#thunderbolt#iokit#menubar-app#swift#swiftui#hardware-info#apple-silicon#mac-app

Perguntas frequentes

O que é whatcable?
Um app para a barra de menus do macOS que explica, em linguagem simples, o que cada cabo USB-C conectado ao Mac pode fazer e por que o carregamento pode ser lento. O USB-C usa um único conector para tudo, desde cabos USB 2.0 que só carregam até cabos Thunderbolt 4 de 240 W, embora todos pareçam iguais. O WhatCable lê os dados de portas, carregadores, dispositivos e cabos que o macOS disponibiliza pelo IOKit e os mostra em um popover para cada porta. Ele informa a velocidade e a corrente nominal do cabo, os perfis de tensão do carregador, a potência negociada e qual parte da conexão está limitando o desempenho.
whatcable é gratuito? Qual é a licença?
whatcable é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
whatcable ainda é mantido?
Manutenção ativa. O último commit de whatcable foi em 13 de out. de 2026.
Para que posso usar whatcable?
Descobrir por que um Mac carrega lentamente após trocar de cabo ou carregador. Verificar se um cabo é compatível com Thunderbolt ou com transferência de dados a 40 Gbps antes de comprar um dock. Diagnosticar um dispositivo USB ou dock que está funcionando mais lentamente do que o esperado. Criar scripts no terminal para verificar portas USB-C usando a saída JSON da CLI.
Como instalar whatcable?
Instale o app da barra de menus com o Homebrew: brew install --cask darrylmorley/whatcable/whatcable Ou instale apenas a ferramenta de linha de comando: brew install darrylmorley/whatcable/whatcable-cli Execute o CLI para ver um resumo de todas as portas: whatcable
Onde consigo whatcable?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/darrylmorley/whatcable

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados