Ajuda

Ajuda: como instalar e usar o Hark no seu Mac

Tudo nesta página descreve o app como ele é distribuído hoje. Se algo aqui estiver errado, ou se a sua pergunta não estiver aqui, escreva para support@souplin.com e uma pessoa vai responder.

Requisitos e instalação

O Hark funciona no macOS 14 (Sonoma) ou posterior, em um Mac com Apple silicon (M1 ou posterior); Macs com Intel não são compatíveis. É preciso ter uma conta do Gmail ou do Google Workspace.

Na primeira abertura, escolha “Sign in with Google” (Entrar com o Google). O macOS abre a própria página de login do Google em uma janela fornecida pelo sistema — o Hark nunca vê a sua senha, e a verificação em duas etapas ou uma chave de segurança funcionam ali como em qualquer outro lugar. Quando você terminar, a janela se fecha e a sua caixa de entrada é carregada.

A tela de consentimento do Google lista o que o Hark está pedindo. Em palavras simples, e com o motivo de cada item:

Ler, organizar e enviar seus e-mails do Gmail. É o próprio cliente de e-mail: mostrar mensagens, marcá-las como lidas, marcadores, arquivar, adiar, rascunhos e enviar. O Hark deliberadamente não pede a permissão que permite excluir de forma definitiva, então ele só consegue mover uma mensagem para a Lixeira.
Configurações básicas do Gmail. Sua assinatura, a resposta automática de férias, filtros e endereços de “enviar como”, para que você possa gerenciá-los nos ajustes do Hark e a mudança apareça na web.
Suas agendas. Ver, criar e editar eventos, responder a convites, mostrar e ocultar agendas, criá-las e compartilhá-las.
Suas tarefas. O painel do Google Tasks ao lado da agenda.
Seus contatos, somente leitura. Completar um destinatário ou um convidado enquanto você digita, e mostrar a foto de um remetente. O Hark nunca grava nada nos seus contatos.
Arquivos do Drive que você escolher. Anexar um arquivo do Google Drive escolhido no seletor do próprio Google. O Hark só vê os arquivos que você escolhe, nunca o seu Drive.
Seu endereço de e-mail e seu nome. Para identificar a conta dentro do Hark.

Analisado pelo Google

O acesso do Hark à sua conta do Google foi analisado e aprovado pelo Google em 2026, por meio da verificação OAuth e de uma avaliação de segurança CASA independente.

Contas do Workspace

Uma conta do Google Workspace entra da mesma forma, desde que a sua organização permita apps de terceiros. Se não permitir, o Google mostra a própria mensagem na página de login e o Hark não consegue continuar; o administrador pode liberar o Hark no Admin Console do Workspace.

Várias contas

Para adicionar outra conta do Google, clique na foto da sua conta, no canto superior direito da janela, e escolha “Add account…”, ou use “Add account…” em “Settings › Accounts and Import”. O login é igual ao da primeira, e o Hark conecta até cinco. Com duas ou mais, “All Inboxes” na barra lateral mostra a caixa de entrada de todas em uma única lista, e uma busca feita ali procura em todas elas.

Notificações, o Dock e a barra de menus

Até você decidir, o Hark mostra uma barra no topo da janela pedindo para ativar as notificações; clique em “Turn On” (Ativar) e o macOS pergunta se pode. O mesmo pedido é o botão “Allow…” em “Settings › General › Desktop notifications”. Se você disse não e mudou de ideia, a opção fica em Ajustes do Sistema › Notificações › Hark.

Você escolhe sobre o que o Hark notifica em “Settings › General › Desktop notifications”: novas mensagens; convites, alterações e cancelamentos de agenda; se a notificação mostra o assunto e uma prévia; e se ela toca um som. O Hark fica em silêncio enquanto é o app ativo — um som por algo que já está na sua tela é só ruído.

