https://github.com/cleyton1986/predator-sense
🎮 Predator Sense for Linux — Unofficial hardware control for Acer Predator/Helios/Nitro gaming laptops. RGB keyboard, GPU monitoring, performance profiles, fan control. Built with Rust + GTK4.
https://github.com/cleyton1986/predator-sense
acer gaming gtk4 hardware-control helios kernel-module linux nitro nvidia predator predator-sense rgb-keyboard rust temperature-monitor
Last synced: 9 days ago
JSON representation
🎮 Predator Sense for Linux — Unofficial hardware control for Acer Predator/Helios/Nitro gaming laptops. RGB keyboard, GPU monitoring, performance profiles, fan control. Built with Rust + GTK4.
- Host: GitHub
- URL: https://github.com/cleyton1986/predator-sense
- Owner: cleyton1986
- License: gpl-3.0
- Created: 2026-04-04T21:20:46.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-07-11T17:21:52.000Z (15 days ago)
- Last Synced: 2026-07-11T19:08:14.541Z (15 days ago)
- Topics: acer, gaming, gtk4, hardware-control, helios, kernel-module, linux, nitro, nvidia, predator, predator-sense, rgb-keyboard, rust, temperature-monitor
- Language: Rust
- Homepage: https://github.com/cleyton1986/predator-sense
- Size: 2.32 MB
- Stars: 9
- Watchers: 0
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README-ptbr.md
- License: LICENSE
Awesome Lists containing this project
README
# Predator Sense para Linux
Módulo não oficial do kernel Linux e interface gráfica para controle de hardware de notebooks Acer Gaming
Retroiluminação RGB do Teclado • Modo Turbo • Monitoramento de Temperatura • Perfis de Desempenho
Criado e mantido por Cleyton Alves
---
## Aviso Legal
> **Atenção**
> **Use por sua conta e risco!** Este Ă© um projeto **nĂŁo oficial**. A Acer nĂŁo esteve envolvida no seu desenvolvimento. O mĂłdulo do kernel foi desenvolvido por meio de engenharia reversa do aplicativo oficial PredatorSense para Windows. Este driver interage com mĂ©todos WMI/ACPI de baixo nĂvel que nĂŁo foram testados em todas as sĂ©ries de notebooks. Os autores nĂŁo se responsabilizam por quaisquer danos ao seu hardware.
> **Nota**
> Todas as marcas registradas, nomes de produtos e logotipos mencionados (Acer, Predator, PredatorSense, Helios, Nitro, AeroBlade, CoolBoost) sĂŁo propriedade de seus respectivos donos (Acer Inc.). Este projeto nĂŁo Ă© afiliado, endossado ou patrocinado pela Acer Inc. de nenhuma forma.
> **Imagens dos produtos**
> As fotos de notebooks em `predator-sense-gui/resources/models/` retratam produtos oficiais Acer Predator/Nitro e sĂŁo usadas exclusivamente para permitir que o aplicativo identifique visualmente o modelo detectado na máquina do prĂłprio usuário (comparando com o `product_name` informado pela DMI/BIOS do sistema). Essas imagens **nĂŁo estĂŁo licenciadas sob a licença GPLv3 deste projeto** — os direitos de autor sobre as fotografias dos produtos pertencem Ă Acer Inc. e/ou seus criadores originais. Elas estĂŁo incluĂdas aqui de boa-fĂ©, sem finalidade comercial, com propĂłsito puramente informativo (uso nominativo/de identificação de produto), sem qualquer reivindicação de propriedade por parte deste projeto. Se vocĂŞ Ă© o titular dos direitos e deseja a remoção de alguma imagem, abra uma issue que ela será removida prontamente.
Esta aplicação foi criada para **uso pessoal**, para tirar o máximo proveito de um notebook Acer gaming no Linux — já que a Acer não oferece suporte oficial do PredatorSense para Linux. É compartilhada livremente para quem quiser o mesmo.
---
## Capturas de Tela
Dashboard — Foto do notebook e specs completas do sistema: CPU, GPU, RAM, armazenamento, rede e SO.
Temperaturas — Gauges em tempo real para CPU, GPU, sistema, SSDs NVMe, WiFi e RAM em uma única tela.
Consumo — CPU, GPU, memória e armazenamento com top processos, barras animadas e detalhes ao clicar (com animação de fogo CSS no gauge de temperatura).
Rede — Gráficos de download/upload em tempo real com tracking de picos e detecção automática de interface (Wi-Fi ou Ethernet).
Iluminação — Cores estáticas por zona (4 secções) e efeitos dinâmicos RGB do teclado (Respiração, Neon, Onda, Deslizar, Zoom).
Modos — Perfis de desempenho: Silencioso, Balanceado, Performance e Turbo (CPU governor + Intel EPP + limite de potência da GPU).
Controle de Ventoinha — RPM ao vivo com animação girando, toggle do CoolBoost e modos Auto/Max.
Bateria — Percentual de carga, voltagem, corrente, potência, ciclos, saúde, fabricante e limite de carga em 80% para preservar a longevidade.
GPU — Dashboard NVIDIA com gráficos ao vivo, clocks, utilização, VRAM, consumo e informações PCIe.
Gráficos — HistĂłrico detalhado de CPU e GPU com tracking de mĂnimas e máximas.
Assistente de IA (beta) — Assistente de IA local via Ollama: chat, gerenciador de modelos (listar instalados, baixar novos, escolher qual roda), consumo de recurso/VRAM ao vivo enquanto ele pensa, e log de ações persistente.
Configurações — Minimizar para a bandeja, iniciar com o sistema, aplicar perfil automaticamente no inĂcio, preferĂŞncias de idioma, e lista de recursos suportados por modelo.
Iluminação do logo da tampa — Controle RGB independente pro logo na parte de trás da tela, em modelos com logo colorido (Estático/Respiração/Neon). Detectado em tempo real: o controle só aparece se o hardware responder a um probe de capacidade, ficando escondido com segurança em modelos sem esse recurso.
Recurso contribuĂdo por @jlucaso1, testado no prĂłprio Predator PHN16-73 dele. O logo da tampa deste notebook do autor deste projeto nĂŁo tem cor, entĂŁo o recurso foi validado usando o hardware dele.
---
## Sobre
Módulo não oficial do kernel Linux para retroiluminação RGB de teclados Acer Gaming e modo Turbo (Acer Predator, Acer Helios, Acer Nitro).
Inspirado e baseado no projeto [acer-predator-turbo-and-rgb-keyboard-linux-module](https://github.com/JafarAkhondali/acer-predator-turbo-and-rgb-keyboard-linux-module) de [JafarAkhondali](https://github.com/JafarAkhondali) e contribuidores. Este projeto estende o módulo atual do kernel Linux Acer-WMI para oferecer suporte às funções de jogos da Acer, e adiciona uma **aplicação desktop completa** desenvolvida em Rust e GTK4.
---
## Funcionalidades
| Funcionalidade | Descrição |
|----------------|-----------|
| **Dashboard** | Foto do notebook + specs completas do sistema (CPU, GPU, RAM, armazenamento, rede, SO) |
| **Temperaturas** | Gauges em tempo real para CPU, GPU, sistema, NVMe, WiFi e RAM |
| **Consumo** | Visão em 4 abas: CPU / GPU / Memória / Armazenamento, com top processos, detalhes ao clicar e animação de fogo CSS no gauge de temperatura |
| **Rede** | Gráficos de download/upload em tempo real, com tracking de pico e detecção automática de interface |
| **Controle RGB do Teclado** | Cores estáticas por zona (4 zonas) e efeitos dinâmicos (Respiração, Neon, Onda, Deslizar, Zoom). Em hardware sem o módulo kernel (só controlador I2C-HID), cor estática, brilho, desligar luz e os efeitos Respiração/Neon também funcionam nativamente via HID — veja [Compatibilidade](#compatibilidade) |
| **Logo RGB da Tampa** | Controle independente de energia, cor estática, brilho, Respiração e Neon para o emblema atrás da tela, com prévia vetorial ao vivo. Só aparece após detecção de capacidades HID em tempo de execução |
| **Perfis de Desempenho** | Silencioso / Balanceado / Performance / Turbo (CPU governor + Intel EPP + limite de potĂŞncia da GPU) |
| **Controle de Ventoinha** | RPM ao vivo com animação girando, toggle do CoolBoost, modos Auto/Max, e controle PWM por ventoinha + curva automática por temperatura (experimental, onde suportado) |
| **Bateria** | EstatĂsticas de carga, ciclos, saĂşde, fabricante e limite de carga em 80% para preservar a longevidade |
| **Dashboard GPU** | Métricas NVIDIA: temperatura, utilização, VRAM, clocks, consumo, info PCIe com gráficos ao vivo, e **slider de limite de potência (TGP)** |
| **Gráficos** | HistĂłrico detalhado de CPU e GPU com tracking de mĂnimas e máximas |
| **Assistente de IA** 🧪 | Assistente de IA local e opt-in via [Ollama](https://ollama.com) — lê o estado do hardware em tempo real e sugere ou aplica mudanças através de um conjunto fixo de ações já validadas (perfil térmico, modo de ventoinha, CoolBoost, RGB, limite de potência da GPU, bateria). Chat, gerenciador de modelos (baixar/selecionar), monitor de recurso/VRAM ao vivo e log de ações persistente. Aplicar automaticamente ou sempre confirmar, você escolhe. Requer o Ollama instalado separadamente — veja [Assistente de IA](#assistente-de-ia-beta) abaixo |
| **Detecção automática de recursos** | Detecta o que cada modelo suporta e adapta a interface — recursos sem suporte aparecem como "nĂŁo disponĂvel neste modelo" em vez de erro. Os recursos suportados sĂŁo listados nas Configurações |
| **Alertas de temperatura** | Notificação no desktop quando CPU/GPU passam de 90°C (funciona na bandeja) |
| **Perfil automático por energia** | Troca de perfil automaticamente ao conectar/desconectar o carregador — perfil de cada estado é configurável em Configurações (padrão: Performance na tomada, Balanceado na bateria) |
| **Log de depuração** | Toggle opcional em Configurações — grava eventos do daemon e do app em `~/.local/share/predator-sense/` (rotacionado, 5MB×3) pra diagnóstico remoto. Desligado por padrão |
| **Bandeja do Sistema** | Minimizar para a bandeja com o Ăcone Predator — app continua vivo em segundo plano |
| **Tecla PredatorSense** | Mapeamento da tecla fĂsica — a tecla ao lado do NumLock abre a aplicação |
| **DKMS** | Módulos do kernel recompilam automaticamente em atualizações do kernel |
| **Internacionalização** | Inglês / Português automático baseado no idioma do sistema |
| **Interface Gaming** | Tema escuro com barras neon pulsantes, gauges circulares tracejados, bordas poligonais |
---
## Compatibilidade
**Vai funcionar no meu notebook?**
Legenda: ✅ testado e funcionando · 🟡 implementado, não testado (precisa de testador) · 🧪 experimental (precisa de testador) · ❌ não funciona · `-` não se aplica
| Modelo | Turbo (Impl.) | Turbo (Test.) | RGB (Impl.) | RGB (Test.) | Leitura RPM | Perfis de fan | Fan PWM % |
|--------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| AN515-45 | - | - | ✅ | ✅ | ❌ | - | ❌ |
| AN515-55 | - | - | ✅ | ✅ | ❌ | - | ❌ |
| AN515-56 | - | - | ✅ | ✅ | ❌ | - | ❌ |
| AN515-57 | - | - | ✅ | ✅ | ❌ | - | ❌ |
| AN515-58 | ✅ | 🟡 | ✅ | ✅ | 🟡 | 🟡 | 🧪 |
| AN517-41 | - | - | ✅ | ✅ | ❌ | - | ❌ |
| PH16-71 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | - | ❌ |
| PH315-52 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| PH315-53 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| **PH315-54** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| PH315-55 | ✅ | 🟡 | ✅ | ❌ | 🟡 | - | ❌ |
| PH317-53 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| PH317-54 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | - | ❌ |
| PH317-55 | - | - | ✅ | 🟡 | ❌ | - | ❌ |
| PH517-51 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | - | ❌ |
| PH517-52 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | - | ❌ |
| PH517-61 | ✅ | 🟡 | ✅ | ✅ | 🟡 | - | ❌ |
| PHN16-71 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | - | ❌ |
| PHN16S-71 | ✅ | ✅ | ✅ | 🟡 | ✅ | - | ❌ |
| PHN16-72 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | 🟡 | 🧪 |
| **PHN16-73** | ✅ | 🟡 | ✅ | 🟡 | 🟡 | 🟡 | 🧪 |
| PHN18-71 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| PT314-51 | ❌ | ❌ | ✅ | ✅ | 🟡 | - | ❌ |
| PT314-52s | ✅ | ✅ | ✅ | 🟡 | 🟡 | - | ❌ |
| PT315-51 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| PT316-51 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| PT515-51 | ✅ | ✅ | ✅ | ✅ | 🟡 | - | ❌ |
| PT516-52s | ✅ | 🟡 | ✅ | ✅ | 🟡 | - | ❌ |
| PT917-71 | ✅ | 🟡 | ✅ | 🟡 | 🟡 | - | ❌ |
> Se o seu modelo nĂŁo está listado, ele ainda pode funcionar — o mĂłdulo do kernel detecta interfaces WMI compatĂveis automaticamente. Se funcionou (ou nĂŁo) para vocĂŞ, por favor abra uma issue mencionando seu modelo para que possamos atualizar esta tabela.
### Controle de ventoinha — trĂŞs nĂveis
| NĂvel | O que faz | Disponibilidade |
|---|---|---|
| **Leitura de RPM** | LĂŞ velocidade das ventoinhas CPU/GPU (`fan1_input`, `fan2_input`) | Maioria dos modelos gaming (auto-detectado) |
| **Perfis de ventoinha** | Quiet / Balanced / Performance / Turbo via `platform_profile` | Modelos `predator_v4` |
| **Fan PWM %** 🧪 | Controle de velocidade por ventoinha (`pwm1`/`pwm2` 0–100%) portado do `acer-wmi` mainline via WMI — **somente kernel ≥ 6.14** | Subconjunto de modelos com `ACER_CAP_PWM` (AN515-58, PHN16-72/73, …) |
> **🧪 O controle PWM é experimental.** É portado do driver `acer-wmi` oficial do kernel Linux e usa métodos WMI seguros (sem escrita bruta no EC), mas **não foi verificado em hardware real** pelo mantenedor (que tem um PH315-54, sem PWM). Se você tem um modelo suportado, relatos de teste são muito bem-vindos. **Use por sua conta e risco** — veja o aviso no topo.
### RGB sem o mĂłdulo kernel (sĂł hardware I2C-HID)
Alguns modelos (confirmado: PHN16S-71, PHN16-73) roteiam o controlador RGB do teclado por um chip I2C-HID separado (ENEK5130) em vez da interface WMI do `facer.ko` — o app fala direto com ele via `/dev/hidrawN`, então funciona mesmo sem o módulo kernel carregado:
| Recurso | Status |
|---|---|
| Cor estática por zona, brilho, desligar luz | ✅ confirmado funcionando (PHN16S-71) |
| Efeitos dinâmicos — Respiração, Neon 🧪 | Nativo, um único write HID, hardware faz o loop do padrão sozinho — **aguardando confirmação** em hardware real |
| Efeitos dinâmicos — Onda, Deslizar, Zoom | Só prévia visual na tela (sem escrita em hardware) — os códigos desses efeitos variam de significado entre gerações de hardware, então ainda não foram ativados |
| Logo RGB da tampa — desligar, cor estática, brilho, Respiração, Neon | ✅ confirmado funcionando (PHN16-73) |
O suporte ao logo da tampa não é ativado por uma allow-list de modelos. O controlador precisa anunciar o alvo `0x83` no relatório A1 e retornar capacidades A3 correspondentes e não vazias antes que a interface apareça; o app repete essa verificação imediatamente antes de cada escrita. O daemon de hotkey restaura somente uma configuração que o app aplicou com sucesso após login e retorno do modo de suspensão, e ignora totalmente o logo quando não há configuração salva ou o alvo está ausente.
### Já usa Linuwu-Sense ou DAMX?
[Linuwu-Sense](https://github.com/0x7375646F/Linuwu-Sense) (e o [DAMX](https://github.com/PXDiv/Div-Acer-Manager-Max), construĂdo sobre ele) Ă© um projeto separado e nĂŁo relacionado, que tambĂ©m controla hardware Acer Predator/Nitro no Linux. NĂŁo Ă© dependĂŞncia deste projeto, nenhum cĂłdigo dele Ă© usado aqui — mas o mĂłdulo kernel dele reivindica os **mesmos GUIDs WMI** que o `facer` precisa, e o kernel nĂŁo deixa dois drivers reivindicarem o mesmo dispositivo ao mesmo tempo.
Se o instalador detectar `linuwu_sense` já carregado ou registrado via DKMS, ele automaticamente **não mexe** na sua instalação existente — não coloca `acer_wmi` na blacklist nem força carregar `facer`, então não briga (nem quebra) uma instalação Linuwu-Sense/DAMX que já funciona. O RGB do teclado continua funcionando por este app via HID (ver acima) independente de qual driver de plataforma está ativo; controle de ventoinha/térmico nesse caso continua com a ferramenta que você já usava.
---
## Instalação
### Instalador Pré-compilado (Mais Rápido)
Baixe diretamente o instalador da release e execute:
```console
curl --fail --location https://github.com/cleyton1986/predator-sense/releases/latest/download/predator-sense-installer --output predator-sense-installer
chmod +x predator-sense-installer
sudo ./predator-sense-installer --install
```
O instalador, o helper privilegiado, o listener da tecla e o serviço da bandeja são fornecidos pelo mesmo binário multicall em Rust. O instalador baixa e configura tudo sem depender de um script de shell para o bootstrap.
### Instalador Interativo (binário pré-compilado, sem precisar de Rust)
Baixe o binário `predator-sense-installer` da página de [Releases](../../releases). É um binário Rust independente, não um pacote fechado — ainda precisa de internet pra baixar o código fonte do app (por causa do módulo kernel) e o binário pré-compilado da release correspondente, mas não instala Rust nem compila o app GTK4 na sua máquina:
```console
chmod +x predator-sense-installer
sudo ./predator-sense-installer
```
Selecione a **opção 1** (Instalação completa). O instalador irá automaticamente:
1. Detectar sua distribuição (Debian/Ubuntu/Mint, Fedora, Arch)
2. Instalar dependências do sistema (GTK4, libadwaita, ferramentas de compilação, headers do kernel)
3. Baixar o código fonte + binário pré-compilado da release correspondente
4. Compilar e carregar o módulo do kernel `facer` (essa parte sempre compila localmente — módulo de kernel não dá pra distribuir pré-compilado entre versões de kernel diferentes)
5. Criar atalho no menu de aplicações com Ăcone
6. Mapear a tecla PredatorSense (inicia automaticamente no login)
7. Configurar suporte Ă bandeja do sistema
O caminho pré-compilado não precisa de Rust/cargo na máquina de destino. O instalador também é copiado para `/opt/predator-sense/` como ferramenta de gerenciamento para consultar status, recarregar o módulo do kernel, atualizar e desinstalar (ver [Opções do Instalador](#opções-do-instalador)).
Após a instalação, abra a aplicação por:
- Pressionando a **tecla PredatorSense** (ao lado do NumLock)
- Buscando **"Predator Sense"** no menu de aplicações
- Executando `/opt/predator-sense/predator-sense` no terminal
### Instalação Manual (Compilar do código fonte)
#### Pré-requisitos
Debian / Ubuntu / Linux Mint
```console
sudo apt install libgtk-4-dev libadwaita-1-dev pkg-config build-essential \
gcc make dkms curl tar linux-headers-$(uname -r)
```
Fedora
```console
sudo dnf install gtk4-devel libadwaita-devel pkg-config gcc make \
dkms curl tar kernel-devel-$(uname -r)
```
Arch Linux
```console
sudo pacman -S gtk4 libadwaita pkgconf gcc make dkms curl tar linux-headers
```
**Rust** (se nĂŁo instalado):
```console
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
```
#### Compilar e Instalar
```console
# Clonar o repositĂłrio
git clone https://github.com/cleyton1986/predator-sense.git
cd predator-sense/predator-sense-gui
# Compilar a GUI e o instalador/serviços Rust
cargo build --release
cargo build --release --manifest-path installer/Cargo.toml
# Instalar o build local e registrar os fontes C existentes no DKMS
sudo installer/target/release/predator-sense-installer --install
# Executar
/opt/predator-sense/predator-sense
```
---
## Como Usar
### RGB do Teclado
1. Vá em **Iluminação** no menu lateral
2. Escolha **Estático** (cores por zona) ou **Dinâmico** (efeitos)
3. **Modo Estático:** ajuste os sliders R/G/B para cada uma das 4 secções do teclado
4. **Modo Dinâmico:** selecione um efeito (Respiração, Neon, Onda, Deslizar, Zoom) e ajuste a velocidade
5. Clique em **Aplicar**
> Em hardware sĂł I2C-HID sem o mĂłdulo kernel (veja [Compatibilidade](#compatibilidade)), Respiração e Neon animam de verdade; Onda/Deslizar/Zoom mostram sĂł prĂ©via visual, claramente rotulada como tal — o teclado fĂsico ainda nĂŁo muda pra esses.
### Logo RGB da Tampa
1. Vá em **Iluminação** e selecione **Logo da tampa** (o seletor sĂł aparece quando o alvo HID compatĂvel Ă© detectado)
2. Use **Iluminação** para ligar ou desligar o emblema
3. Escolha **Estático**, **Respiração** ou **Neon** e ajuste os controles disponĂveis de cor, brilho e velocidade acompanhando a prĂ©via ao vivo
4. Clique em **Aplicar no logo**
O último estado aplicado com sucesso é restaurado quando o serviço de hotkey do usuário inicia e após suspensão/hibernação. As cores dos efeitos animados são controladas pelo firmware; por isso a prévia representa o comportamento deles e o seletor de cor fica reservado ao modo estático.
> O firmware controla a animação exibida antes de o Linux iniciar o serviço do usuário. Um estado “desligado” salvo é restaurado após o login, mas o app não consegue suprimir a animação anterior do BIOS/boot.
### Perfis de Desempenho
Em sistemas com Intel P-State ativo + HWP, a parte de CPU Ă© resolvida assim:
| Perfil | PolĂtica HWP | Intel EPP | Performance mĂnima | GPU Power | Ventoinha | Uso |
|--------|--------------|-----------|--------------------|-----------|-----------|-----|
| **Silencioso** | powersave | power | 10% | 40W³ | Automático | Trabalho silencioso |
| **Balanceado** | powersave | balance_performance | 17% | 80W³ | Automático | Uso geral |
| **Performance** | powersave¹ | performance | 50% | 100W³ | Máx | Jogos |
| **Turbo** | performance² | 0 (forçado pelo kernel) | 100% | 110W³ | Máx | Performance máxima |
Selecionar qualquer perfil já aplica o modo de ventoinha junto - sem passo
separado. Performance e Turbo colocam a ventoinha em Máx (igual Ă tecla fĂsica
Turbo); Silencioso e Balanceado deixam em Automático.
Âą A polĂtica HWP `powersave` do Intel P-State Ă© um algoritmo de escalonamento
dinâmico, nĂŁo o governor genĂ©rico que fixa a frequĂŞncia mĂnima. Ela mantĂ©m o
EPP nominal especĂfico do modelo gravável e torna Performance uma faixa
dinâmica de 50% até o máximo.
² A prĂłpria polĂtica HWP `performance` força EPP 0 e restringe a faixa de
P-states ao limite superior. O Predator Sense usa esse comportamento garantido
pelo kernel em vez de exigir escrita numérica de EPP. O backend é detectado em
todas as polĂticas cpufreq, sem uma lista de modelos de CPU. Outros drivers
mantĂŞm o mapeamento existente `performance` + EPP nominal `performance`, e
sistemas sem EPP ignoram apenas esse controle opcional.
³ Melhor esforço via `nvidia-smi -pl`, mesmo mecanismo do slider de limite de
potĂŞncia do Dashboard GPU - pulado silenciosamente se `nvidia-smi` nĂŁo existir,
e em alguns notebooks a vBIOS nunca expõe o controle de limite de potência que
o NVML precisa (`nvidia-smi -q` mostra `Power Management Object: N/A`, todo
valor de `-pl` é rejeitado independente do que for pedido). É limite de
firmware, nĂŁo algo que este app - ou qualquer software Linux - consiga mudar;
aumentar isso exige flashear uma vBIOS diferente com ferramenta Windows-only
como `nvflash`, risco real de brickar a GPU, decisĂŁo exclusivamente do dono do
hardware.
### Perfil automático por energia
Quando ativado em Configurações (ligado por padrão em instalações novas), não
é só reação a plugar/desplugar - é aplicado continuamente:
- **Na tomada:** sempre Performance ou Turbo. Se um dos dois já estiver ativo,
fica como está - o auto-switch nunca briga com uma escolha manual entre os
dois.
- **Na bateria:** sempre Balanceado ou Silencioso, nunca Performance/Turbo.
Abaixo de 15% de bateria, força Silencioso independente do que estiver
configurado.
### Dashboard GPU
Monitoramento NVIDIA em tempo real:
- Temperatura, utilização, uso de VRAM, consumo (gauges circulares)
- Gráficos de histórico de temperatura e utilização (janela de 2 minutos)
- Clock do nĂşcleo, clock da memĂłria, P-State, link PCIe, versĂŁo do VBIOS
### Assistente de IA (beta)
Um assistente de IA local e opt-in, via [Ollama](https://ollama.com) rodando inteiramente na sua máquina — nada é enviado pra lugar nenhum.
1. Instale o Ollama separadamente seguindo as [instruções oficiais para Linux](https://ollama.com/download/linux)
2. Vá em **IA** no menu lateral e baixe um modelo pelo gerenciador de modelos integrado (`smollm2:1.7b` ou maior — modelos menores não suportam tool-calling de forma confiável)
3. Ative o assistente em **Configurações** e escolha **Aplicar automaticamente** (aplica sugestões na hora) ou **Sempre confirmar** (padrão — toda mudança sugerida espera sua aprovação)
O assistente lê o estado do hardware em tempo real (temperatura, ventoinha, perfil térmico, bateria) e pode sugerir ou aplicar mudanças através de um conjunto fixo de ações já validadas — nunca acessa hardware/EC diretamente, e cada ação corresponde 1:1 a uma função que esta aplicação já usava antes mesmo da IA existir. O modelo carrega só pra rodar uma análise e depois descarrega — não fica parado consumindo memória. Toda atividade da IA fica registrada num log de ações persistente e revisável, na mesma página.
---
## Opções do Instalador
O instalador Rust oferece um menu interativo:
```console
sudo ./predator-sense-installer # Menu interativo
sudo ./predator-sense-installer --install # Instalação direta
sudo ./predator-sense-installer --uninstall # Remover tudo
sudo ./predator-sense-installer --reload-module # Recompilar/recarregar o mĂłdulo
sudo ./predator-sense-installer --status # Ver status dos componentes
```
---
## Desinstalar
```console
sudo ./predator-sense-installer # Selecione a opção 2
```
Ou manualmente:
```console
pkill -f "/opt/predator-sense/predator-sense"
sudo rm -rf /opt/predator-sense
sudo rm -f /usr/share/applications/predator-sense.desktop
sudo rm -f /usr/share/icons/hicolor/128x128/apps/predator-sense.png
rm -f ~/.config/systemd/user/predator-sense-hotkey.service
rm -f ~/.config/autostart/predator-sense-hotkey.desktop
sudo rmmod facer # Opcional: descarregar o mĂłdulo do kernel
```
---
## Solução de Problemas
RGB do teclado nĂŁo muda / preso em um efeito
O estado do mĂłdulo do kernel pode estar travado. Recarregue-o:
```console
sudo rmmod facer
sudo insmod /caminho/para/kernel/facer.ko
# Ou use o instalador: sudo ./predator-sense-installer → Opção 4
```
MĂłdulo nĂŁo carrega
```console
# Verifique se o dispositivo WMI existe
ls /sys/bus/wmi/devices/7A4DDFE7-5B5D-40B4-8595-4408E0CC7F56/
# Verifique os logs do kernel
sudo dmesg | grep -i facer
# Certifique-se que os headers correspondem ao seu kernel
sudo apt install linux-headers-$(uname -r)
```
Tecla PredatorSense nĂŁo funciona
```console
# Verifique o serviço Rust da tecla
systemctl --user status predator-sense-hotkey.service
pgrep -af predator-sense-hotkey
# Certifique-se que o usuário está no grupo 'input' (logout necessário após adicionar)
groups | grep input
sudo usermod -aG input $USER
```
Página GPU não mostra dados
```console
# Verifique se o nvidia-smi funciona
nvidia-smi
# Se não, instale os drivers proprietários da NVIDIA
```
Meu modelo nĂŁo tem quirk correspondente (sem perfis/leitura de fan/PWM)
Se seu modelo exato ainda nĂŁo está na lista de compatibilidade, tente forçar todos os recursos opcionais da famĂlia `predator_v4` e veja o que funciona no seu hardware:
```console
sudo modprobe facer enable_all=1
# persistente entre reboots:
echo "options facer enable_all=1" | sudo tee /etc/modprobe.d/facer-options.conf
```
É só WMI (sem escrita raw na EC), então em hardware que não implementa determinado recurso isso é um no-op seguro, não uma escrita ruim. Por favor [abra uma issue](https://github.com/cleyton1986/predator-sense/issues) com seu modelo e o que funcionou/não funcionou — é assim que novos quirks são adicionados.
---
## Estrutura do Projeto
```
predator-sense-gui/
├── kernel/ # Módulos do kernel Linux (gerenciados por DKMS)
│ ├── facer.c # Interface ACPI/WMI com o hardware Acer
│ ├── acer-wmi-battery.c # Suporte ao limite de carga da bateria
│ ├── acpi_ec.c # Acesso raw ao EC via /dev/ec (de MusiKid/acpi_ec)
│ ├── Makefile
│ └── dkms.conf # Config DKMS para recompilação automática
├── installer/ # Instalador e serviços multicall em Rust
│ ├── Cargo.toml
│ └── src/
│ ├── main.rs # Dispatch tipado pelo nome do executável instalado
│ ├── constants.rs # Caminhos, protocolos e constantes de hardware centrais
│ ├── install.rs # Instalador + registro DKMS
│ ├── helper.rs # Operações privilegiadas validadas
│ ├── hotkey.rs # Listener de eventos de input do Linux
│ ├── tray.rs # Serviço StatusNotifierItem
│ └── i18n.rs # Mensagens EN/PT tipadas
├── protocol/ # Contrato tipado compartilhado entre GUI/helper
│ ├── Cargo.toml
│ └── src/lib.rs # Ações, caminhos, limites e nomes dos binários
├── src/ # Aplicação Rust GTK4
│ ├── main.rs
│ ├── app_state.rs # Flag global de visibilidade da janela (gate dos timers)
│ ├── i18n.rs # Internacionalização EN/PT
│ ├── config.rs # Preferências do usuário (JSON)
│ ├── tray.rs # Ciclo de vida do serviço Rust da bandeja
│ ├── hardware/
│ │ ├── helper.rs # Cliente tipado do helper privilegiado
│ │ ├── rgb.rs # RGB via /dev/acer-gkbbl-*
│ │ ├── hwmon.rs # Índice /sys/class/hwmon (cacheado em OnceLock)
│ │ ├── sensors.rs # Temps, fans, RAM, rede
│ │ ├── gpu.rs # Parser do nvidia-smi com cache TTL
│ │ ├── procs.rs # Sampler /proc (CPU por core, memória, lista de processos)
│ │ ├── storage.rs # Uso de disco via df
│ │ ├── sysinfo.rs # DMI + CPU + GPU + specs do SO
│ │ ├── fan.rs # Modo de ventoinha + CoolBoost
│ │ ├── extras.rs # Limite de bateria, LCD overdrive, USB charging, boot anim
│ │ ├── profile.rs # CPU governor + EPP + GPU power
│ │ ├── ai_assistant.rs # Tool-calling do Ollama: allow-list fixa mapeada pras funções hardware:: já existentes
│ │ ├── ai_snapshot.rs # Snapshot efêmero do estado, alimentado à IA e apagado a cada leitura
│ │ ├── ai_actionlog.rs # Log persistente e revisável de tudo que a IA sugeriu/aplicou
│ │ └── setup.rs # Gerenciamento do módulo kernel
│ └── ui/ # Páginas GTK4 (widgets Cairo customizados)
│ ├── window.rs # Janela principal, sidebar, barras neon, hide-to-tray
│ ├── dashboard_page.rs # Hero + specs do sistema
│ ├── temperatures_page.rs # Todos os gauges de temperatura
│ ├── usage_page.rs # CPU/GPU/Mem/Storage com top processos
│ ├── network_page.rs # Download/upload com tracking de pico
│ ├── rgb_page.rs # RGB do teclado com zonas visuais
│ ├── fan_control_page.rs # Ventoinhas animadas + CoolBoost
│ ├── fan_page.rs # Perfis de desempenho
│ ├── battery_page.rs # Stats da bateria + limite de carga
│ ├── gpu_page.rs # Dashboard NVIDIA GPU
│ ├── monitor_page.rs # Gráficos detalhados de histórico CPU/GPU
│ ├── ai_page.rs # Assistente de IA: chat, gerenciador de modelos, monitor de recurso, log de ações
│ ├── setup_page.rs # Wizard de setup do módulo kernel
│ └── gauge_widget.rs # Widget de gauge circular tracejado
└── resources/
├── style.css # Tema escuro gaming
└── predator-icon.svg # Ícone da bandeja
```
---
## Créditos e Agradecimentos
- **MĂłdulo do kernel `facer`** baseado no projeto [acer-predator-turbo-and-rgb-keyboard-linux-module](https://github.com/JafarAkhondali/acer-predator-turbo-and-rgb-keyboard-linux-module) de [JafarAkhondali](https://github.com/JafarAkhondali) e [todos os contribuidores](https://github.com/JafarAkhondali/acer-predator-turbo-and-rgb-keyboard-linux-module/graphs/contributors)
- **Módulo do kernel `acpi_ec`** de [Sayafdine Said (MusiKid)](https://github.com/MusiKid/acpi_ec) — expõe `/dev/ec` para leitura/escrita bruta no EC. Usado pelo helper para definir modos de ventoinha, CoolBoost, LCD overdrive, USB charging e animação de boot.
- **Aplicação GUI** desenvolvida com [Rust](https://www.rust-lang.org/) + [GTK4](https://gtk.org/) + [libadwaita](https://gnome.pages.gitlab.gnome.org/libadwaita/)
- **Instalador e serviços de background** desenvolvidos com [Rust](https://www.rust-lang.org/); a bandeja usa [ksni](https://crates.io/crates/ksni)
### Fazendo fork ou reaproveitando este projeto
Este projeto Ă© licenciado sob GPL-3.0, entĂŁo vocĂŞ Ă© livre pra fazer fork, modificar e redistribuir sob a mesma licença. Se fizer isso — principalmente se construir um app derivado ou reaproveitar partes significativas da GUI/mĂłdulo do kernel — **por favor mantenha um crĂ©dito visĂvel ao autor original** (uma menção a [Cleyton Alves](https://github.com/cleyton1986) / este repositĂłrio no seu README, tela Sobre, ou seção de crĂ©ditos já resolve). É um pedido pequeno que faz bastante diferença pra um projeto paralelo independente e nĂŁo remunerado.
## Apoie o Projeto
Se este projeto foi útil para você e gostaria de apoiar o desenvolvimento, considere me pagar um café:
PIX: cleyton1986@gmail.com
Qualquer contribuição é voluntária e muito apreciada! Ajuda a manter o projeto vivo e motiva novas funcionalidades.
---
## Licença
Este projeto é licenciado sob a **GNU General Public License v3.0** — veja o arquivo [LICENSE](LICENSE) para detalhes.
Este Ă© software livre: vocĂŞ pode redistribuĂ-lo e/ou modificá-lo sob os termos da GNU GPL conforme publicada pela Free Software Foundation.
**Exceção — imagens dos produtos:** a licença GPLv3 acima cobre apenas o código-fonte deste projeto. As fotos de notebooks Acer Predator/Nitro em `predator-sense-gui/resources/models/` são imagens de produto de terceiros (veja [Aviso Legal](#aviso-legal) acima) e **não** estão cobertas pela concessão da GPLv3; todos os direitos sobre essas imagens permanecem com a Acer Inc. e/ou os fotógrafos originais.
**Este software é fornecido "como está", sem garantia de qualquer tipo.** Os autores não se responsabilizam por quaisquer danos que possam ocorrer pelo uso deste software. Ao instalar e usar este software, você reconhece que o faz por sua conta e risco.