Portable Thunderbird Launcher 1.0.9
===================================
Written by John T. Haller
- with additional code from Free The Fox by mai9 and fflaunch by tracon

Website: http://portablethunderbird.mozdev.org/


ABOUT PORTABLE THUNDEBIRD
=========================
The Portable Thunderbird Launcher allows you to run Thunderbird from a removable drive whose letter changes as you move it to another computer.  The email client and the profile can be entirely self-contained on the drive and then used on any Windows computer.  Specific configuration changes are made to the chrome.rdf so that your extensions will still work as the drive letter changes.


LICENSE
=======
This code is released under the GPL.  The full code is included with this package as PortableThunderbird.nsi.


INSTALLATION / DIRECTORY STRUCTURE
==================================
By default, the program expects one of 3 directory structures:

-\ <--- Directory with PortableThunderbird.exe
  +\thunderbird\
  +\plugins\
  +\profile\

OR

-\ <--- Directory with PortableThunderbird.exe
  +\PortableThunderbird\
    +\thunderbird\
    +\plugins\
    +\profile\

OR

-\ <--- Directory with PortableThunderbird.exe
  +\PortableApps\
    +\PortableThunderbird\
      +\thunderbird\
      +\plugins\
      +\profile\


It can be used in other directory configurations by including the PortableThunderbird.ini file in the same directory as PortableThunderbird.exe and configuring it as details in the INI file section below.  The INI file may also be placed in a subdirectory of the directory containing PortableThunderbird.exe called PortableThunderbird or 2 directories deep in PortableApps\PortableThunderbird.  All paths in the INI should remain relative to the EXE and not the INI.


PORTABLETHUNDERBIRD.INI CONFIGURATION
=====================================
The Portable Thunderbird Launcher will look for an ini file called PortableThunderbird.ini within its directory.  If you are happy with the default options, it is not necessary, though.  The INI file is formatted as follows:

[PortableThunderbird]
ThunderbirdDirectory=thunderbird
ProfileDirectory=profile
PluginsDirectory=plugins
AdditionalParameters=-commandline -parameters
AllowMultipleInstances=false
SkipChromeFix=false
SkipCompregFix=false
WaitForThunderbird=false
ThunderbirdExecutable=thunderbird.exe

The ThunderbirdDirectory, ProfileDirectory, and PluginsDirectory entries should be set to the *relative* path to the directories containing Thunderbird.exe, your profile and your plugins from the current directory.  All must be a subdirectory (or multiple subdirectories) of the directory containing PortableThunderbird.exe.  The default entries for these are described in the installation section above.

The AdditionalParameters entry allows you to pass additional commandline parameter entries to Thunderbird.exe.  Whatever you enter here will be appended to the call to Thunderbird.exe.

The AllowMultipleInstances entry will allow Portable Thunderbird to run alongside your regular local copy of Thunderbird if you set it to true (lowercase).  The default is false.

The SkipChromeFix entry allows you to set Portable Thunderbird not to adjust the chrome.rdf for extension compatibility on launch.  It is useful if you are only using Portable Thunderbird on computers you control and are able to have the drive letter set the same each time as Portable Thunderbird will launch more quickly.  Set it to true (lowercase) to skip chrome.rdf processing.  The default is false.

The SkipCompregFix entry allows you to set Portable Thunderbird not to adjust the component registry (compreg.dat) for certain extension compatibility on launch.  It is useful if you are only using Portable Thunderbird on computers you control and are able to have the drive letter set the same each time or if you are not using extensions which make use of the component registry (like Mozilla Calendar) as Portable Thunderbird will launch more quickly.  Set it to true (lowercase) to skip chrome.rdf processing.  The default is false.

The WaitForThunderbird entry allows you to set the Portable Thunderbird Launcher to wait for Thunderbird to close before it closes.  This option is mainly of use when PortableThunderbird.exe is called by another program that awaits it's conclusion to perform a task.

The ThunderbirdExecutable entry allows you to set the Portable Thunderbird Launcher to use an alternate EXE call to launch Thunderbird.  This is helpful if you are using a machine that is set to deny Thunderbird.exe from running.  You'll need to rename the Thunderbird.exe file and then enter the name you gave it on the ThunderbirdExecutable= line of the INI.


PROGRAM HISTORY / ABOUT THE AUTHORS
===================================
This launcher contains elements from multiple sources.  It began as a batch file launcher written by myself (John T. Haller) and posted to the mozillaZine.org thread about running Firefox from a USB key.  tracon later released a launcher called fflaunch which I enhanced and re-released as Portable Firefox.  mai9 later improved on fflaunch's techniques and released it as Free The Fox.  Multiple suggestions back and forth as well as improvements from mai9, myself and others lead to the launcher we have today.  This most recent version adds some of mai9's methods for running multiple copies of Firefox and my methods for allowing the code to be run from anywhere on first launch (as opposed to a specific directory), pass in commandline options, run without an ini file and allow the use of profiles from local installations.


CURRENT LIMITATIONS
===================
SOME THEMES FAIL - Some themes may not work correctly with Portable Thunderbird

LOCAL FILES CREATED - A directory (%userprofile%\Application Data\Thunderbird) is created on the local machine (if Thunderbirdis not installed locally) and a pluginreg.dat file is created within it. A Talkback directory is also created.  This is a limitation of Thunderbird itself.

INCOMPATIBLE EXTENSIONS - Certain extensions use additional local files or prefs.js to store information, neither of which are handled by the Portable Thunderbird launcher when moving between machines.

WRITE ACCESS REQUIRED - Both the Thunderbird directory and the profile directory must be writeable on the USB drive. Drives with a writable switch can not be in read-only mode.