Portable Firefox Launcher 1.1.2 =============================== Copyright (C) 2004-2005 John T.

Haller Portions Copyright 2004 mai9 Website: http://portableapps.com/portable_firefox This software is OSI Certified Open Source Software. OSI Certified is a certification mark of the Open Source Initiative. This program is modify it under as published by of the License, free software; you can redistribute it and/or the terms of the GNU General Public License the Free Software Foundation; either version 2 or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. ABOUT PORTABLE FIREFOX ====================== The Portable Firefox Launcher allows you to run Firefox from a removable drive w hose letter changes as you move it to another computer. The browser and the pro file can be entirely self-contained on the drive and then used on any Windows co mputer. 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. Within the PortableFirefoxCode directory y ou will find the code (PortableFirefox.nsi) as well as the full GPL license (Lic ense.txt). If you use the launcher or code, please give proper and prominent at tribution. INSTALLATION / DIRECTORY STRUCTURE ================================== By default, the program expects one of these directory structures: -\ <--- Directory with PortableFirefox.exe +\firefox\ +\profile\ +\plugins\ (optional) +\appdata\ (optional) +\userprofile\ (optional) OR -\ <--- Directory with PortableFirefox.exe +\PortableFirefox\ +\firefox\ +\profile\ +\plugins\ (optional) +\userprofile\ (optional)

+\appdata\ (optional) OR -\ <--- Directory with PortableFirefox.exe +\PortableApps\ +\PortableFirefox\ +\firefox\ +\profile\ +\plugins\ (optional) +\appdata\ (optional) +\userprofile\ (optional) OR -\ <--- Directory with PortableFirefox.exe (PortableApps, for instance) +\Apps\ +\PortableFirefox\ +\firefox\ +\plugins\ (optional) +\Data\ +\PortableFirefox\ +\profile\ +\appdata\ (optional) +\userprofile\ (optional) OR -\ <--- Directory with PortableFirefox.exe (PortableApps, for instance) +\Apps\ +\PortableFirefox\ +\firefox\ +\plugins\ (optional) +\Data\ +\PortableFirefox\ +\profile\ +\UserProfile\ +\Application Data\ It can be used in other directory configurations by including the PortableFirefo x.ini file in the same directory as PortableFirefox.exe and configuring it as de tails in the INI file section below. The INI file may also be placed in a subdi rectory of the directory containing PortableFirefox.exe called PortableFirefox o r 2 directories deep in PortableApps\PortableFirefox or Data\PortableFirefox. A ll paths in the INI should remain relative to the EXE and not the INI. PORTABLEFIREFOX.INI CONFIGURATION ================================= The Portable Firefox Launcher will look for an ini file called PortableFirefox.i ni within its directory. If you are happy with the default options, it is not n ecessary, though. The INI file is formatted as follows: [PortableFirefox] FirefoxDirectory=firefox ProfileDrectory=profile PluginsDirectory=plugins UserProfileDirectory= AdditionalParameters= AllowMultipleInstances=false

SkipChromeFix=false SkipCompregFix=false WaitForFirefox=false FirefoxExecutable=firefox.exe DisableSplashScreen=false The FirefoxDirectory, ProfileDrectory, PluginsDirectory, AppDataDirectory and Us erProfileDirectory entries should be set to the *relative* path to the directori es containing firefox.exe, your profile, your plugins, etc. from the current dir ectory. All must be a subdirectory (or multiple subdirectories) of the director y containing PortableFirefox.exe. The default entries for these are described i n the installation section above. The AppDataDirectory and UserProfileDirectory are used instead of the local User and Application Data directories contained i n Documents and Settings. A blank entry for PluginsDirectory, AppDataDirectory or UserProfileDirectory will disable that feature. The AdditionalParameters entry allows you to pass additional commandline paramet er entries to firefox.exe. Whatever you enter here will be appended to the call to firefox.exe. The AllowMultipleInstances entry will allow Portable Firefox to run alongside yo ur regular local copy of Firefox if you set it to true (lowercase). The default is false. The SkipChromeFix entry allows you to set Portable Firefox not to adjust the chr ome.rdf for extension compatibility on launch. It is useful if you are only usi ng Portable Firefox on computers you control and are able to have the drive lett er set the same each time as Portable Firefox 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 Firefox not to adjust the co mponent registry (compreg.dat) for certain extension compatibility on launch. I t is useful if you are only using Portable Firefox 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 Forecast Fox or the M ozilla Calendar) as Portable Firefox will launch more quickly. Set it to true ( lowercase) to skip chrome.rdf processing. The default is false. The WaitForFirefox entry allows you to set the Portable Firefox Launcher to wait for Firefox to close before it closes. This option is mainly of use when Porta bleFirefox.exe is called by another program that awaits it's conclusion to perfo rm a task. It is useful when used with the PortableFirefoxLive launcher. The FirefoxExecutable entry allows you to set the Portable Firefox Launcher to u se an alternate EXE call to launch firefox. This is helpful if you are using a machine that is set to deny firefox.exe from running. You'll need to rename the firefox.exe file and then enter the name you gave it on the firefoxexecutable= line of the INI. The DisableSplashScreen entry allows you to run the Portable Firefox Launcher wi thout the splash screen showing up. The default is false. 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 t hread about running Firefox from a USB key. tracon later released a launcher ca lled 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 sug

gestions back and forth as well as improvements from mai9, myself and others lea d to the launcher we have today. This most recent version adds some of mai9's m ethods for running multiple copies of Firefox and my methods for allowing the co de 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 profi les from local installations. CURRENT LIMITATIONS =================== SOME THEMES FAIL - Some themes may not work correctly with Portable Firefox LOCAL FILES CREATED - A directory (%userprofile%\Application Data\Mozilla\Firefo x) is created on the local machine (if Firefox is not installed locally) and a p luginreg.dat file is created within it. This is a limitation of Firefox itself. If you set the UserProfile directory within the INI file, this will not happen. INCOMPATIBLE EXTENSIONS - Certain extensions use additional local files or prefs .js to store information, neither of which are handled by the Portable Firefox l auncher when moving between machines. NO PORTABLE JAVA - Sun's Java VM needs to be installed locally as it makes a sle w of registry entries, etc. There is no way to make it portable at present, so y ou will only be able to use Java-enabled sites on machines that have the Sun Jav a VM installed locally. WRITE ACCESS REQUIRED - Both the Firefox directory and the profile directory mus t be writeable on the USB drive. Drives with a writable switch can not be in rea d-only mode.