Quantum Tunnel

Fixing disabled bundles/plugins for Mac Mail

Mail icon
Mail icon (Photo credit: Wikipedia)

I confess (not that you might not know, but still…) that I am a mac user. I have been for some time now and I quite like it. As such I have got used to using Mail.app for checking my email although I am well aware that it is by no means the best email client ever. Nonetheless, I do use it, and I do in conjunction with some useful plugins such as TruePreview and Universal Mailer that help improving the experience. TruePreview lets me scan an email without marking it as read, whereas Universal Mailer removes some annoying ATT00001.htm files that recipients get and correctly formats messages with attachments and inline images. They both work quite well… until Apple decides to upgrade the Mail.app and disables the plugins. One thing that you can do when this happens is to shake your fist in the air, curse a bit and wait until the plugins get updated. Or… you can try this and hope that the plugin starts working by adding the correct Universally Unique Identifier, or UUID, to the plist file. Here is how and please note that the UUID values quoted are valid for Mail.app 6.6 (OS X 10.8.5):

  1. Quit Mail
  2. Open Terminal
  3. Type: cd Library/Mail
  4. If you request a list of the files (using ls) you should see a folder like “Bundles (Disabled)”
  5. Type: cd Bundles (Disabled) – Note that the folder may be numbered, so check the contents…
  6. If you are trying to fix TruePreview then type: cd TruePreview.mailbundle/Contents
  7. If you are trying to fix Universal Mailer then type: cd UniversalMailer.mailbundle/Contents
  8. This may also work for other plugins… so check the correct folder.
  9. Once you are in the correct folder for the plugin, type: open -e Info.plist
  10. The command will launch a text editor and you will be able to edit it. Go towards the end of the file and add the following lines:


With the recent release of Mavericks, the Mail.app application is currently version 7.0. The correct strings to use are as follows:


Please note that although the above strings make Mail accept plugins such as TruePreview, the functionality does not work. 
In the case of Universal Mailer, there is an update for Mavericks here.
Once that is done, save the file and close it. Back in the Terminal
  1. Type: cd ../..
  2. Now we need to move the “Disabled” plugin to the working folder. For TruePreview type: mv TruePreview.mailbundle ../Bundles
  3. A similar command can be used for other plugins
  4. Finally, launch Mail
  5. And Voilà

So, what happens next time that the Apple gods decide to update Mail? Well, you can obtain the correct UUIDs as follows:

defaults read /Applications/Mail.app/Contents/Info PluginCompatibilityUUID

defaults read /System/Library/Frameworks/Message.framework/Resources/Info PluginCompatibilityUUID

Each of them will return a two different strings that are the new UUIDs for Mail.app running under. You then need to add those strings to the info.plist file as explained above.

This may come handy when Mavericks is finally out… Then again, things may have changes a lot behind the scenes…

Let me know if you have found this tip helpful!