O indicador no Dock mostra a contagem de não lidas da sua caixa de entrada, o mesmo número que o Gmail mostra — com várias contas, o total das que têm “Count in Dock badge” ativado (“Settings › Accounts and Import”); desative-o com “Show unread count in Dock”, em “Settings › General › Appearance”. O item na barra de menus mostra rapidamente o que acabou de chegar sem trazer a janela para a frente.

E-mail

Seus marcadores ficam na barra lateral e nas mensagens, e são os marcadores do seu Gmail — uma mudança feita no Hark aparece na web e no seu celular. O painel de leitura tem as ações que você espera: arquivar, aplicar marcador, adicionar estrela, marcar como não lida, adiar até um horário que você escolher (é o Hark, não o Google, que traz a mensagem de volta, então o Hark precisa estar aberto para que ela volte), ignorar uma conversa, mover para a Lixeira. E-mails de listas de e-mail mostram um link “Unsubscribe” (Cancelar inscrição) no topo.

Pesquisa. Os próprios operadores do Gmail — from:, has:attachment, is:unread, older_than:1y — vão para o Google exatamente como foram digitados, e os resultados são os do Gmail. Uma pesquisa que você queira manter pode virar um filtro do Gmail com “Create filter”, e o filtro passa a rodar do lado do Google, para todos os dispositivos.
Escrita. A escrita acontece em uma visualização de texto de verdade do macOS: negrito, itálico e sublinhado na barra de formatação, links, imagens no corpo do texto e o corretor ortográfico do sistema. Solte um arquivo na mensagem para anexá-lo, ou anexe um arquivo do Google Drive pelo seletor. “Undo Send” segura a mensagem por alguns segundos depois do envio (de 5 a 30, em “Settings › General › Sending”). “Schedule Send” salva a mensagem como rascunho e a envia no horário que você escolher — o Hark precisa estar aberto nesse momento, ou ela sai na próxima vez que o Hark abrir, porque a API do Gmail não tem envio programado próprio.
Lixeira, não exclusão. O Hark move mensagens para a Lixeira e nunca exclui de forma definitiva, por design; para esvaziar a Lixeira, use o Gmail na web.
Imagens nas mensagens. Por padrão, o Hark mostra as imagens remotas de uma mensagem. Para que ele pergunte antes, defina “External images” como “Ask before displaying” em “Settings › General”.
Configurações que ficam na web. Algumas configurações do Gmail não estão disponíveis para nenhum app. O Hark as lista nos ajustes com um link que abre o Gmail na web na conta certa, em vez de fingir que elas não existem.

Agenda e Tarefas

A agenda fica a um clique da sua caixa de entrada, na barra lateral à esquerda. Visualizações de dia, semana, mês, ano e programação, além de períodos de 4 dias, 2 semanas e 4 semanas; arraste para criar, arraste para mover ou redimensionar; um aviso com “Undo” (Desfazer) depois de cada alteração; eventos recorrentes editados só neste evento, neste e nos seguintes, ou em todos. As agendas são mostradas e ocultadas pela barra lateral, que também permite criar, compartilhar e assinar agendas. O Google Tasks abre em um painel ao lado da grade, e uma tarefa arrastada para um dia fica agendada nele.

Um convite que chega no seu e-mail mostra “Yes”, “No” e “Maybe” na mensagem, e a resposta vai direto para a agenda. A descrição completa está em Google Calendar como um app nativo de Mac.

Teclado

j e k, ou as teclas de seta, percorrem a lista.
Esc sai de uma mensagem e volta para a lista.
Negrito, itálico e sublinhado ainda não têm atalho; eles ficam na barra de formatação enquanto você escreve.
“Zoom In”, “Zoom Out” e “Actual Size” ficam no menu “View” e mudam o tamanho do texto das mensagens.
⌘, abre os ajustes, como em todo app de Mac.
⇧⌘R abre “Report a Bug”.

Onde ficam seus dados

