Table of Contents goerke.tech
Converting your data with Olminator

Converting .olm files with Olminator

Once you've exported your Microsoft Outlook for Mac data into an .olm file, we're ready to start the conversion process in Olminator.

Before you can start converting

After having started Olminator for the first time and having come past the Welcome screen, you'll get presented with the Get Started view:

Before you can press the "Start" button at the bottom of the Olminator window, there's only two things you have to do:

  1. Select the .olm input file: You have to select your .olm input file for the conversion.
  2. Select the output folder: You have to provide a folder location into which the conversion results will be placed.

Simply click the respective input area for the Input File or Output Folder fields at the top of Olminator's window, or drag & drop one or more .olm files and a folder into those fields. Olminator is also registered with macOS as application capable of handling ".olm" files, so double-clicking a .olm file in Finder or selecting and right-clicking it in Finder and then selecting "Open with.../Olminator" will get the job done as well.

Once you've selected an input file and an output folder, Olminator's entire main window will become alive. If you restart Olminator a second time, you'll skip the "Get Started" step and get to the main window directly:"

Caveat: As long as Olminator is analyzing an input file or while it is busy converting, it will not accept new input .olm files dragged & dropped or passed to Olminator via Finder's "Open" or "Open with..." functionality. Once the analysis or the conversion has finished, it will of course accept new input.

Straightforward conversion on the Home tab

Once you've defined the ".olm" input file(s) with the above, Olminator will quickly inspect it/them (which will take at most a few seconds) and then you'll be able to press the "Start" button and get the "magic" going.

Make sure you're on the "Home" screen of Olminator if you want to start a straightforward conversion of the .olm archive you've selected. A straightforward conversion triggered on the Home screen will always process the entire archive independent of the sub-folders you may or may not have checked on the Viewer tab. Olminator will convert just everything it will find in the archive, using the configuration settings as defined in Olminator's Settings tab, of course.

A progress indicator will show you how the conversion is proceeding, whether any warnings or errors have been issued, how much time it will approximately take to finish the entire procedure.

In the lower right corner you'll find a little magnifier glass button which you can click to reveal a more detailed progress view just in case you are interested (or bored watching the current view) – the one for the geeks.

Olminator will create a new "Olminator" sub-folder within your output folder. If there is already an "Olminator" directory present, it will create an "Olminator 2" folder (and so on) to preserve already existing conversion content. Olminator will therefore never overwrite any conversion output that you may have created in a prior conversion run with Olminator. It also means that you have to clean up your output folder when you're completely done with a conversion and want to reclaim the disk space which was used by Olminator. After a conversion run you'll find all conversion output as well as the Olminator success and error log files within this "Olminator" sub-folder.

Caveat: To convert the entire input of the .olm file, Olminator will create output that will be approximately of the same size as the input .olm file (likely it's a bit less). Make sure there is sufficient free disk space available in the file system of the output folder's volume! Otherwise the conversion may run into "out of disk space" issues during the conversion.
Olminator will show a warning if it suspects there may be a free space problem with your selections. If no warning shows up, you should be fine. Otherwise it may be advisable to choose a different output volume or free up disk space on the volume you selected before converting.

Selective Conversion on the Viewer tab

The Home sheet provides you with the most straightforward conversion experience possible: Press 'Start' and watch your entire .olm archive being converted to item-specific formats for importing into your favorite productivity apps afterwards. But there may be times when you want to have more control over what subsets of items in the .olm archive exactly get converted. This is when the Viewer sheet becomes the place to be.

By default, Olminator will simply convert the content of the entire .olm file you're providing. Since "Microsoft Outlook for Mac" will always export all accounts configured as well as the entire folder structure of emails, calendars, etc., you might end up with too many items being in the .olm file that you don't want to convert completely. You can fine-tune the selection of what content (e.g. only your local account or certain sub-folders within your account's inbox) goes into the conversion process by navigating to the "Viewer" tab in Olminator's navigation bar (below the input and output fields). The viewer will present you with an outline of the content structure of your .olm file on the left side of the window.

On the Viewer sheet you can then select individual folders from your .olm archive in the folder list on the left side of the window. Once a folder in the folder tree has been selected, you can press the "Start converting into [format]" button at the bottom and Olminator will turn the selected folder plus all its checked sub-folders' items into the selected target format.

Advanced Configuration

By default, Olminator is configured to handle your input .olm file without any need for fiddling around with settings. It will simply convert all input contained in the .olm file, honor file size limits and other constraints that some vastly popular email, calendar and contacts applications on your Mac may be thankful for.

In the unlikely event that those default settings won't work for you, you can adapt them to your needs to some extent. For details about changing the default configuration settings, please refer to the Configuring Olminator page.


Monitoring the conversion progress

Screenshot of Olminator's Home Sheet

Once you start the conversion by pressing the "Start" button at the bottom of the Olminator window, progress of the conversion is displayed by indicating the approximate percentage of work done as well as an estimate of the time remaining til completion.

If you're interested in getting more details or just enjoy the hypnotic nature of filenames and numbers flickering over a screen, you may click the little chevron symbol to the right bottom of the Progress overview sheet. This will open up a Progress details view into the conversion process. Enjoy.

You can stop a running conversion at any point in time by pressing the "Stop" button next to the "Start" button. The conversion will immediately stop.

Hint: You can't resume a conversion from where you left of by pressing "Stop". Pressing the "Start" button again will start the conversion of your .olm input file from scratch.

After the conversion

Congratulations! When the conversion has been completed, Olminator will tell you so by showing the text Done! in the progress indicator on screen.

Furthermore, three additional buttons will show up at the bottom of the Olminator window:

  1. Open Error Log: Nobody is perfect and as explained in the section about advanced configuration of Olminator, there might have been cases during the conversion process where Olminator could not properly convert an item without loss of information. Those unfortunate situations – or other potentially concerning trouble – will be logged into the error log for your reference and potential counter-measure.

    Hint: The error log is placed into the output folder you provided and is named "olminator_errors.log".

  2. Open Output Folder: Clicking this button will make Finder open a window pointed to your output folder. Screenshot of Olminator's Home Sheet This comes handy if you want to take a look at the conversion output to check that it meets your expectations or to delete or rename any folders or files in there before you import them into your email, calendar, contacts or notes applications of your preference.
  3. Help Me Importing: This button will open the detailed progress view of Olminator (you can also get there by clicking the little chevron symbol in the bottom right corner of the 'Home' view). Here you'll see more detailed information about the conversion progress and/or its result. In the lower part of that section you'll see the folder structure of your converted .olm file and for each main item-type you'll find a button "Import into [respective Apple productivity app]".
    For calendar, contact and notes items Olminator can fully automatically trigger the import of the conversion result for you if you click the respective button, for emails this is – for security reasons that Apple enforces around Apple Mail (for good reason!) – not automatically possible and hence you'll have to trigger the import manually within Apple Mail (see Importing).
Previous page Back to top Next page