Skip to content

About

Substituto leve e moderno para o G-Menu da AOC. Controle nativo de brilho, cores e overdrive via DDC/CI, troca inteligente de perfil por jogo (.exe) mesmo em modo Administrador, execução em segundo plano na bandeja e travas de firmware fiéis ao hardware.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🖥️ AOC Control Studio

Software moderno, leve e ultrarrápido para controle nativo de hardware, modos de imagem e automação para monitores gamers AOC (como o AOC 24G2S).

Tauri v2 Rust React 19 TypeScript Tailwind CSS Windows Linux


📖 Visão Geral

O AOC Control Studio nasceu da necessidade de substituir softwares pesados e instáveis de fabricantes por uma solução moderna, nativa e de baixo consumo de recursos. Utilizando comunicação direta via DDC/CI (protocolo I2C da placa de vídeo para o monitor) e APIs gráficas do Windows, o software envia comandos diretamente ao microcontrolador do monitor sem exigir cliques nos botões físicos do aparelho.

Além do controle manual de imagem, o projeto traz um sistema inteligente de automação de perfis por aplicativo (.exe): ao entrar em um jogo, o monitor muda instantaneamente suas configurações de imagem e tempo de resposta; ao retornar à Área de Trabalho, volta sozinho para o perfil padrão do Windows.


✨ Recursos Principais

🎮 Modos de Imagem Pré-configurados e Customizados

  • FPS Competitivo: Máxima visibilidade com Overdrive forte, Shadow Control calibrado e Mira no centro da tela.
  • RTS / MOBA: Cores realçadas (Game Color), tempo de resposta balanceado e FreeSync ativo.
  • Corrida / Imersão: Saturação de cores vívida e alta fluidez sem tearing.
  • Trabalho / Leitura: Redução do brilho e filtro de luz azul (Low Blue Light) para prevenir fadiga ocular.
  • Cinema / Vídeo: Gamma 3 e temperatura de cor quente com contraste dinâmico.
  • Modos Customizados Ilimitados: Crie, edite e nomeie perfis livremente conforme a sua preferência.

⚡ Automação Inteligente por Executável (.exe)

  • Troca Automática em Tempo Real: Detecta a janela em primeiro plano e aplica o perfil correto em milissegundos.
  • Retorno ao Perfil Padrão do Windows: Escolha qual perfil você quer na Área de Trabalho e o app restaura ele assim que fechar os jogos.
  • Toggle Individual por Perfil: Ative ou pause a troca automática de cada perfil diretamente pelo card na tela inicial, sem precisar remover os executáveis cadastrados.
  • Detecção com Suporte a Jogos em Modo Administrador: Inspeção profunda via snapshot de kernel (Toolhelp32Snapshot) e ativação automática de privilégios (SeDebugPrivilege), garantindo que até jogos rodando como Administrador ou com anti-cheats (Vanguard, BattlEye, EAC) sejam detectados mesmo com o app aberto em modo de usuário comum.

🛡️ Proteções e Travas de Hardware Fiéis ao Firmware AOC

O monitor possui regras internas que cancelam modos caso comandos conflitantes sejam enviados. O AOC Control Studio respeita e avisa sobre todas elas:

  • Modo de Jogo AOC: Ao ativar FPS, RTS, Corrida ou Gamer 1..3, o firmware bloqueia Brilho, Contraste, Gamma, Modo ECO, DCR, Shadow Control, Overdrive, Game Color e Modo HDR.
  • Modo HDR: Perfis HDR integrados assumem a calibração do painel, travando Gamma, Modo ECO, Contraste, Modo de Jogo AOC, Shadow Control, Game Color e Low Blue Light.
  • Modo ECO: Perfis de economia travam os ajustes de Brilho e Contraste.

🪟 Interface Nativa Moderna

  • Barra de Título Customizada: Visual limpo e semântico com arrasto suave nativo do sistema operacional.
  • Integração com a Bandeja do Sistema (Tray): O ícone permanece sempre ativo ao lado do relógio do Windows. Clicar no X da janela oculta o aplicativo na bandeja, mantendo a automação ativa em segundo plano sem poluir a barra de tarefas.
  • Scrollbar Moderna: Design discreto e minimalista integrado ao tema escuro.

🛠️ Tecnologias Utilizadas


📦 Como Compilar e Distribuir

Note

