Previous Next  Up  Table of Contents  EagleFiler 1.7.3 Manual  Technical Support

3.5.1   Importing Mail From Apple Mail

The recommended way to import from Apple Mail is to select some messages and press the capture key (F1 or fn-F1). EagleFiler will copy the entire message (including attachments) to its library, along with the message status and flagged indicators from Mail and any keywords, projects, and notes from MailTags.

By default, EagleFiler imports a single selected message as a .eml message file and multiple selected messages as a mailbox file. Please see the Importing Mail section for more information about these formats.

Importing Multiple Mailboxes

To import multiple whole mailboxes at once, first select the mailboxes in Mail’s sidebar. You can either Command-click to select individual mailboxes or select a whole range of mailboxes by clicking on the first one and then Shift-clicking on the last one. Once the mailboxes are selected, use the Edit ‣ Select All command to select all the messages. Then press EagleFiler’s capture key.

Importing Message Files

To import multiple messages as individual .eml files instead of as mailbox files, capture one message at a time or use the Import From Apple Mail script.

Importing Mailbox Hierarchies

Another way to import from Apple Mail is to drag and drop folders or mailboxes from the Finder. This makes it possible to import whole hierarchies of mail. The mailboxes are stored in the folder:


(See How can I open the Library folder?.) Inside the V4 (or other V folder for previous versions of macOS) is a folder for each account (named with a UUID or your e-mail address, and inside the account folder a folder for each mailbox.

Importing via Mail’s File Menu

Yet another way to import from Apple Mail is to use Mail’s File ‣ Save As… menu command. This works even if EagleFiler is not running, and you can select anywhere in The Files Folder or the The To Import Folder to save the file. Be sure to select Raw Message Source from the Format pop-up menu. If a single message is selected, Mail will save it in .eml format. If multiple messages are selected (and you have macOS 10.12 or later), Mail will save them in mbox format. For larger mailboxes, it may initially look like the save didn’t happen, but Mail will eventually create the file.

Importing Attachments

EagleFiler tries to import complete messages, including any attached files. For messages downloaded from POP mail servers or stored in local (On My Mac) mailboxes, this should always succeed because Mail stores the attachment data with the message. For messages from IMAP and Exchange mail servers, the attachment data may or may not have been downloaded to your Mac. If you try to import a message whose attachments have not been downloaded, EagleFiler will report a Missing Apple Mail Attachment error and import only the non-attachments parts of the message.

To successfully import attachments, you should:

  1. Make sure that Mail is set to always download attachments from the server. To do this, go to the Accounts pane of Mail’s preferences and (for each account) tell it to download the attachments:

    macOS 10.12: On the Account Information tab, for Download Attachments select All. Additionally, do not use the new Optimize Storage OS feature to automatically remove e-mail attachments.

    Mac OS X 10.11 through 10.9: Mail always downloads complete messages.

    Mac OS X 10.8 and earlier: On the Advanced tab, for Keep copies of messages for offline viewing select All messages and their attachments.

  2. If you get a Missing Apple Mail Attachment error, e.g. because of messages that were downloaded before (or purged after) following the instructions in #1, you can tell Mail to download the attachments and then tell EagleFiler to import the messages again. To way to tell Mail to download the attachments is to view the message in Mail. The easiest way to do this is to select the error(s) in EagleFiler and Option-click the Reveal button. This opens the message files in Mail. Once the attachments have loaded in the message windows, you can close the windows and then try the import again.

Importing Conversations

If you have View ‣ Organize by Conversation checked, Mail behaves differently depending on whether you have Use classic layout checked in the Viewing preferences.

To import both sides of a conversation, Command-click in the mailbox list to select the Sent mailbox as well as the mailbox containing the received messages. Then Mail’s conversation view will show both types of messages in the list. You may also find it helpful to use a smart mailbox to display related messages from different mailboxes, and then capture from the smart mailbox.

Importing an entire mailbox is much simpler. You can always use Edit ‣ Select All to select all the messages, regardless of whether Mail is in conversation mode or which triangles are expanded.

Apple Mail “.mbox” Mailboxes

Apple Mail stores its mail in two types of folders whose names end with .mbox, however neither of these uses the actual mbox format:

Capturing When Mail Is Busy

In order to safely read Apple Mail’s message data, Mail should not be in the process of downloading messages from the server or moving them between mailboxes when you press the capture key.

macOS 10.12 and Mac OS X 10.11: You can look in the Activity pane at the bottom of the mailbox list to make sure that Mail is idle. EagleFiler will report an error if it tries to import an e-mail message that was not completely written to disk.

Mac OS X 10.10 and earlier: EagleFiler will report an error if Mail is busy. The Activity window is a more accurate measure of this than the Mail Activity pane in Mail’s main viewer window. If you press the capture key and EagleFiler detects that Mail is busy, it will suggest that you try again later. You can click Cancel and wait until Mail has finished downloading mail or use the Mailbox menu to take it offline. You can also click Capture Anyway to proceed if you know that Mail is not doing anything with the messages that you had asked it to capture.

apple mail activity

Duplicate Message

When importing from Apple Mail, EagleFiler automatically skips a message if it is an exact duplicate of another message in the same mailbox that was already imported. Thus, it can be normal for the mailbox in EagleFiler to show fewer messages than the mailbox in Apple Mail.

Mail Perspectives

If you have a Mail Perspectives window open (and it’s frontmost), EagleFiler will capture the selected messages from that window, rather than from the regular viewer window.

Previous Next  Up  Table of Contents  EagleFiler 1.7.3 Manual  Technical Support