Skip to content
higorhgonPublic
forked from gajim/gajim

About

Gajim Fork

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Latest commit

 

History

79 Commits

Folders and files

Repository files navigation

Omajim

Omajim mostrando uma conversa com mensagens e arquivos

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.status da 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 omajim de 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.

Atalhos

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.

Teclas do vi

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.

Firewall para o envio direto

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 tcp

Se 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.

Instalação

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-git

Outras distribuições e Windows

As 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 o secret-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.04

Desenvolvimento

Precisa 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.

About

Gajim Fork

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages