EMPTI Files

********************************************************************************
*     Eudora Mailboxes Preparer for Thunderbird's Importer (EMPTI) v. 1.2      *
*                           by Andre Gregori                                   *
********************************************************************************

Dear Users,
Please note that the following instructions work with Thunderbird 2. I have had
users reporting that these instructions were not successful for Thunderbird 3.
One user reported that, if you do open Eudora between steps 3 and 4 of section 4
below (which allows Eudora to re-index the TOC files), Thunderbird 3 does
successfully import. I have not tried this myself but it may be worth a shot.
Alternatively, you can downgrade to the last version Thunderbird 2, migrate
your Eudora files over, then upgrade to Thunderbird 3 again (this method, I can
assure you, will work).

Best wishes,
Andre 

--------------------------------------------------------------------------------
| Contents                                                                     |
--------------------------------------------------------------------------------

0. License
1. Purpose
2. Version updates
3. Installation
4. Use

--------------------------------------------------------------------------------
| 0. License                                                                   |
--------------------------------------------------------------------------------

This software as well as its code is licensed under the GNU General Public
License (GPL) v. 3. Please see license.txt.

--------------------------------------------------------------------------------
| 1. Purpose                                                                   |
--------------------------------------------------------------------------------

The purpose of this small program is to help  users who are switching from
Eudora to Thunderbird  e-mail client, but who would still like to keep  their
data intact. Ultimately, one of the biggest  challenges in switching from Eudora
is to keep the  email messages linked to their respective  attachments. As
Eudora keeps a separate attachment  folder of its own, it does not, unlike
Thunderbird,  keep a copy of every attachment received and sent  within the data
of the individual messages.

The Thunderbird importer seems to handle files  attached to received messages
quite well; it does  not, however, import the attachments of sent  messages
(messages in your Out box).

To solve this, this little program was written.  Basically what it does is it
looks at each message  in your mailboxes and tries to see if it has fields 
which begins with the words, "Attachment Converted."  These are the fields that
the Thunderbird importer  looks for when it is trying to find attachments.  By
default, Eudora does not add these fields to sent  messages; rather, it keeps
track of attachments by listing them under the "X-Attachments" field. What  this
program does is it opens each of Eudora's .mbx  files, takes the information
contained in each  message's "X-Attachments" field and replicates it  by adding
new "Attachment Converted" fields.  This program outputs new .mbx files that can
be used  to replace the original .mbx files in the Eudora folder, so that when
you launch the Thunderbird  import utility it will also copy attachments linked 
to sent messages.

Please be advised that if you launch Eudora after  you've replaced the .mbx
files it might want to  reindex your mailboxes, which would result in the  loss
of a variety of useful data (such as messages'  read/unread status, labels,
etc). Therefore, it  is highly recommended that you BACKUP your Eudora 
completely before you replace your original .mbx files.

This program might work with the import utilities of   other e-mail clients, but
this hasn't been tested.  If you end up testing it with other email clients, 
please let me know how it goes by writing to me at
http://www.andregregori.com/contact.php

Feel free to redistribute this program, so long as  you include the fact that I
wrote it and make the code  available with each redistribution. Feel free to
make  changes to the code, although these changes must be documented if they are
to be redistributed with this  program. Sale of this program, or the bundling of
it  with any other program bound for sale, is forbidden.

Keep it open source, keep it free.

--------------------------------------------------------------------------------
| 2. Version updates                                                           |
--------------------------------------------------------------------------------

Version 1.2 - December 1st, 2009
================================
	a. Fixed bug preventing utility from seeing Mailbox files with uppercase
	   extensions (".MBX").


Version 1.1 - June 1st, 2009
============================
	a. Greater Mac OS X support:
		i.  Correctly identifies Mac OS X filetypes
		ii. Uses correct standard Mac Eudora line-endings (Cr)
				
		NB: Still no support for the Mac version of Eudora's idiosyncratic
		format for sent attachment paths. See how you can help with this issue
		here: http://forums.mozillazine.org/viewtopic.php?f=39&t=1268175#p7458285

	b. Mailbox files in subdirectories are now automatically processed by the
	   program

