Help

Help: installing and using Hark on your Mac

Everything on this page describes the app as it ships today. If something here is wrong, or your question is not here, write to support@souplin.com and a person will answer.

Requirements and installing

Hark runs on macOS 14 (Sonoma) or later, on a Mac with Apple silicon (M1 or later); Intel Macs are not supported. It needs a Gmail or Google Workspace account.

On first launch, choose Sign in with Google. macOS opens Google’s own sign-in page in a window it provides — Hark never sees your password, and two-step verification or a security key works there as it does anywhere else. When you are done, the window closes and your inbox loads.

Google’s consent screen lists what Hark is asking for. In plain words, and with the reason for each:

Read, organise and send your Gmail. The mail client itself: showing messages, marking them read, labels, archive, snooze, drafts and sending. Hark deliberately does not ask for the permission that allows permanent deletion, so it can only ever move a message to Trash.
Basic Gmail settings. Your signature, vacation responder, filters and send-as addresses, so you can manage them in Hark’s Settings and the change shows on the web.
Your calendars. Viewing, creating and editing events, answering invitations, showing and hiding calendars, creating and sharing them.
Your tasks. The Google Tasks panel beside the calendar.
Your contacts, read-only. Completing a recipient or a guest as you type, and showing a sender’s photo. Hark never writes to your contacts.
Drive files you pick. Attaching a Google Drive file you choose in Google’s own picker. Hark can see only the files you pick, never your Drive.
Your email address and name. To label the account inside Hark.

Reviewed by Google

Hark’s access to your Google account was reviewed and approved by Google in 2026, through its OAuth verification and an independent CASA security assessment.

Workspace accounts

A Google Workspace account signs in the same way, provided your organisation allows third-party apps. If it does not, Google shows its own message on the sign-in page and Hark cannot proceed; your administrator can allow Hark from the Workspace admin console.

Several accounts

To add another Google account, click your account photo at the top right of the window and choose Add account…, or use Add account… in Settings › Accounts and Import. It signs in the same way as the first, and Hark connects up to five. With two or more, All Inboxes in the sidebar shows every account’s inbox in one list, and a search from there looks in all of them.

Notifications, the Dock and the menu bar

Until you decide, Hark shows a bar at the top of the window asking to turn notifications on; click Turn On and macOS asks whether it may. The same request is the Allow… button under Settings › General › Desktop notifications. If you said no and change your mind, it is in System Settings › Notifications › Hark.

What Hark notifies you about is under Settings › General › Desktop notifications: new messages; calendar invitations, changes and cancellations; whether a notification shows the subject and a preview; and whether it plays a sound. Hark stays silent while it is the active app — a sound for something already on your screen is just noise.

The Dock badge shows the unread count of your inbox, the same number Gmail shows — with several accounts, the total of those with Count in Dock badge on (Settings › Accounts and Import); switch it off with Show unread count in Dock, under Settings › General › Appearance. The menu-bar item gives a glance at what has just arrived without bringing the window forward.

Mail

Your labels are in the sidebar and on messages, and they are your Gmail’s labels — a change made in Hark shows on the web and on your phone. The reading pane has the actions you expect: archive, label, star, mark unread, snooze until a time you pick (Hark, not Google, brings it back, so Hark has to be running for it to return), mute a conversation, move to Trash. Mailing-list mail shows an Unsubscribe link at the top.

Search. Gmail’s own operators — from:, has:attachment, is:unread, older_than:1y — go to Google as typed, and the results are Gmail’s. A search you want to keep can be turned into a Gmail filter with Create filter, and the filter then runs on Google’s side for every device.
Writing. Composing happens in a real macOS text view: bold, italic and underline from the formatting bar, links, inline images, the system spell checker. Drop a file on the message to attach it, or attach a Google Drive file from the picker. Undo Send holds a message for a few seconds after you send it (5 to 30, under Settings › General › Sending). Schedule Send saves the message as a draft and sends it at the time you choose — Hark has to be running then, or it goes out when Hark next opens, because Gmail’s API has no scheduled send of its own.
Trash, not delete. Hark moves messages to Trash and never deletes permanently, by design; emptying Trash is done on Gmail on the web.
Images in messages. By default Hark shows a message’s remote images. To be asked first, set External images to Ask before displaying under Settings › General.
Settings that live on the web. A few Gmail settings are not available to any app. Hark lists them in Settings with a link that opens Gmail on the web at the right account, rather than pretending they are not there.

