Ajuda: como instalar e usar o Hark no seu Mac

Tudo nesta página descreve o app como ele é distribuído hoje. Quando um limite é do beta, isso está indicado. 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.

O Hark está em beta público gratuito. Baixe a imagem de disco, abra-a, arraste o Hark para a pasta Aplicativos, ejete a imagem e abra o Hark a partir de Aplicativos. O app é assinado com o nosso Developer ID e notarizado pela Apple, então o macOS o abre sem nenhum aviso.

Como entrar e o que o Hark pede

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.

Uma conta, por enquanto

O beta conecta uma conta do Google por instalação. A caixa de entrada unificada de várias contas já está pronta e fica desativada durante o beta; não existe a opção “Add account” (Adicionar conta) até ela ser ativada.

Atualizações

Na segunda abertura, o Hark pergunta se pode procurar novas versões sozinho. Diga que sim e ele verifica cerca de uma vez por dia (a cada hora nas versões beta) e avisa quando houver uma pronta, com uma notificação mesmo que o Hark esteja em segundo plano naquele momento. Para verificar agora, escolha “Check for Updates…” (Procurar atualizações) no menu Hark.

Toda atualização é assinada, e o app verifica essa assinatura antes de instalar qualquer coisa. A instalação substitui o app no mesmo lugar; ela não pede a sua senha de administrador. “About Hark” (Sobre o Hark), no menu Hark, mostra a versão e a build que você está usando — informação útil para incluir em um relatório de bug.

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

O conjunto é deliberadamente pequeno no beta. A camada completa do Gmail está sendo trazida de volta um atalho de cada vez, cada um limitado para não disparar enquanto você digita uma mensagem.

• 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. O cache de mensagens, eventos e tarefas é um banco de dados em ~/Library/Application Support/Hark, uma pasta por conta, com arquivos que só o seu usuário pode ler. Os anexos baixados ficam separados, em ~/Library/Caches/Hark; as imagens remotas em cache, fotos de remetentes e logotipos ficam em ~/Library/Caches/hark-url-cache, ~/Library/Caches/hark-image-cache e no armazenamento WebKit do app — tudo dentro da sua própria pasta Biblioteca. Seus ajustes, suas últimas 25 pesquisas e os IDs das conversas que você ignorou ficam no arquivo de preferências comum do app.

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

Para desinstalar, saia primeiro — é isso que revoga a autorização no Google —, depois encerre o Hark e arraste-o de Aplicativos para o Lixo. Para remover todos os vestígios, apague também ~/Library/Application Support/Hark, ~/Library/Caches/Hark, ~/Library/Caches/hark-url-cache, ~/Library/Caches/hark-image-cache, ~/Library/Caches/com.souplin.hark (o cache de downloads do atualizador), ~/Library/HTTPStorages/com.souplin.hark, ~/Library/WebKit/com.souplin.hark e ~/Library/Preferences/com.souplin.hark.plist.

Se você removeu o app sem sair, 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.