User Guide
How to use MailDeck 1.3.1, in this order: getting started, basics, settings, troubleshooting and terms.
Note: the app's menus and buttons are in Japanese only. This guide shows the Japanese label with an English translation in parentheses.
Let's start by adding one account.

Getting started
Install and first launch
- Double-click the downloaded
MailDeck-1.3.1.dmg. - Drag the MailDeck icon onto the Applications folder.
- Open MailDeck from the Applications folder. The first time, macOS asks for confirmation; click "Open".
MailDeck starts with no accounts. Detailed steps and how to verify the file are on the download page.
Add a Google account
- Open "MailDeck > 設定…" (Settings, ⌘,) and press "Googleアカウントを追加" (Add Google account). With no accounts yet, you can also start from "最初のアカウントを追加" (Add your first account) in the main window.
- Google's sign-in page opens in a separate window. Sign in with your email address and password as usual.
- Once the Gmail inbox opens, the account is added. If you stop and close the window (esc also closes it), nothing is added.
- Add more accounts the same way. Each account has its own sign-in; they never mix.
You type your password on Google's page. MailDeck never stores your password.
Basics
Switch accounts and services
- Accounts: pick one from the account list on the left. ⌘1–⌘9 jump to the 1st–9th account. The "アカウント" (Accounts) menu works too.
- Services: use the buttons at the top: "メール" (Mail), "カレンダー" (Calendar), "Keep", "連絡先" (Contacts).
- Back, forward, reload: the arrows at the top go back and forward in Google's pages; the reload button (⌘R) reloads.
Write a new email
- "新規メール" (New mail) at the top or ⌘N opens a new message in the account you are viewing.
- With two or more accounts, "ファイル > 差出人を選んで新規メール" (File > New mail from…) lets you choose the sending account.
- Turning on "ファイル > 既定のメールソフトにする" (File > Set as default mail app) makes email links in other apps and browsers open a new message in the account MailDeck is showing.
Unread counts
MailDeck checks each account's Gmail inbox about every 5 minutes, including accounts showing Calendar or Keep and accounts you are not viewing.
- Account list: the unread count for each account.
- Dock: the total across all accounts on the app icon.
- Menu bar: the total. Click it to see each account's count, plus "MailDeckを表示" (Show MailDeck) and "終了" (Quit).
Search all accounts
Open the search field with the search button at the top or ⌘⇧F ("表示 > すべてのアカウントを検索…", View > Search all accounts). Your words are searched in Gmail in every account you added. Handy when you don't know which account received a message.
More room, or hide the window
- Collapse the account list (⌘⌥S): hides the names and leaves a narrow list of icons and unread counts. Press again to expand.
- "画面を閉じる" (Close window): the button at the bottom of the account list hides the window without quitting. Unread checks and the menu bar count continue. Bring it back from the Dock icon or "MailDeckを表示" in the menu bar.
Links in emails
Links in emails open in your usual browser (Safari, Chrome and so on), not inside MailDeck.
Settings
Open with "MailDeck > 設定…" (Settings, ⌘,).
- "アカウント" (Accounts): the accounts you added. You can change each display name and color (blue, red, green, amber, violet, slate), and add accounts here.
- "危険な操作 > MailDeckを初期化…" (Danger zone > Reset MailDeck): removes all accounts and sign-ins and returns to the first-launch state. This cannot be undone.
Outside the Settings window:
- Clean View: toggle with the button at the top. When on, Gmail's Chat, Meet and side panel are hidden. It is on by default.
- "アップデートを確認…" (Check for Updates): in the "MailDeck" menu. If a new version exists it shows the release notes, and from 1.3.3 on (Mac) "アップデートして再起動" (Update and Restart) replaces and reopens the app. In 1.3.1, because of a defect, it says "MailDeck は最新です" (up to date) even when a new version exists.
Troubleshooting
YuIf a page looks wrong, try ⌘R first.
A new version is out, but no notice appeared
This is a known issue in 1.3.1. It never asks this site for new versions, so no notice appears and the manual check says it is up to date. Check the download page and install the new DMG over the old app. Your accounts and sign-ins are kept.
A Google page is blank or looks broken
Reload with the button at the top or ⌘R. Also check your internet connection.
Switching accounts reloaded the page
To limit memory use, MailDeck keeps Google pages open for up to 4 accounts. Beyond that, it closes the pages of accounts you have not used recently and reloads them when you pick them again. Unread checks continue while they are closed.
An account won't get added
Finish signing in and wait until the Gmail inbox opens. Closing the window partway means nothing is added.
MailDeck won't launch
MailDeck needs an Apple silicon Mac and macOS 13 or later. Intel Macs are not supported, and it does not launch on macOS 12 or earlier.
I want to erase everything and start over
Use "危険な操作 > MailDeckを初期化…" (Danger zone > Reset MailDeck) in Settings. To remove the app itself, see the download page.
I found a bug or have a request
Please email info@k386.sub.jp. MailDeck is developed and run by one person, so a reply may take a few days.
Terms
- Account list
- The column of Google accounts you added, on the left of the window.
- Sign-in state (cookies)
- Information Google uses to remember that you are signed in. MailDeck stores it on this Mac, separately for each account.
- Clean View
- A view of Gmail with Chat, Meet and the side panel hidden.
- Reset
- Removing all accounts and sign-ins to return to the first-launch state.
- Notarized by Apple
- The file has passed Apple's automated check for known malware. It does not guarantee quality or behavior.
Keyboard shortcuts
| Keys | Action |
|---|---|
| ⌘ N | New mail in the account you are viewing |
| ⌘ 1–9 | Switch to the 1st–9th account in the list |
| ⌘ ⇧ F | Search all accounts |
| ⌘ ⌥ S | Collapse or expand the account list |
| ⌘ R | Reload the Google page you are viewing |
| ⌘ , | Open Settings |
| ⌘ H | Hide MailDeck (unread checks continue) |
Earlier versions of this guide listed ⌘F for searching all accounts and ⌘⌥C for Clean View. In 1.3.1, search all accounts is ⌘⇧F, and Clean View is toggled with the button at the top.