Calendar and Tasks

Calendar is one click from your inbox on the left rail. Day, Week, Month, Year and Schedule views, plus 4-day, 2-week and 4-week spans; drag to create, drag to move or resize; an Undo toast after a change; recurring events edited for this event, this and following, or all. Calendars are shown and hidden from the sidebar, which also creates, shares and subscribes to calendars. Google Tasks opens in a panel beside the grid, and a task dragged onto a day is scheduled there.

An invitation that arrives in your mail shows Yes, No and Maybe on the message, and the answer writes straight through to the calendar. The full description is on Google Calendar as a native Mac app.

Keyboard

j and k, or the arrow keys move through the list.
Esc leaves a message and returns to the list.
Bold, italic and underline have no key yet; they are on the formatting bar while writing.
Zoom In, Zoom Out and Actual Size are in the View menu and change the size of message text.
⌘, opens Settings, as in every Mac app.
⇧⌘R opens Report a Bug.

Where your data lives

Hark has no server for your mail; everything it keeps is on your Mac. The credentials for your Google account are in the macOS Keychain. Everything else it keeps — the cache of messages, events and tasks (one folder per account), downloaded attachments, cached remote images, sender photos and logos, your settings, your last 25 searches and the ids of conversations you have muted — is inside Hark’s sandbox container, ~/Library/Containers/com.souplin.hark, in your own Library folder.

Settings › Advanced holds the three controls that matter here. Clear cache removes cached images and downloaded attachments — your mail, drafts, snoozed conversations and accounts stay put, and images and attachments come back on next use. Send crash reports is off by default; on, a crash sends the stack trace, the exception type, signal and termination reason, which thread crashed, when it happened and macOS’s id for that crash, the app version, build and commit, and the macOS version and hardware model — never your mail. Look up avatars on gravatar.com is off by default; on, it sends a hash of each contact’s address to that service. The full picture, including what a bug report contains, is on a Gmail client that never sees your mail.

Signing out and uninstalling

To sign out, click your account photo at the top right of the window and choose Sign out of your address, or use Sign out under Settings › Accounts and Import. Signing out of your only (or last) account does three things: it tells Google to revoke Hark’s access to your account, deletes the credentials from your Keychain, and removes that account’s cache from your disk. With several accounts, Settings › Accounts and Import offers Remove… for each one, and the account menu offers Remove your address… for the active one: it deletes that account’s credentials and cache, and revokes Hark’s access at Google only if you tick Also revoke Hark’s access to this Google account.

To uninstall, first remove every account, ticking “Also revoke Hark’s access to this Google account.” each time it is offered — signing out of the last account always revokes — then quit Hark and drag it from Applications to the Trash. To remove every trace, also delete ~/Library/Containers/com.souplin.hark, the folder that holds everything else Hark keeps.

If you removed the app, or an account, without revoking Hark’s access, the grant is still in your Google account: open myaccount.google.com/permissions, find Hark under third-party apps, and remove its access. The Keychain items are in Keychain Access, named beginning with com.hark.oauth.

Reporting a bug

Choose Report a Bug from the Help menu (⇧⌘R), pick the part of the app it is about, and say what happened. The report carries what you typed, whether you marked it a bug or a request, the area you picked, any images you attach, the name-or-email field — pre-filled with your signed-in address; clear it if you would rather not be identified — and facts about the app and machine: version, build and commit, macOS version, hardware model, CPU core count, memory size, free disk space, locale, time zone, thermal state, low-power mode, hours since boot, the time you sent it, how many accounts are connected (a count) and a random per-install id. It never carries message content, subjects, anyone else’s address, tokens or logs. A screenshot is often the fastest way to show us a bug — and it is the one way anything from your inbox can reach us, so crop it if that matters.

Or write to support@souplin.com. Include the build number from About Hark if you can.

Language

Hark is in English and Simplified Chinese. Settings › General › Language sets both your Gmail display language and Hark’s own interface; Hark follows it where it is translated and stays in English otherwise. Restart Hark for the interface language to change.