A bateria do mouse, do teclado e dos fones, no seu painel.
PeriGauge mostra um medidor por dispositivo no painel, na área de trabalho e num popup, e avisa antes de acabar. Escolha gauge circular ou barras, incluindo fone esquerdo, direito e estojo. Dispositivos desconectados ficam ocultos por padrão. Um único binário em Rust, tudo local: sem Solaar, sem rede, sem telemetria.
Como os estados aparecem
- Bom
- Baixa
- Crítica
- Carregando
- Leitura antiga
Dispositivos
O que funciona hoje, e com que evidência
Separamos o que foi testado em hardware do que ainda está em desenvolvimento. Nenhum dispositivo é listado como suportado sem indicar o nível de evidência.
| Dispositivo | Conexão | Backend | Evidência | Observações |
|---|---|---|---|---|
| Keychron M6 | Receptor Keychron Ultra-Link 8K | Protocolo HID de fornecedor | Verificado em hardware | Lido de um M6 real pelo receptor Ultra-Link 8K. |
| Logitech MX Keys | Bluetooth | HID++ 2.0 direto (sem Solaar) | Verificado em hardware | Leitura de bateria verificada via Bluetooth com HID++ direto, sem Solaar. Ciclos de carga e notificações nesse teclado ainda não verificados. |
| Logitech MX Keys | Receptor Unifying | HID++ 2.0 direto (sem Solaar) | Em desenvolvimento | Testes com fixtures; hardware pendente. |
| Logitech MX Master 3S | Receptor Bolt ou Bluetooth | HID++ 2.0 direto (sem Solaar) | Em desenvolvimento | Testes com fixtures; hardware pendente. |
| Samsung Galaxy Buds3 Pro | Bluetooth | Protocolo SPP da Samsung | Verificado em hardware | Leituras e atualizações de bateria verificadas via Bluetooth em um aparelho real: fone esquerdo, direito e estojo, quando informado pelo dispositivo. |
| Qualquer dispositivo que o UPower/BlueZ já reporte | Bluetooth / USB | UPower e BlueZ (power_supply do kernel, BLE Battery Service, HFP) | Genérico / esperado | Depende do que o dispositivo reporta; não é garantia por modelo. |
Detalhes completos, incluindo dados lidos, em COMPATIBILITY.md.
Notificações
Avisa na hora certa, sem repetir.
Quatro limiares, entregues pelo servidor de notificações do desktop.
- 20%
Aviso
Aviso A bateria está baixa.
- 10%
Crítico
Crítico Hora de carregar.
- 5%
Vai desligar
Crítico O dispositivo está prestes a desligar.
- 100%
Carregado
Carregado Notifica ao chegar a 100%.
Histerese
Há histerese para o mesmo aviso não se repetir a cada leitura.
Nunca com leitura antiga
Leitura antiga ou percentual estimado (por tensão) não dispara aviso; o estado aparece como “Leitura antiga”. Se o dispositivo só informa um nível aproximado, o aviso segue o próprio dispositivo (baixo/crítico).
Não perturbe
Como usa o servidor de notificações do desktop, o modo “não perturbe” é respeitado.
Privacidade
Local por padrão, de verdade.
PeriGauge só conversa com os seus dispositivos e com o desktop.
Sem rede
Sem uso de rede: tudo acontece na sua máquina.
Sem telemetria
Nenhuma métrica de uso é coletada ou enviada.
Sem Solaar
O suporte Logitech usa HID++ 2.0 direto, sem depender do Solaar.
Daemon de usuário
Um binário único,
perigauge, rodando como serviçosystemd --user, sem root.
Instalação
Instalação (pré-alpha)
Binário para Linux x86_64 com glibc 2.39 ou superior, testado no Ubuntu 26.04 com KDE Plasma 6. Confira o checksum e simule antes de instalar; tudo vai para o seu usuário, sem sudo. Para compilar do código-fonte, veja o README.
# baixar a release e conferir o checksum
curl -LO https://github.com/caiolombello/perigauge/releases/download/v0.1.0-alpha.3/perigauge-0.1.0-alpha.3-x86_64-linux.tar.gz
curl -LO https://github.com/caiolombello/perigauge/releases/download/v0.1.0-alpha.3/SHA256SUMS
sha256sum -c SHA256SUMS
tar xf perigauge-0.1.0-alpha.3-x86_64-linux.tar.gz
cd perigauge-0.1.0-alpha.3
# simular; depois instalar com o serviço de notificações
./install.sh --dry-run
./install.sh --enable-serviceO acesso HID sem root exige uma regra udev. É um passo explícito e separado, com sudo, documentado no repositório; a instalação nunca o executa sozinha.
Roadmap
O que vem a seguir
0.1.0-alpha.3
Desconectados ocultos por padrão e leitura do MX Keys via Bluetooth verificada. Publicado em outubro de 2026.
Plasmoid KDE Plasma 6
Baterias sempre à vista no painel e na área de trabalho; popup com o mesmo estilo do painel.
Extensão GNOME Shell
Planejada para depois do plasmoid.
Mais dispositivos
Mais periféricos conforme houver hardware para verificar. Cada um com seu nível de evidência.