Cliente XMPP para o Omarchy, feito em C++ e Qt Quick sobre a biblioteca QXmpp. Uma janela: seus contatos à esquerda e a conversa à direita.
-
Conversas 1:1 com histórico local (SQLite), notificações na área de trabalho e cópia das mensagens enviadas de outros dispositivos (carbons).
-
A barra lateral mostra só as conversas abertas, a mais recente no topo, com o trecho da última mensagem, como no Gajim. A busca (Ctrl+K ou Ctrl+T) passa por todos os contatos e salas, de forma aproximada ("jcp" acha "Jean Carlos Pereira", sem ligar para acentos), e Enter com um endereço completo começa uma conversa nova. Ctrl+W fecha a conversa; o histórico fica, e uma mensagem nova a abre de novo.
-
Apelido local (clique direito → "Definir apelido…"): um nome só neste computador, que aparece em todo lugar no lugar do nome do servidor, sem alterá-lo. Vazio volta ao nome do servidor.
-
Abaixo da busca, "Conversas | Contatos" escolhe o que a barra lateral mostra (Ctrl+Shift+K alterna, e a escolha fica salva): só as conversas abertas, para andar entre elas com Alt+↑/↓, ou todos os contatos por grupo, como no Gajim (salas, os grupos e "Sem grupo"). A busca procura em tudo e também acha pelo nome do grupo; o clique direito move um contato de grupo, no servidor.
-
A lista de contatos fica guardada e aparece na hora ao abrir, antes de conectar; o servidor só manda o que mudou (roster versioning).
-
Importa o histórico do Gajim (e do Omajim em Python) pelo menu ⋮: lê uma cópia do
logs.db, sem alterar o original, traz só a conta conectada e não repete mensagens que já estão aqui. -
Arrastar sobre o texto seleciona de uma mensagem a outra, como no ZapFast, e a conversa rola junto perto das bordas. Ctrl+C copia o trecho; se ele atravessa várias mensagens, cada uma vem com horário e nome:
[27/10/2026 14:33] Ana: texto. -
A conversa é separada por dias: Hoje, Ontem, o dia da semana e, antes disso, a data. O formato da data, que também vale na lista de conversas e ao copiar mensagens, se escolhe nas preferências; o padrão segue o idioma e a região do computador. Ao rolar, o dia da mensagem do topo fica flutuando até chegar ao separador dele, como no ZapFast.
-
O que fica escrito numa conversa espera nela como rascunho, com a formatação, mesmo depois de fechar o Omajim, como no Gajim e no ZapFast. A lista de conversas mostra "Rascunho:" e o texto.
-
Ctrl+F busca no histórico inteiro da conversa, sem ligar para acentos; Enter e Shift+Enter passam pelos resultados, trazendo as mensagens antigas quando preciso.
-
Ctrl+V com uma imagem (um print, por exemplo) ou com arquivos copiados no gerenciador de arquivos (vídeos, documentos) pergunta antes e envia; texto continua sendo colado como texto. O clique direito nos campos de texto usa o menu no estilo do app.
-
Shift+clique seleciona mensagens inteiras, da última clicada até a atual (Shift+clique numa selecionada a tira), e Ctrl+C copia todas como "[data hora] Nome: texto". Esc limpa a seleção.
-
Formatação de texto como no Gajim (XEP-0393):
*negrito*,_itálico_,~riscado~,`código`, blocos entre```e citações com>. -
Respostas (XEP-0461) e reações (XEP-0444): a mensagem respondida aparece citada (um clique leva até ela) e as reações aparecem embaixo. Clique direito numa mensagem para responder, reagir ou copiar o texto.
-
Links clicáveis nas mensagens, e prévia das imagens: as que você envia ou baixa, e as que chegam pelo servidor de contatos e salas conhecidos, até 10 MB. Imagens de quem não está nos contatos não são baixadas sozinhas, para não revelar o seu endereço.
-
Histórico do servidor (MAM, XEP-0313): ao conectar, busca o que chegou enquanto o Omajim estava fechado ou passou por outro dispositivo, e avisa numa só notificação. Na primeira conexão de uma conta, traz só as 100 mensagens mais recentes.
-
Avatares dos contatos (vCard, XEP-0054/0153), guardados em cache e baixados de novo só quando o contato troca de foto.
-
Recibos de entrega (XEP-0184): um ✓ ao lado do horário quando o outro lado confirma que recebeu. E "digitando…" (XEP-0085) no cabeçalho da conversa; o Omajim só avisa que você está digitando para quem também manda esse aviso.
-
Salas de grupo (MUC, XEP-0045): Ctrl+J entra numa sala, que fica salva nos favoritos do servidor (XEP-0402) e volta nos outros dispositivos. As salas ficam no topo da lista, cada mensagem mostra o apelido de quem escreveu, e só notificam quando alguém escreve o seu apelido ou manda uma mensagem privada. Convites aparecem na lista de contatos.
-
Arquivos de dois jeitos, escolhidos no botão "+":
- pelo servidor (HTTP Upload, XEP-0363), como o Gajim e o Conversations: funciona em salas e com quem está offline. Ctrl+O, ou arraste o arquivo para a conversa. Os arquivos que chegam assim aparecem com um botão "Baixar";
- direto (SI, XEP-0096), compatível com o Pidgin, por conexão direta (SOCKS5) ou pelo servidor (IBB). Ctrl+Shift+O.
Os arquivos recebidos vão para a pasta de Downloads e só ganham o nome final quando estão completos. Um arquivo que já existe nunca é substituído. Como no Gajim, cada arquivo mostra o ícone do tipo, o nome e o tamanho, com botões para abrir a pasta, salvar como (pelo diálogo do sistema) ou baixar; imagens aparecem inteiras, com essas ações sobre a imagem.
-
Para os contatos, o cliente se apresenta como Omajim (versão e capabilities, XEP-0092/0115).
-
A senha fica no chaveiro da sessão (Secret Service, via
secret-tool), nunca num arquivo de configuração. -
Visual dos apps do Omarchy, no estilo do Hype: usa a paleta inteira do tema atual (fundo, texto, destaque, seleção), a fonte do sistema, o arredondamento das janelas do Hyprland e o idioma escolhido em Setup > Language, tudo ao vivo.
-
Certificados autoassinados: o Omajim mostra a impressão digital SHA-256 e só se autentica depois que você confia no certificado.
-
Ausente automático, como no Gajim: depois de 5 minutos sem usar o computador, "Disponível" vira "Ausente", e depois de 15, "Indisponível"; ao voltar, o status anterior volta sozinho. Um status escolhido à mão não é mexido. A inatividade vem do compositor (ext-idle-notify), que respeita vídeos tocando; os tempos ficam em
~/.config/omajim/omajim.conf(idle/awayMinutes,idle/xaMinutes; 0 desliga). -
Fica na bandeja: fechar a janela só a esconde e o Omajim continua recebendo mensagens (Ctrl+Q sai de vez). O item de bandeja usa o mesmo id do Omajim em Python, então o widget
omajim.statusda barra do Omarchy mostra o status e as mensagens novas, abre a janela com um clique e traz o menu de status com o botão direito. Sem bandeja, fechar a janela fecha o app. -
Abrir o
omajimde novo traz a janela que já está aberta, em vez de iniciar uma segunda cópia.
Esta é a reescrita do Omajim. O cliente anterior, em Python e GTK e baseado
no Gajim, continua na branch python.
| Tecla | Ação |
|---|---|
| Ctrl+K ou Ctrl+T | Buscar contatos (Enter abre a conversa) |
| Ctrl+Shift+K | Alternar entre conversas e todos os contatos |
| Alt+↑ / Alt+↓ (ou Ctrl+Tab) | Conversa anterior ou seguinte |
| Enter | Enviar a mensagem |
| Shift+Enter | Nova linha na mensagem |
| Ctrl+O | Enviar um arquivo pelo servidor |
| Ctrl+Shift+O | Enviar um arquivo direto (SI) |
| Ctrl+N | Adicionar um contato |
| Ctrl+J | Entrar numa sala |
| Ctrl+W | Fechar a conversa (tira da barra lateral) |
| Ctrl+F | Buscar na conversa |
| Ctrl+V | Colar texto, imagem ou arquivos |
| ? (fora do campo de texto), F1 ou Ctrl+/ | Mostrar os atalhos |
| ↑ (campo vazio) | Corrigir a última mensagem |
| Shift+clique | Selecionar mensagens inteiras |
| Ctrl+C (com seleção) | Copiar as mensagens selecionadas |
| Ctrl+Q | Sair |
Num app de chat quase sempre se está digitando, então os atalhos usam um
modificador. A exceção é o ?, que mostra os atalhos como nos outros apps
do Omarchy, mas só quando o foco não está num campo de texto.
Esc sai do campo de mensagem (e da busca de contatos, já vazia); fora de um campo de texto, valem as teclas do vi:
| Tecla | Ação |
|---|---|
| j / k | Rolar a conversa, ou andar pela lista quando ela tem o foco |
| d / u | Meia tela para baixo ou para cima |
| g g / G | Ir ao começo ou ao fim |
| J / K | Conversa seguinte ou anterior |
| h / l | Ir para a lista ou para a conversa (na lista, l abre a escolhida) |
| i (ou a) | Voltar ao campo de mensagem |
| / | Buscar na conversa |
| o | Buscar contatos (Enter abre a conversa ou começa uma nova) |
| f | Clicar pelo teclado, como no Vimium |
| ? | Mostrar os atalhos |
Com o f, cada coisa clicável na tela (botões, campos, contatos, arquivos,
reações) ganha uma etiqueta de letras; digitar a etiqueta clica ali, ou põe
o cursor no campo. Backspace apaga uma letra e Esc desiste.
No envio direto, quem recebe se conecta no computador de quem envia, na
porta TCP 28011 (a mesma do Omajim em Python). Com o ufw ativo, como no
Omarchy, essa porta vem bloqueada e a transferência falha com uma mensagem na
janela. Libere a porta na máquina que envia, de preferência só para a rede
local (troque a faixa pela da sua rede):
sudo ufw allow from 192.168.0.0/24 to any port 28011 proto tcpSe outro programa estiver usando a 28011, o Omajim escuta numa porta livre qualquer, e aí a regra acima não vale.
Antes de cada envio direto, o Omajim lê as regras do ufw (sem precisar de
root) e, se a porta estiver bloqueada para a sua rede, não a oferece: manda
pelo proxy de bytestreams do servidor, que ele descobre ao conectar, ou,
sem proxy, pelo próprio XMPP (IBB), mais lento mas que sempre passa. O
cartão do arquivo mostra o caminho usado (conexão direta, proxy ou IBB), e
uma notificação avisa quando um arquivo direto termina de chegar.
O pacote omajim-git sai do arch-repo,
a cada commit na main. Ele substitui o Omajim em Python, que tinha o mesmo
nome, e o antigo omajim-qt: quem tem um deles instalado recebe este no
pacman -Syu.
sudo pacman -S omajim-gitAs releases trazem:
omajim-<versão>-x86_64.AppImage: um arquivo só, com o Qt e a QXmpp dentro, que roda no Ubuntu 24.04, no Linux Mint 22 e em distribuições mais novas. Para guardar a senha no chaveiro, instale osecret-tool(sudo apt install libsecret-tools).omajim-<versão>-windows-x64-setup.exe: o instalador do Windows; ou o.zip, que roda sem instalar. A senha fica no Gerenciador de Credenciais.
O AppImage e o Windows procuram versões novas nas releases uma vez por dia e
avisam na janela. Atualizar e reiniciar baixa o arquivo, confere com o
SHA256SUMS da release e o instala: o AppImage troca o próprio arquivo, o
Windows instalado roda o instalador novo em silêncio. O .zip só abre a
página da release. Dá para desligar em Preferências → Atualizações; o pacote
do Arch não procura, porque quem o atualiza é o pacman.
A release é gerada à mão, pelo workflow Release (Actions → Release → Run workflow). Para gerar o AppImage na própria máquina, com docker ou podman:
bin/appimage # em dist/, compilado num container Ubuntu 24.04Precisa de qt6-base, qt6-declarative, qt6-wayland, qxmpp e
libsecret.
bin/build # compila em build/omajim
bin/test # roda os testes offscreen
bin/install # gera e instala o omajim-qt (substitui o omajim-git)Para compilar sem instalar o qxmpp, aponte QXMPP_ROOT para o pacote
extraído (o diretório que contém usr/) e rode com LD_LIBRARY_PATH
apontando para $QXMPP_ROOT/usr/lib.
Os dados ficam em ~/.config/omajim/omajim.conf e
~/.local/share/omajim/accounts/<conta>/history.sqlite, separados dos
arquivos do Omajim em Python.