Frequently asked questions
Every setting and the answers to the most common questions, by topic. Type to search.
Getting started
Can I see the introduction tour again?
Yes. Settings ▸ General ▸ Tour ▸ Start plays it again. You can always skip it with the button or with Escape; it will not come back by itself afterwards.
The tour dims the window and lights up one part at a time: the account bar, the plus to add an account, the tab bar with the Google tools, the Gmail pane itself, the floating panel, the downloads bar and the settings.
What do I need to use Nuncio?
A Mac with Apple Silicon running macOS 14 or later, and one or more Google accounts — regular Gmail addresses or Google Workspace, both are fine. Nothing else: Nuncio has no account or sign-up of its own.
When does Nuncio ask for access to Downloads, the microphone or the camera?
Only at the moment it is needed, never at launch. macOS asks for the Downloads folder on your first download: that is where the downloads bar saves attachments and files. It asks for the microphone and camera on your first Google Meet call; they are used nowhere else.
If you decline something, you can enable it later in System Settings ▸ Privacy & Security.
Why do I have to sign in to a Google account again from time to time?
Google decides that, not Nuncio. Nuncio never signs you out on its own: the only thing that clears a session is choosing Sign out on that account yourself.
Where the limit sits depends on the kind of account. For a work or school account (Google Workspace), your administrator sets how long a web session stays valid. Google’s default is fourteen days; an administrator can make it shorter, or set it to never expire. If the sign-in comes back on a predictable rhythm, this is almost always why — and your administrator can change it. For an ordinary @gmail.com address, sessions do not expire on a schedule. If you do have to sign in again, something specific happened: you changed your password, changed your two-step verification, used “sign out of all devices” somewhere, or Google wanted to double-check a sign-in.
One nice detail: every account in Nuncio has its own fully separated storage. Signing in again therefore touches only that one account — your other accounts keep running.
Signing in happens inside the Nuncio window, with your address already filled in, so your password is all that is left to type. That password never reaches Nuncio, only Google.
How do I add an account?
Click the "+" at the bottom of the account bar (or Account ▸ Add account). You first pick a name and color; then the regular Google sign-in appears. Every account gets its own fully isolated storage — accounts never see each other.
Signing in with a passkey doesn’t work.
Correct, and it is not about Bluetooth or any other permission: Apple reserves passkeys for full browsers, so an embedded web view may not handle them. Since version 1.1 Nuncio hides the passkey option on Google’s sign-in page, so you go straight to your password or the confirmation on your phone.
You only do this once; after that the session stays signed in, just like in a browser.
How do I reach you?
Write to support@getnuncio.app — in English, Dutch, French, German, Spanish or Italian. The app speaks twenty languages, but those six are the ones we can answer in. Mention your macOS version and how many accounts you use; that saves a round trip.
Inside the app you’ll find the way back under Nuncio ▸ Support (opens a new message) and Nuncio ▸ Nuncio website. Nuncio ▸ About Nuncio shows both as clickable links too.
Why is the app called "Nuncio for Gmail" in the App Store?
For findability: people searching the Mac App Store for Gmail should be able to find us. In the app itself and on this website the product is simply called Nuncio. Gmail is a trademark of Google LLC; we use the name descriptively, to say what Nuncio is for. Nuncio is not a Google product and is not affiliated with Google.
Does Nuncio work with Google Workspace?
Yes, fully — including Workspace environments with a custom product name. You sign in as usual; your organisation’s admin policies remain in force, because it is the real Gmail web interface.
Accounts
What’s the difference between "Sign out" and "Remove"?
Sign out only clears the session (cookies and site data) — the account stays in your bar and you can sign in again. Remove takes the account away and erases all of its data from your Mac.
How do I change an account’s name or color?
Right-click the account circle ▸ Edit…. Name and color live together there: eight fixed colors as swatches, plus a color well for any color you like (with color wheel, eyedropper and hex input). The color shows up as the ring around the circle, in the floating panel and on notifications.
My account name changed into my email address by itself.
That only happens if you kept the suggested name ("Account 2"): after the first sign-in, Nuncio fills in your address automatically. A name you chose yourself (say, "Work") always stays.
Can I reorder my accounts?
Yes — drag the circles up or down in the account bar. The order also determines the shortcuts ⌘1 through ⌘9.
Notifications
I’m not getting notifications for an account. Why?
Usually desktop notifications are turned off in Gmail itself for that account; Gmail then simply sends nothing. Open Settings ▸ Notifications in Nuncio: each account has a status row — green means it works, orange ("no notification seen yet") almost certainly means it’s off in Gmail. The button next to it takes you straight to the right Gmail settings page: under General ▸ Desktop notifications choose "New mail notifications on" and click "Save changes" at the bottom.
Also check once that macOS allows Nuncio to send notifications (System Settings ▸ Notifications ▸ Nuncio); Nuncio warns you in Settings if that was declined.
I sent myself a test email but no notification came.
Were you looking at the account that received it? Gmail deliberately doesn’t notify for the account that is visible — you can see the mail arriving. Test with a mail to an account you are not looking at — then you get both the notification and the slide.
Can I turn notifications off per account?
Yes: right-click the account circle ▸ Edit… ▸ "Notifications for this account". Below it you can also turn off only the slide notifications for that account and keep the regular banners. The main switch is in Settings ▸ Notifications.
Do I get Google Calendar notifications too?
Yes: Calendar reminders arrive as regular Nuncio notifications; clicking opens that account’s calendar. Two requirements: turn on desktop notifications in Calendar itself (⚙ ▸ Settings ▸ General ▸ Notification settings), and keep Calendar open as a tab for that account — saved tabs load automatically in the background after launch.
What happens when I click a notification?
Nuncio comes to the front, switches to the right account and the right app, and where possible opens the exact message or event.
Floating panel
What is the floating account panel?
A small dark panel that floats above all your other apps, in every Space: your accounts with their unread counts, always visible. Click an account and Nuncio jumps to it. When mail arrives, a clickable card slides out of the panel, next to that account’s circle.
Can I move, rotate or hide the panel?
All three. Drag it (grab the dark background) wherever you like — the position is remembered, even across restarts. In Settings ▸ Floating panel you pick the orientation (vertical or horizontal) and can turn the panel or just its slide notifications off. Per account, Edit… decides whether it appears in the panel.
Why does the slide notification appear during Do Not Disturb?
macOS shields Focus status from apps; to read it, Nuncio needs Full Disk Access (System Settings ▸ Privacy & Security — Settings ▸ Floating panel has a shortcut). With that access, Nuncio suppresses slides during any Focus mode; the regular notification banners respect Do Not Disturb regardless, because macOS filters those itself.
Badges and counters
The Dock icon shows no number, even though the setting is on.
macOS ties the Dock badge to the notification permission: if notifications for Nuncio are switched off at system level, the Dock stays empty no matter how you set the switches in Nuncio. Turn them on in System Settings ▸ Notifications ▸ Nuncio — Settings ▸ Badges has a button that takes you straight there, along with a warning when this is the case. The number appears within a few seconds.
Can I hide the unread counts (partly)?
At every level. Settings ▸ Badges has the main switch "Show unread counts" (circles, floating panel, window title and Dock in one go) and a separate switch for the Dock total. Per account: Edit… ▸ "Show unread count" — that account then also stops counting toward the Dock total.
The badge number differs from what Gmail calls "unread".
The badge counts the unread mail in your Inbox, Primary tab. That number stays put while you read a message or look in another folder such as Spam. Gmail’s total across all categories — Promotions, Social — is often much higher. This keeps the badge a measure of what you actually want to see.
There’s a grey dot on an account circle.
That account is signed out (the session expired or was cleared). Click it and sign in again; the badge and notifications return by themselves.
Windows and tabs
Gmail opened something "in a new window" and it became a tab.
By design: pop-out compose windows and pop-out messages become tabs in the top bar, so everything stays visible in one window. Sending closes the tab by itself; the close button (appears on hover) or ⌘W closes it manually. Only external sites still open as separate windows; signing in to Google happens in the main window itself.
I closed the window but the app stayed in the Dock.
By design: if Nuncio quit, your notifications and badges would stop too. Closing the window only hides it.
To bring it back, click the Dock icon or a notification, or choose Window ▸ Main Window (⌥⌘0). To really quit, press ⌘Q.
Can I choose my own image for an account?
Yes, since version 1.1: right-click the circle ▸ Edit ▸ “Choose Image…”. That image appears in the account bar, the floating panel and the mailbox picker, and takes precedence over the Google profile photo. “Remove Custom Image” brings back the Google photo or the first letter.
The name from that same form is also shown in the window title since 1.1, instead of the email address.
Which keyboard shortcuts are there?
⌘1–⌘9 pick an account · ⌘⇧[ and ⌘⇧] previous/next account · ⌘⌥← and ⌘⌥→ previous/next app · ⌃⌘S show/hide the account bar · ⌘N new mail (as a tab) · ⌘W close tab or app · ⌘R reload · ⌘+ / ⌘− / ⌘0 zoom · ⌘, settings.
The empty top bar drags the window — a tab doesn’t. Is that right?
Yes: empty bar space behaves like a title bar (dragging moves the window, double-click zooms). Tabs and buttons keep their own behaviour and never drag the window by accident.
Links and downloads
A link from an email opened in my browser. Is that right?
Yes, by design: external links open in your default browser, so Nuncio stays a mail client rather than becoming a browser. Google links are the exception — a Drive link in Gmail opens your own Drive tab for that same account. If you’d rather keep external links inside Nuncio, turn off Settings ▸ General ▸ "Open external links in the system browser".
Where do I find my downloads?
In the bar that appears at the bottom whenever something downloads: progress per file, click to open, right-click for Show in Finder. The files themselves are simply in your Downloads folder.
Downloading an attachment seemed to do nothing.
Check the bar at the bottom of the window — small files often finish before you notice. If the bar stays empty, check that Nuncio has access to your Downloads folder (System Settings ▸ Privacy & Security ▸ Files and Folders).
Dragging a file into a message did nothing.
That was a bug in versions 1.1.3 to 1.1.7, fixed in 1.1.8. Dragging only worked on the account Nuncio had started with: on every other account the file went to that account’s hidden window, and nothing happened in the message in front of you. The paperclip always worked. Since 1.1.8 a file lands in the message you are looking at: drop it on an open compose window.
Default mail
How do I make Nuncio my default email app?
Through Apple Mail. macOS lets only Mail choose the default email app, and an app from the App Store is not allowed to change that setting itself. Open Apple Mail, choose Mail ▸ Settings… ▸ General and set Default email reader to Nuncio. In Nuncio, Settings ▸ Default mail shows a checkmark once it is set.
I clicked an email address and got a chooser window.
With multiple accounts there is deliberately no fixed default mailbox: on every mailto link you choose again via "Choose mailbox" — your accounts with photo and address. With one account the message opens directly. Address, cc, subject and body are pre-filled; the message opens as a tab. Close the chooser without picking (✕, Esc or clicking beside it) and nothing happens.
Appearance and language
Which languages does Nuncio speak?
Twenty: English, Dutch, French, German, Spanish, Italian, Japanese, Korean, Traditional Chinese, Portuguese (Brazil), Polish, Czech, Turkish, Swedish, Danish, Norwegian, Finnish, Greek, Ukrainian and Romanian. The app follows your Mac's language order automatically. Want Nuncio in a different language than the rest of your Mac? System Settings ▸ General ▸ Language & Region ▸ Applications ▸ + ▸ Nuncio, and pick the language there. If your Mac speaks a language Nuncio doesn't know, it falls back to English. Note that the Gmail panes themselves follow your Google account's language setting, not Nuncio's — you change that inside Gmail.
Does Nuncio have a dark theme?
Yes. By default everything follows your Mac’s system theme. In Settings ▸ General you choose System, Light or Dark — and with Light or Dark the web apps recolor along by default, via smart inversion that keeps photos in their real colors. A web app that is already dark (like Gmail with its own dark theme) is left alone. The recoloring can be switched off separately.
Google Calendar asked me to pick a theme.
That’s Google’s one-time chooser per account. Nuncio answers it automatically with "Device default" — the option that follows Nuncio’s theme. If you do see the dialog, pick "Device default" yourself; the effect is the same.
Performance and battery
Does Nuncio stay fast with many accounts?
Yes. Gmail stays loaded for every account, so switching is always instant — even with six accounts. Only the active page is rendered; the rest is parked without drawing anything.
What do Efficient and Everything warm mean?
Settings ▸ General ▸ Memory. Efficient (recommended) unloads only the other tabs (Calendar, Drive, …) you haven’t used for fifteen minutes; they reload in a few seconds on the next click. Everything warm unloads nothing. Gmail stays loaded in both modes.
Won’t this drain my battery?
No. Nuncio is native Swift with your system’s WebKit (no bundled Chromium), does no background work in the interface, slows itself down automatically in Low Power Mode and pauses completely as soon as your screen sleeps.
Privacy and data
What usage statistics do you collect?
By default, none. Nuncio asks once at first launch; "Don't share" is a complete answer and nothing is ever sent. You can change it any time under Settings ▸ General ▸ Statistics.
If you switch it on, this goes to TelemetryDeck (Germany): your app and macOS version, your language, your settings (floating panel, notifications, badges, theme, memory mode) and which Google tools you open. The number of accounts is sent as a range (1, 2, 3–4, 5–9, 10+), never exactly.
Never sent: email addresses, account names, subjects, message contents or unread counts. Your identifier is a random number created at installation, hashed on your Mac and hashed again on the server — it cannot be traced back. TelemetryDeck stores no IP addresses.
Where is my data? Is anyone watching?
Everything stays on your own Mac: each account lives in its own isolated storage (cookies, sign-ins, site data), like separate browser profiles. Nuncio has no servers and no accounts of its own, and nothing about your mail is ever collected. Anonymous usage statistics — your settings and which Google tools you open, never your mail — are off by default; Nuncio asks once and you can change it any time under Settings ▸ General. The full privacy policy spells this out.
What happens when I remove an account?
That account’s entire storage (sign-in, cookies, site data, avatar) is erased from your Mac. Your Google account itself is of course untouched — only the local access disappears.
Help and suggestions
How do I send a suggestion or report a problem?
In Settings ▸ Send a suggestion…. That opens a new e-mail to support@getnuncio.app in your default mail app — usually Nuncio itself, so it shows up as a tab in your own Gmail. Say what you miss or what goes wrong; a screenshot helps. The only thing Nuncio adds is a visible line with its version and your macOS version, and you can delete that before sending.
All settings at a glance
General
- Theme — System / Light / Dark
- The app’s appearance; with Light or Dark optionally the web apps too (switch below it).
- Force the theme in web apps too
- Recolors Gmail and friends via smart inversion; photos stay natural.
- Open external links in the system browser
- On (default): non-Google links open in your browser. Off: in a separate Nuncio window.
- Memory — Efficient / Everything warm
- Efficient unloads unused non-Gmail tabs after 15 minutes; Gmail always stays loaded.
Notifications
- Notifications for new mail
- Main switch for all native notifications.
- Gmail per account (status)
- Shows per account whether Gmail has actually sent notifications, with a button straight to the right Gmail setting.
Badges
- Show unread counts
- Main switch for all counters: circles, panel, window title and Dock.
- Show total unread on the app icon
- The sum across all accounts on the Dock icon.
Floating panel
- Show floating account panel
- The panel above all apps, in every Space; draggable, position remembered.
- Orientation — Vertical / Horizontal
- Circles stacked or side by side.
- Slide notification from the panel
- The card that slides out on new mail; respects Focus once Nuncio may read it.
Default mail
- Default email app
- Set in Apple Mail ▸ Settings… ▸ General; macOS does not let apps change it themselves. A checkmark shows once it is set.
Per account (right-click the circle ▸ Edit…)
- Name and color
- Eight swatches plus a free color picker.
- Show unread count
- This account’s badge, everywhere — also stops counting toward the Dock total.
- Notifications for this account
- Banners and slides for this account.
- Slide notifications from the panel
- Only this account’s slides, separate from the banners.
- Show in floating account panel
- Whether this account appears in the panel.