Execute os comandos no PowerShell na raiz do projeto (AOC Menu Corrigido). Para sua conveniência, incluímos o script automatizado .\build.ps1, que resolve automaticamente os caminhos com espaços no Windows e gera os arquivos finais na pasta .\Distribuicao.

Instalação das Dependências

Antes de compilar pela primeira vez, instale as dependências:

pnpm install

Executar em Modo de Desenvolvimento (Opcional)

pnpm tauri dev

Gerar Versão Portátil (.zip pronto para uso)

Compila o executável release e empacota automaticamente junto à WebView2Loader.dll dentro de .\Distribuicao\AOC-Control-Studio-Portable.zip:

.\build.ps1 -Type portable

Gerar Instalador (.exe Setup via NSIS)

Compila e gera o instalador padrão do Windows com assistente de instalação, atalhos no Desktop/Iniciar e desinstalador limpo:

.\build.ps1 -Type nsis

O instalador será gerado em .\Distribuicao\AOC-Control-Studio-Setup.exe.


Gerar Pacote Corporativo Windows Installer (.msi)

Gera o pacote .msi para instalações corporativas ou silenciosas:

.\build.ps1 -Type msi

O pacote será gerado em .\Distribuicao\AOC-Control-Studio.msi.


Gerar Todos os Formatos de uma só vez (Setup, Portable e MSI)

.\build.ps1 -Type all

🐧 Linux (Wayland / X11)

Ambiente de referência: Pop!_OS 24.04 (COSMIC, Wayland) com Radeon RX 6600 e AOC 24G2 via DisplayPort. O backend Linux fala DDC/CI diretamente com o monitor através do /dev/i2c-* (módulo i2c-dev), descobrindo o barramento certo pelo conector DRM (/sys/class/drm/cardN-DP-X) e pelo EDID.

1. Preparar o sistema (uma única vez)

sudo ./scripts/setup-linux.sh            # dependências de build (WebKitGTK etc.) + acesso I2C
sudo ./scripts/setup-linux.sh --no-deps  # apenas acesso I2C (quem só vai usar o app)

O script carrega o i2c-dev (agora e no boot) e instala uma regra udev (uaccess) que libera os barramentos I2C da placa de vídeo para o usuário logado — sem rodar o app como root. Os pacotes .deb/.rpm já instalam essa regra automaticamente.

2. Desenvolvimento e build

pnpm install
pnpm tauri dev           # modo desenvolvimento
./build.sh               # binário portátil + .deb + .AppImage + .rpm em ./Distribuicao
./build.sh deb           # ou: portable | appimage | rpm

Diferenças em relação ao Windows

Recurso Linux
Controles DDC/CI e TPV (F8 E1) ✅ Idênticos ao Windows (I2C direto)
Automação por app Janela em foco via X11/XWayland (jogos Steam/Proton/Wine). Com foco em janela Wayland nativa, o perfil é escolhido pelo executável vinculado que estiver em execução
Nomes de executáveis cs2.exe (Proton) e cs2 (nativo) são equivalentes — a extensão .exe é ignorada na comparação
FreeSync / VRR Via compositor: cosmic-randr (COSMIC) ou kscreen-doctor (KDE)
HDR do sistema Controlado pelo compositor; os perfis HDR do monitor (Picture/Movie/Game) funcionam normalmente
Logs ~/.local/state/aoc-control-studio/aoc_debug.log

💡 Modo Verbose (Depuração)

Para executar o software visualizando logs detalhados de DDC/CI, detecção de processos e chamadas de hardware no terminal:

.\AOC-Control-Studio.exe -v

(Também é gravado automaticamente o arquivo aoc_debug.log no diretório de execução).


🤝 Créditos e Agradecimentos

  • reverse-engineer-anything (REA): Agradecimento especial às ferramentas e metodologias de engenharia reversa do REA, fundamentais para a análise e recuperação dos opcodes proprietários de hardware (tabelas TPV VCP 0xF8 / 0xE1, opcodes de saturação Game Color, controle de sombras Shadow Control, curvas de Gamma e perfis de HDR Mode do microcontrolador AOC).
  • Comunidade Tauri & Rust: Pela infraestrutura desktop moderna de alto desempenho e baixíssimo consumo de memória RAM.

📄 Licença

Distribuído sob a licença MIT.

About

Substituto leve e moderno para o G-Menu da AOC. Controle nativo de brilho, cores e overdrive via DDC/CI, troca inteligente de perfil por jogo (.exe) mesmo em modo Administrador, execução em segundo plano na bandeja e travas de firmware fiéis ao hardware.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages