Frequently asked questions
Every setting and the answers to the most common questions, by topic. Type to search.
Getting started
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.
Why does Nuncio ask for Downloads, microphone and camera right after installing?
By design: all system permission prompts arrive at one predictable moment — right after installation, or on a fresh install right after your first sign-in — instead of scattered throughout your day. Downloads access is for the downloads bar; microphone and camera are used exclusively for video calls in Google Meet and nowhere else.
If you decline something, you can enable it later in System Settings ▸ Privacy & Security.
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, unfortunately: Apple reserves passkey handling for full browsers, so the embedded web view can’t offer it. In the Google sign-in screen, choose "Try another way" and sign in with your password — it’s a one-time thing; you stay signed in afterwards.
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, or use Test ▸ Send test notification in the menu bar.
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
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 what your open Gmail tab reports (usually Primary). 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 sign-in pop-ups open as separate windows — a login flow would break inside a tab.
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; click the Dock icon (or a notification) to bring it back. ⌘Q really quits.
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).
Default mail
How do I make Nuncio my default email app?
Nuncio asks once by itself. After that it’s always available in Settings ▸ Default mail — macOS asks for confirmation. Manually works too: Apple Mail ▸ Settings ▸ General ▸ Default email reader ▸ Nuncio.
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?
Six: English, Dutch, French, German, Spanish and Italian. 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 Dutch. 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
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, no accounts and no telemetry — nothing about your use is collected or sent anywhere. 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.
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
- Make Nuncio the default mail client
- With macOS confirmation; the status shows once it’s 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.