Ícone wslpanel wslpanel v0.2.0
GitHub ↗
Zig 0.17 · GTK 3 (nanoui) · Licença MIT

O painel nativo da sua distro WSL2 & Linux.

A distro WSL fica quieta até o disco encher. O wslpanel traz CPU por núcleo, RAM, swap, /, /tmp e /var/log no ritmo de 1 segundo — junto de Processos, Docker, Logs e pacotes dpkg numa janela nativa leve.

Release 0.2.0 · 2026-11-18 Debian / Ubuntu / WSLg PT · EN · ES Zero senha salva
wslpanel 0.2.0 — GTK 3 (WSLg)
Captura real da janela do wslpanel mostrando Recursos, Processos, Docker, Logs e Programas
Arquitetura do Painel · 5 Abas

Tudo o que você rodaria em htop, du, docker ps e dpkg

Cada aba lê direto do sistema Linux (`/proc`, `cgroup`, `/var/log`, `/var/lib/dpkg/status`) sem daemons pesados em segundo plano.

Recursos em tempo real (1 segundo)

Página inicial desenhada para detectar vazamento de disco e gargalo de CPU antes da distro travar.

  • CPU & Carga: percentual total, load average e uma barra individual por núcleo com histórico recente.
  • Memória & Disco: RAM, swap, ocupação de / e tamanho monitorado de /tmp e /var/log.
  • Limpar /tmp seguro: pede confirmação e preserva sockets da sessão gráfica (.X11-unix, .ICE-unix, .XIM-unix, .font-unix).
  • Limpar logs rodados: apaga apenas arquivos rotacionados (.gz, .xz, .bz2, .old, .1), mantendo o log ativo intacto.

Processos lidos direto de /proc

Lista virtual leve sem sobrecarga de terminal, pronta para identificar o processo que disparou CPU ou RSS.

  • Exibe nome, PID, fatia de CPU, memória RSS e estado do processo.
  • Ação Encerrar envia SIGTERM somente após confirmação explícita em diálogo.
  • Trava de segurança nativa: o PID 1 e o próprio processo do wslpanel ficam protegidos fora da ação de encerrar.

Containers Docker sob demanda

A aba só aparece automaticamente quando o cliente docker está instalado na distro.

  • Lista cada container em execução com nome e status vindos de docker ps.
  • Lê CPU, memória e contagem de PIDs diretamente do cgroup do Linux.

Leitor rápido de /var/log

Inspecione o final dos arquivos de log de texto sem sair da janela gráfica.

  • Lê arquivos de texto em /var/log e um nível abaixo (como apt/history.log).
  • Carrega a cauda começando em 50 linhas e expande de 50 em 50 até 2000 linhas.
  • Ignora automaticamente compactados e binários (wtmp, btmp, lastlog, faillog).

Gestor de pacotes Debian / Ubuntu (dpkg)

Lê /var/lib/dpkg/status com filtros práticos para manutenção limpa da distro.

  • Busca instantânea, ordenação por nome, tamanho ou data e filtros: programas, manuais, todos, atualizações, órfãos e bibliotecas.
  • Painel de detalhes com versão, origem, tamanho, dependências e quem exige o pacote.
  • Atualizar, remover e limpar órfãos rodam sudo -n apt-get com diálogo de confirmação e proteção contra remoção de pacotes essenciais.
  • Zero senha guardada: se o sudo exigir senha, o comando pronto aparece no rodapé com botão Copiar.
Engenharia Defensiva

Limpeza sem quebrar a sessão gráfica nem guardar senhas

Sockets Protegidos

WSLg intacto

Limpar /tmp nunca apaga .X11-unix, .ICE-unix, .XIM-unix ou .font-unix.

Logs Ativos

Só arquivos rodados

A limpeza de /var/log toca apenas arquivos rotacionados (.gz, .xz, .bz2, .old, .<n>).

Sem Credenciais

sudo -n transparente

Nenhuma senha é pedida ou armazenada. Quando precisa de privilégio, exibe o comando com botão Copiar.

Fallback CPU

Funciona sem GPU

Em ambientes sem OpenGL/EGL, basta rodar com NANOUI_RENDERER=cpu para renderizar via CPU.

Instalar & Compilar

Do zero à janela aberta em 4 comandos

Requer Linux (ou Debian/Ubuntu no WSL2 com WSLg), Zig 0.17.0 e libgtk-3-0. A primeira compilação baixa o nanoui (MIT) na revisão fixada em build.zig.zon.

1. Clonar, compilar e executar
git clone https://github.com/araguaci/wslpanel
cd wslpanel
zig build -Doptimize=ReleaseSafe
./zig-out/bin/wslpanel
2. Dependência GTK 3 (Debian / Ubuntu)
sudo apt-get update
sudo apt-get install -y libgtk-3-0
3. Instalar Zig 0.17.0 (se não estiver no PATH)
mkdir -p "$HOME/.local"
curl -fL -o zig-x86_64-linux-0.17.0.tar.xz \
  https://ziglang.org/download/0.17.0/zig-x86_64-linux-0.17.0.tar.xz
tar -xJf zig-x86_64-linux-0.17.0.tar.xz -C "$HOME/.local"
export PATH="$HOME/.local/zig-x86_64-linux-0.17.0:$PATH"
4. Idioma & Fallback sem GPU
# Forçar idioma (pt_BR, en ou es)
WSLPANEL_LANG=en ./zig-out/bin/wslpanel

# Renderização via CPU (sem OpenGL/EGL)
NANOUI_RENDERER=cpu ./zig-out/bin/wslpanel
Evolução & Plano (PLANO.md)

O que já entrou e o que vem a seguir

v0.1.02026-11-18

  • ✓ Recursos (1s): CPU por núcleo, RAM, swap, /, /tmp e /var/log.
  • ✓ Limpeza segura preservando sockets da sessão e logs ativos.
  • ✓ Programas dpkg: busca, filtros, órfãos e apt confirmado.
  • ✓ PT, EN e ES via WSLPANEL_LANG ou botões no rodapé.

v0.2.0 (Atual)2026-11-18

  • ✓ Aba Processos: leitura de /proc com SIGTERM confirmado.
  • ✓ Aba Docker: CPU/RAM via cgroup, PIDs e docker ps.
  • ✓ Aba Logs: cauda de /var/log de 50 em 50 até 2000 linhas.
  • ✓ Tema Auto / Claro / Escuro e botão Copiar para comandos sudo.

PróximoRoadmap

  • ○ Lembrar escolhas: persistir idioma, aba, ordenação e tema.
  • ○ Soltar .deb: arrastar pacote na janela para preparar apt install.
  • ○ Bandeja Linux: StatusNotifierItem com CPU/RAM e atalhos.
  • ○ Linha do tempo & Auto-update via releases do GitHub.