Plugin OmaWhatsApp no Omarchy

O OmaWhatsApp é um cliente de WhatsApp nativo do shell, sem aba de navegador e sem Electron. As conversas ficam em um espelho local mantido pelo wacli, e o aplicativo desenha esse espelho em Quickshell com as cores e as fontes do tema do Omarchy.

A janela abre sem esperar a rede, porque lê o espelho em SQLite. Mensagens novas aparecem quando a sincronização grava, e pausar a sincronização mantém o arquivo legível e pesquisável. O plugin não tem servidor próprio nem telemetria, e as mensagens passam apenas pelo WhatsApp.

Antes de instalar

O catálogo registra a instalação como manual porque as dependências vêm antes do plugin. Você precisa de Omarchy 4 Quattro com shell Quickshell, do wacli 0.17.1 ou mais recente e do pacote wacli-bin da AUR.

Enviar mensagens, editar e anexar com legenda exige o build privado do wacli 0.19.0 mantido pelo projeto, com a fonte fixada e o patch incluído no repositório. O wacli-bin sozinho lê um arquivo existente, mas não mostra o código QR para vincular o celular.

Instale as dependências e o plugin

1
omarchy pkg add gcc pkgconf ffmpeg
2
omarchy pkg aur add wacli-bin
3
omarchy plugin add https://github.com/MoizIbnYousaf/Omarchy-Whatsapp --enable

Os editores seguros de texto e o processo de mídia são compilados localmente contra o Qt instalado na primeira abertura, e recompilados depois de uma atualização do Qt. Nada é baixado durante essa compilação. As prévias de mídia usam processos filhos com limites, e o FFmpeg regera as prévias de áudio e vídeo sem os metadados originais.

Vincule o celular

Na primeira abertura, o aplicativo conduz o restante:

1. Set it up on this computer acrescenta, só na sua pasta pessoal, a sincronização em segundo plano, o comando omawhatsapp e, se você permitir, a skill de agente e o servidor MCP.
2. Link your phone abre o código QR em um terminal. Escaneie em WhatsApp, Dispositivos conectados, no celular.

Para abrir pelo teclado, copie a linha de Super+Shift+W do arquivo omarchy/bindings.lua.example do repositório para ~/.config/hypr/bindings.lua.

Responda pela barra

O clique no ícone abre o cliente compacto, com conversas recentes, a conversa e um campo de resposta com anexos, emojis e nota de voz. A maior parte das respostas não precisa da janela cheia.

O aplicativo cobre o uso do dia: respostas, edições, reações, enquetes, figurinhas, álbuns, até dez arquivos com legenda, menções com @, notas de voz revisadas antes do envio, encaminhamento para várias conversas com observação e exclusão de mensagens em conjunto.

A conversa na tela é marcada como lida, e responder confirma a leitura. O contato vê que você está digitando. As notificações do desktop escondem conteúdo privado, abrem a conversa no clique e podem ser respondidas pela barra. Conversas silenciadas e arquivadas ficam quietas.

As configurações de Shortcuts permitem trocar a tecla de cada uma das 37 ações, acrescentar alternativas e resolver conflitos.

Vários números na mesma lista

Você pode vincular mais de um número. A lista junta os números, cada um recebe uma cor, e cada um pausa a sincronização ou silencia as notificações de forma independente. A interface funciona de uma janela larga até 360 pixels, e Ctrl+Q encerra o aplicativo.

Agentes e automação

Com a permissão dada na configuração, o aplicativo cria a skill em ~/.agents/skills/omawhatsapp. Para clientes MCP, registre o servidor uma vez:

1
claude mcp add --scope user whatsapp -- ~/.local/bin/omawhatsapp-mcp

As 104 operações do wacli são classificadas em leitura local, leitura remota, escrita local, sincronização, escrita no WhatsApp, destrutiva e interativa. Leitura local roda sem confirmação, e o restante exige a sua autorização, com destinatário e texto à vista. O agente não escreve no banco do WhatsApp, não inventa destinatário e não repete um envio que pode ter saído.

Atualize e remova

A atualização também pode ser feita pela tela de configurações, que mostra as mudanças e exige confirmação. Pelo terminal:

1
omarchy plugin update io.github.moizibnyousaf.omawhatsapp && omarchy restart shell

Para remover, use Sync & storage, Remove from this computer, que encerra a sincronização e apaga o que a configuração criou, e depois Remove the app too, que executa:

1
omarchy plugin remove io.github.moizibnyousaf.omawhatsapp

O dispositivo vinculado e o arquivo de mensagens do wacli continuam no disco, então uma nova instalação retoma de onde parou. O aplicativo só substitui ou remove arquivos que ele mesmo gravou, e avisa quais foram.

O OmaWhatsApp é independente e não tem vínculo com o WhatsApp ou com a Meta.