--------------------------------------------------------------------------------
| 3. Installation                                                              |
--------------------------------------------------------------------------------

After you extract the contents of the .zip file containing the binaries, no
installation is required if you already have a Java Virtual Machine (JVM)
installed on your system. If not, please go to www.java.com and download the
latest Java Runtime Environment (JRE).

--------------------------------------------------------------------------------
| 4. Use                                                                       |
--------------------------------------------------------------------------------

[OPTIONAL] STEP 0: Use EudRescu to keep messages' statuses
==========================================================

If you'd like to keep the statuses of your messages, (i.e. read/unread,
flagged/unflagged, etc.), I highly suggest downloading and running Qwerky's
EudRescu (compatible only with Windows), which runs from the command line. Use
it at your own risk, of course. Note that EudRescu alone will not suffice for
fixing the problem with importing your sent attachments. It does, however,
provide the nifty feature of prepping your .mbx files so that they retain a lot
of useful information that would otherwise be lost. Also, please note you have
to run EudRescu *before* you run EMPTI (this is because EudRescu depends on
accessing .toc files, which EMPTI does not). If you do run EudRescu, note that
the "origin directory" that you will supply when running EMPTI will be the
directory to which you saved EudRescu's modified .mbox files.

You can find more information about EudRescu here:
http://qwerky.50webs.com/eudorarescue/readme.htm

Thank you Qwerky for providing this very useful tool!


STEP 1: Fix your mailboxes
==========================

This program works through the command line.

Access a console (on a Windows machine, open a Command Prompt; on Mac, open a
Terminal). Navigate to the directory in which you saved EudAttachFixer.jar. Then
type:

java -jar EudAttachFixer.jar [path to your Eudora data folder] [path to folder
where you will store the fixed .mbx files]

  NB: If any of these paths has spaces in them, then enclose them in quotes.

For example:

java -jar EudAttachFixer.jar "C:\Eudora" "C:\FixedMailboxes"


STEP 2: Backup your Eudora data folder
======================================

It is wise to backup your entire Eudora data folder. Most traditional Eudora
users liked to have their data in the very directory containing the Eudora
program files; a lot of recent users have also started storing their personal
data in system-specified user folders (like "C:\Windows\Documents and
Settings\Application Data\Eudora"). Whatever the case, it is wise to create a
copy of the directory containing your data somewhere else on your machine, in
case things go wrong. If things do go wrong, then you can simply replace the
deficient Eudora folder for the backed up one.


STEP 3: Replace original Eudora .mbx files for fixed .mbx files
===============================================================

Navigate to the directory in which you saved your fixed .mbx files. Copy them,
then paste them in your Eudora folder, overwriting the original .mbx files.

NOTE: DO NOT OPEN EUDORA. If you do, it will try to re-index your Table of
Contents and will mess up part of your data.

ALSO NOTE: It is important that you paste the fixed .mbx files into THE ORIGINAL
EUDORA FOLDER, not a backed-up folder in another location. The reason this is
important is that the Thunderbird importer will try to locate attachments in
reference to the original Eudora folder. If you paste the fixed .mbx files in
another location, the Thunderbird importer will not work with these fixed files.


STEP 4: Open Thunderbird and start import
=========================================

Assuming you have already installed Mozilla Thunderbird, open it. If this is
your first time running Thunderbird, it should automatically request to import
data from other programs, at which point you should select "Mail," then
"Eudora." If it does not automatically show this prompt, go to the Tools menu,
and select Import. Also select "Mail," then, on the next screen, "Eudora."
Follow the steps in the Thunderbird importer through to completion. After the
importer finishes its work, you should have all your Eudora mail in Thunderbird,
with attachments linked to both received AND sent messages. Success!