O Hark não tem servidor para os seus e-mails; tudo o que ele guarda fica no seu Mac. As credenciais da sua conta do Google ficam nas Chaves do macOS. Todo o resto que ele guarda — o cache de mensagens, eventos e tarefas (uma pasta por conta), os anexos baixados, as imagens remotas em cache, fotos de remetentes e logotipos, seus ajustes, suas últimas 25 pesquisas e os IDs das conversas que você ignorou — fica dentro do contêiner isolado (sandbox) do Hark, ~/Library/Containers/com.souplin.hark, na sua própria pasta Biblioteca.

“Settings › Advanced” reúne os três controles que importam aqui. “Clear cache” remove as imagens em cache e os anexos baixados — seus e-mails, rascunhos, conversas adiadas e contas continuam onde estão, e as imagens e os anexos voltam no próximo uso. “Send crash reports” vem desativado por padrão; se ativado, uma falha envia o rastreamento de pilha, o tipo de exceção, o sinal e o motivo do encerramento, qual thread falhou, quando aconteceu e o ID do macOS para essa falha, a versão, a build e o commit do app, e a versão do macOS e o modelo do hardware — nunca seus e-mails. “Look up avatars on gravatar.com” vem desativado por padrão; se ativado, envia um hash do endereço de cada contato para esse serviço. O quadro completo, incluindo o que um relatório de bug contém, está em um cliente do Gmail que nunca vê seus e-mails.

Como sair e desinstalar

Para sair, clique na foto da sua conta no canto superior direito da janela e escolha a opção de sair do seu endereço, ou use “Sign out” em “Settings › Accounts and Import”. Sair da sua única (ou última) conta faz três coisas: pede ao Google para revogar o acesso do Hark à sua conta, apaga as credenciais das suas Chaves e remove do disco o cache daquela conta. Com várias contas, “Settings › Accounts and Import” oferece “Remove…” para cada uma, e o menu da conta oferece a opção de remover o seu endereço para a conta ativa: isso apaga as credenciais e o cache daquela conta, e só revoga o acesso do Hark no Google se você marcar “Also revoke Hark’s access to this Google account.”

Para desinstalar, primeiro remova todas as contas, marcando “Also revoke Hark’s access to this Google account.” sempre que a opção aparecer — sair da última conta sempre revoga —, depois encerre o Hark e arraste-o de Aplicativos para o Lixo. Para remover todos os vestígios, apague também ~/Library/Containers/com.souplin.hark.

Se você removeu o app, ou uma conta, sem revogar o acesso do Hark, a autorização continua na sua conta do Google: abra myaccount.google.com/permissions, encontre o Hark entre os apps de terceiros e remova o acesso dele. Os itens das Chaves ficam no Acesso às Chaves, com nomes que começam com com.hark.oauth.

Como relatar um bug

Escolha “Report a Bug” no menu “Help” (⇧⌘R), selecione a parte do app a que ele se refere e conte o que aconteceu. O relatório leva o que você digitou, se você o marcou como bug ou como pedido, a área que escolheu, as imagens que anexar, o campo de nome ou e-mail — já preenchido com o endereço da conta conectada; apague-o se preferir não ser identificado — e dados sobre o app e a máquina: versão, build e commit, versão do macOS, modelo do hardware, número de núcleos da CPU, quantidade de memória, espaço livre em disco, localidade, fuso horário, estado térmico, modo de pouca energia, horas desde a inicialização, o horário do envio, quantas contas estão conectadas (só o número) e um ID aleatório por instalação. Ele nunca leva conteúdo de mensagens, assuntos, endereços de outras pessoas, tokens ou logs. Uma captura de tela costuma ser o jeito mais rápido de nos mostrar um bug — e é a única forma de algo da sua caixa de entrada chegar até nós, então recorte-a se isso importar.

Ou escreva para support@souplin.com. Se puder, inclua o número da build que aparece em “About Hark”.

Idioma

O Hark está em inglês e chinês simplificado. “Settings › General › Language” define tanto o idioma de exibição do Gmail quanto o da interface do próprio Hark; o Hark segue essa escolha onde há tradução e fica em inglês nos demais casos. Reinicie o Hark para que o idioma da interface mude.