Plugin TopStats no Omarchy

O TopStats ocupa um trecho da barra com quatro métricas e abre o detalhamento de cada uma em um cartão. Na barra, você lê CPU, GPU, RAM e NET como rótulo, valor e um micro medidor, sem ícone no lugar do nome. Clicar em CPU, GPU ou RAM abre um cartão com barras de capacidade, gráfico de dois minutos, processos mais pesados e tempo ligado. O clique em NET mostra taxas ao vivo, totais desde o boot e a interface ativa.

O plugin é QML original, escrito para o Quickshell do Omarchy. Ele lê as métricas do kernel e dos utilitários do sistema, sem daemon em segundo plano, sem exigir root e sem conexão de saída. Isso importa em máquina ligada o dia inteiro: o custo é uma amostragem periódica e não um serviço a mais para administrar.

Se a máquina não tem GPU compatível, o segmento de GPU e a aba correspondente desaparecem sozinhos. A barra continua com CPU, RAM e rede. O painel não mostra uma seção vazia.

Antes de instalar

O TopStats exige Omarchy Quattro 4.x com o shell Quickshell. Em placas NVIDIA, o nvidia-smi vem do pacote nvidia-utils, que costuma acompanhar o driver. Em placas AMD, nenhum pacote extra é necessário, porque a leitura vem do sysfs do amdgpu.

O btop é opcional e só entra no botão de terminal do painel e no clique direito. A maior parte das instalações do Omarchy já traz o programa.

Instale

1
omarchy plugin add https://github.com/KaplanHalil/omarchy-topstats.git --enable

Se o widget não entrar na barra sozinho, coloque-o à direita, antes do indicador de energia:

1
omarchy plugin enable io.github.kaplanhalil.topstats --section right --before omarchy.power

Você também pode arrastar o widget na barra ou movê-lo depois com omarchy bar move io.github.kaplanhalil.topstats --section right. Quando a barra fica na borda esquerda ou direita da tela, o layout troca sozinho para rótulo e medidor compactos.

Use o painel

Os botões do rodapé abrem o btop e as configurações do widget. Os medidores ficam brancos até 50%, em âmbar até 75% e em vermelho acima disso, com cada núcleo colorido de forma independente.

Leia as métricas

O cartão de CPU traz uso total, barras por núcleo, frequência, temperatura do pacote e tempo ligado. O cartão de RAM e swap mostra usado e total. Na barra, o valor aparece como usado sobre o total em GiB. Cada cartão guarda dois minutos de histórico em um gráfico com escala de 100, 50 e 0.

A lista de processos mostra os três primeiros aplicativos por participação no CPU total, por memória ou por atividade de GPU, conforme a aba. Em NVIDIA, o plugin lê uso, VRAM, temperatura, potência, versão do driver e atividade por processo pelo nvidia-smi pmon. Em AMD, a leitura vem de gpu_busy_percent e de mem_info_vram_*, além dos sensores hwmon.

Ajuste o widget

Abra a engrenagem no painel ou edite a entrada do widget em ~/.config/omarchy/shell.json. As alterações feitas no painel voltam para o mesmo arquivo pelo caminho normal de atualização de itens da barra.

1
{
2
  "id": "io.github.kaplanhalil.topstats",
3
  "showCpuValue": true,
4
  "showGpuValue": true,
5
  "showRamValue": true,
6
  "showNetwork": true,
7
  "cpuStyle": "meter",
8
  "gpuDevice": "auto",
9
  "interval": 1000,
10
  "gpuInterval": 2000
11
}

A chave antiga showValues continua aceita quando as chaves por métrica estão ausentes.

De onde vêm as leituras

Cada chamada ao nvidia-smi acorda a GPU discreta por um instante. O intervalo padrão de 2 segundos responde bem ao uso comum. Em notebook, subir gpuInterval para 5 ou 10 segundos reduz o consumo parado e deixa o gráfico menos fino.

Atualize e remova

1
omarchy plugin update io.github.kaplanhalil.topstats
2
omarchy plugin remove io.github.kaplanhalil.topstats

A remoção apaga o widget e a entrada na configuração da barra. Como o plugin não grava banco de métricas nem mantém serviço, não há histórico acumulado para limpar depois.