Nextcloud Mail Extension (for Apple Mail)

Nextcloud Mail Extension Icon

NextcloudMailExtension is an extension for Apple Mail on macOS. When you send an email, its attachments are uploaded to your Nextcloud server and replaced in the email by share links. Recipients download the files from your server, and your email stays small — no more bounces for oversized mail, no more dependence on Apple’s Mail Drop or a provider’s attachment limit.

Index

How it works

Attach files to an email in Mail as usual, make sure Sign is on, and hit Send. The extension uploads each file to a subfolder for that email in your Nextcloud, and puts links in their place:

Compose as usual, with Sign on

An email where the attachments became links

What recipients see when they open the links

Requirements

Installing

  1. Download latest release, or here are release notes and you can find DMG under Assets
  2. Mount DMG and drag the app NextcloudMailExtension.app into an Applications folder: /Applications for every user of the Mac, or ~/Applications (the Applications folder in your home folder) for you only. Keep only that one copy, and delete any other, such as one left in Downloads, since macOS may use it instead. Start the app once, to log in to your Nextcloud server and set your preferences. If macOS asks whether NextcloudMailExtension may find devices on your local network, allow it. macOS asks only when your Nextcloud server is on your local network.
  3. In Mail, open Settings → Extensions and enable NextcloudMailExtension.
  4. If Mail shows a “Message security extension” popup, choose NextcloudMailExtension there. (The extension takes over the Sign button in the message window: with Sign on, Mail hands the outgoing message to the extension, which is what makes the upload possible.)
  5. Restart Mail.
  6. Open a new message and click the extension’s toolbar button, the one with Nextcloud’s logo. If macOS asks whether “NextcloudMailEx” may find devices on your local network, allow it too. That’s the extension in Mail, which needs a permission of its own, listed in System Settings as NextcloudMailExtensionPlugIn.
  7. Turn on Sign, the badge button at the right of the subject line. Files become links only while it’s on, and it stays on for later messages.

Enabling the extension in Mail's settings

When an email is over your email provider’s size limit, Mail asks about Mail Drop before the extension gets its turn. Choose Try Sending in Email, and tick Don’t ask again for this account. The files then travel via your Nextcloud, not via Mail Drop, and the email stays small. If you choose Use Mail Drop instead, the email goes out with Mail Drop’s link, and the files already uploaded for it are deleted from Nextcloud.

Mail asking about Mail Drop for a large email

What you can control

In the app’s settings

The app holds login and all settings

Per email, from the extension’s toolbar button in Mail

Per-email settings in the message window

Good to know

Privacy

No telemetry. Files go only to the server you configured; message contents, addresses and passwords are never logged; credentials live only in the macOS Keychain.

Why Sign is used

You might ask why Sign is used. Well, as of now that is the only way an Apple Mail extension can officially alter message data on send. For a technical intro, see the project’s README, which has a rant on history and this extension. Anyway, you’re welcome.