FAQs

Is this app coming to the Mac App Store?

Yes. Once v1.0 is released, the app will be made available on the Mac App Store.

Why does this app require macOS Catalina?

Mimestream requires macOS Catalina because it makes use of new APIs and capabilities (such as SwiftUI) only available in Catalina.

Mimestream intends to showcase the best that the Mac has to offer, and new versions will generally require the latest version of macOS (allowing for a breathing period for some bug-fixing software updates to be released by Apple).

Does Mimestream work offline?

Mimestream works offline with your most recent messages. You can read, delete, archive, file, and send messages as you normally would when online, and the changes will sync to the server when you go back online. This architecture also gives you instantaneous interactions when you are on a slow or high-latency connection (like on an airplane).

Message content is cached using the background activity scheduler of macOS, and will wait for an optimal time to run (e.g. device is plugged in to power, cool thermals, etc).

In the future, we plan to add a preference to allow you to explicitly pick the number of days of email you'd like cached, and have predictability around this behavior.

What happens if I stop using Mimestream?

You can continue to use Gmail normally. Your email remains on the Gmail servers, and any changes you make in Mimestream are synced back to Gmail as soon as a network connection is available. No Mimestream-specific labels are added to your account.

Is there an iOS version?

macOS is currently the only supported platform. A version for iOS (and iPadOS) is planned for the future.

Does Mimestream support services besides Gmail?

Mimestream currently only supports Gmail. Future support for other services is planned, including Microsoft 365 / Outlook, services that support IMAP, and services that support JMAP.


App Preferences

How do I change the message text size permanently?

Message text size can be changed in the app's preferences. From the menus, select Mimestream, then Preferences, and on the General tab, you should see a Text Size slider that you can adjust.

How do I use Gmail shortcuts? Or Apple Mail shortcuts?

Gmail shortcuts can be activated in Preferences. From the menus, select Mimestream, then Preferences, and on the General tab, there is a "Keyboard Shortcuts" preference that can be switched to the Gmail or Apple Mail shortcut set.

Improvements to the Gmail shortcut set are planned in the short term. Currently, some key shortcuts such as "G,I" and "V" do not work.

How do I make Mimestream the default email client?

Option 1: Open Apple Mail to change the default email client, following the instructions on Apple's support site. You will be required to add an account first, if you haven't.

Option 2: Download Microsoft's SetDefaultMailApp tool and set com.mimestream.Mimestream as the default.

Unfortunately, Mimestream cannot offer this option in the app. Mimestream is a sandboxed application targeted for the App Store, and macOS security restrictions currently prevent sandboxed applications from changing the default email client.


Commonly Requested Features

Can Mimestream support snoozing messages?

Unfortunately, the Gmail API does not support snoozing messages. Please star the Gmail API bug to vote for this, but do NOT comment "+1".

In the meantime, we are considering adding an opt-in "Labs" feature to allow client-side snoozing of messages. This has the caveat of not syncing back to Gmail, and if you were to look at the Inbox on Gmail, the message would still be there.

Can Mimestream support scheduled send?

Unfortunately, the Gmail API does not currently support scheduled send. Please star the Gmail API bug to vote for this, but do NOT comment "+1".

If Google were to add this to the public Gmail API, Mimestream would swiftly add support for scheduled send!

Will Mimestream support filtering by "Unread"?

Yes, there has been strong demand for this feature, and this is planned.

Will Mimestream support general sorting of the message list?

This is not on the short-term roadmap. We will need to complement the Gmail API with support for IMAP, which has features that are more optimized towards sorting. In the longer term, this is a desired addition to Mimestream.

Will Mimestream support a "Move To" menu for messages?

Yes, this is planned and is coming soon. In the meantime, you can drag messages and drop them on a label in the Sidebar.

Will Mimestream support Priority Inbox sections?

Yes, there has been strong demand for this feature, and this is planned.

Will Mimestream support printing?

Yes, this is planned to happen during the beta.

Will Mimestream support a compact, single-line message list?

Yes, there has been strong demand for this option, and this feature is planned.

Will Mimestream support a horizontal split view layout?

Yes, there has been strong demand for this option, and this feature is planned.

Will Mimestream support inline reply in the main window?

Yes, there has been strong demand for this option, and this feature is planned.

Will Mimestream support Undo Send?

Yes, there has been strong demand for this option, and this feature is planned.

Will Mimestream add a Menu Extra?

Yes, there has been strong demand for this, and this feature is planned.

Will Mimestream allow me to disable conversation view?

Yes, there has been strong demand for this, and this feature is planned.

Will Mimestream support accepting calendar events within the app?

There has been strong demand for this. While it is not a short term item, this is a feature we plan to eventually add.

Can Mimestream support muting conversations?

Unfortunately, the Gmail API doesn't support muting conversations. Please star the Gmail API Issue to vote for this, but do NOT comment "+1".

If Google were to add this to the public Gmail API, Mimestream would swiftly add support for muting conversations!

Can Mimestream support Gmail's alternate/colored stars?

Unfortunately, the Gmail API doesn't support alternate/colored stars. Please star the Gmail API bug at Gmail API bug to vote for this, but do NOT comment "+1".

If Google were to add this to the public Gmail API, Mimestream would swiftly add support for the alternate stars!

Will Mimestream let me pick what browser to log in with?

Yes, there has been strong demand for this, and this feature is planned.

Will Mimestream let me pick what browser to open links with?

Yes, there has been strong demand for this, and this feature is planned.

Will Mimestream autocomplete Gmail contacts?

Yes, there has been strong demand for this, and this feature is planned. Currently, autocomplete is based off your most recent messages, as well as your local Contacts app address book.

Will Mimestream autocomplete G Suite directory contacts?

Yes, there has been strong demand for this, and this feature is planned.

Will Mimestream support hiding labels from the sidebar?

Yes, Mimestream intends to sync the "Show", "Show if Unread", and "Hide" label settings from Gmail. This is a planned feature.

Will Mimestream be translated/localized for other languages?

Yes, Mimestream plans to localize for other languages as it gets closer to a 1.0 launch. If you are able to volunteer to help translate into your native language, please email feedback@mimestream.com!

Will Mimestream support the Touch Bar?

Yes, this will happen before the app reaches 1.0.

Will Mimestream support extensions or add-ons?

This is not planned in the short term. However, longer-term, this is something we are interested in adding.

Existing Gmail add-ons cannot be used with Mimestream.

Will Mimestream support Templates?

Template support is planned. Note, currently Gmail's Templates are exposed by the Gmail API as Drafts without any distinguishing markers, see https://issuetracker.google.com/u/1/issues/168223591.


Common Issues

The app keeps crashing, what should I do?

First, we would love to get some diagnostics from you. Open Terminal, and run the following command:

/Applications/Mimestream.app/Contents/Resources/collectDiagnostics.sh 
Please send the output (on your Desktop) to bugs@mimestream with a brief description of the problem.

Then, you may try resetting your cache to see if that clears up the problem. Run the following command:

rm -rf ~/Library/Containers/com.mimestream.Mimestream/Data/Library/Application\ Support/Mimestream/{Attachments,Mimestream*}

I'm not getting any notifications for new email!

Please check to make sure that Notifications are enabled in system preferences. Open System Preferences, click Notifications, select Mimestream from the list, and ensure that notifications are enabled.


Getting Support

What do I do if I've hit a bug?

Please email bugs@mimestream.com to report a bug. Bug reports are extremely helpful and your feedback is very much appreciated!

How do I suggest a feature?

To suggest a feature, please e-mail feedback@mimestream.com.

While every feature requested cannot be implemented, features are prioritized based on user demand, so your feedback and suggestions are very helpful!

How do I contact support?

Please e-mail support@mimestream.com to contact support.


Privacy and Security

Where is my email data stored?

Mimestream follows the model of a traditional e-mail client: a cache of your recent messages are stored on your device, and the originals remain on the Gmail server. Mimestream communicates directly from your device to Google's APIs, without using an intermediary server. In addition, your account's access tokens stay on your device.

Mimestream's use of information received from Gmail APIs will adhere to Google's Limited Use Requirements.

Where are my email credentials stored?

When you grant Mimestream access to your Google account, Mimestream receives tokens and stores them in your Mac's keychain. Your Google account's password is not stored in the Keychain by Mimestream, and isn't even seen by the Mimestream app during the Oauth authentication flow.

Can you read my email?

No. Mimestream is a local app that stores your data and access tokens directly on your device. Mimestream does not run any servers with access to your email.

How is push handled?

Mimestream makes a direct IMAP connection from your Mac to imap.gmail.com on port 993, and then uses the RFC 2177 IDLE extension to listen for new message notifications. Notifications are only received while Mimestream is running.


Pricing

How much does this app cost?

Pricing has not been set yet, and will be determined closer to 1.0.

Why will this app cost money?

Mimestream's core business is developing high quality e-mail software. Instead of monetizing your e-mail data for advertising or market research purposes, Mimestream generates revenue by charging for our software.

Do you offer an enterprise site license?

Yes! A site license is a great way to offer Mimestream to all of your employees and boost their productivity, while being confident in the secure handling of your organization's email data and credentials.

Please contact us with how many seats you'd like, and you will get a custom quote.