The settings that you use to tell the launcher what to do all reside within the [Launch] ini section, and are as follows. All are optional.
There are several substitution tokens that may be used within any of the settings requiring a path.
Launched application related tokens are %appdrive%, e.g. H:, %appdir%, e.g. H:\Portables\Firefox, and %appname%, e.g. Firefox. These are of use primarily as a way to create a generic configuration file, such as using %appname%.exe within the Path setting as a way to tie the to-be-launched application's filename to the name of the configuration file, rather than "hard coding" it to the actual name of the application.
Launcher related tokens are %launchdrive%, %launchdir%, and %launchname%. These are of use when the launched application is on a drive that is different from the launcher and the other JauntePE related files used to portably run the application, such as the application's portable registry. For example, if Path is set to %System%\%appname%.exe, but the launcher and JauntePE runtime are located on a portable drive, then %launchdrive% may be used within the JPERuntime setting to portably locate the JauntePE runtime to use without having to resort to use of a relative path.
File system related tokens are %ProgramFiles%, e.g. C:\Program·Files, %System%, e.g. C:\WINNT\system32, and %Windows%, e.g. C:\Windows. These are of use primarily as a way to portably locate "system" applications, such as MS Notepad or MS Office.
And environment variable names enclosed within percent signs may be used as well, such as %ComputerName% or %UserName%. You are responsible for ensuring that the environment variable is available on all versions of Windows on which the launch ini will be used.
There is also a special %jauntePE% substitution token that becomes valid if the JauntePE application itself is 1) running, and 2) the JauntePE.ini is found in the Toolbox subdirectory, and 3) the [GeneralSettings] JPEDLLPath value is set. It's primary purpose is for use within the JPERuntime setting as a portable way to point to the jauntePE runtime dll to be used. The value of the token is the full path as given by the JPEDLLPath relative to the JauntePE.ini's directory, e.g., E:\JauntePE\Runtime\jauntePE\def.
If you specify any relative paths they are taken to be relative to the directory containing the launch ini. Full paths are allowed as well.
Setting | Description |
---|---|
AppReg |
Set to 0 for no application-specific registry redirection. In other words, when RedirReg is set to 1, an AppReg of 0 causes the default portable registry file to be named JauntePE_jauntePE.reg and to be located in the JPERuntime directory. Set to 1 for application-specific registry redirection. In other words, when RedirReg is set to 1, an AppReg of 1 causes the default portable registry file to be named %appname%_jauntePE.reg and to be located in the %appdir% directory. |
AppWFS |
Set to 0 for no application-specific special directory file system redirection. In other words, when RedirWFS is set to 1, an AppWFS of 0 causes the default portable file system to be located in the JPERuntime directory. Set to 1 for application-specific special directory file system redirection. In other words, when RedirWFS is set to 1, and AppWFS of 1 causes the default portable file system to be located in the %appdir% directory. |
ExeDir |
Set to 0 to leave the starting directory alone. Set to 1 to have the starting directory set to the %appdir% directory. |
InjectOnly |
Set to 0 to launch the path executable and then inject it with the JPERuntime file. Set to 1 to only have currently running processes with the name of %appname% injected with the JPERuntime file. A subsequent re-running of the same launcher will "uninject" the JPERuntime from the same processes (of those that are still running.) |
JPERuntime |
Set to the path to the jauntePE.dll file to inject, filename and extension included. The filename must be jauntePE and the extension must be .dll. |
JPERuntimeIni |
Set to the path to the jauntePE runtime ini settings file. |
JPERuntimeReg |
Set to the path to the jauntePE runtime portable registry file. This file does not need to exist. It will be automatically created. |
JPERuntimeWFS |
Set to the path to the jauntePE runtime portable file system directory. This directory does not need to exist. It will be automatically created. |
Logging |
Set to 0 to specify no log output. Set to 1 to specify the output of basic runtime setting information to the "LogPath" file. Useful when attempting to determine if the JauntePE runtime used the settings from the configuration ini file you expected it to use. Set to 2 to specify the output of basic runtime setting information, and hooked api calls "debug trace" information, to the "LogPath" file. Useful when attempting to determine the cause of an application crash or other problem you think might be associated with running via JauntePE. The "LogPath" is defaulted to the application's executable's directory with a filename of "%appname%_jauntePE.log." |
MemIni |
Set to 0 to turn off in-memory launch/runtime combo configuration usage. Set to 1 to turn on in-memory launch/runtime combo configuration usage. In this case, the launcher loads its launch ini into shared memory that is then used by the jauntePE runtime dll from within the just-launched process. So the launch ini should contain the needed runtime configuration settings as well as launch settings. Using this option prevents the overriding of any of the runtime configuration settings, even if an overriding runtime ini exists and would otherwise have been used if MemIni had been set to 0. |
MemRegistry |
Set to 0 to turn off in-memory portable registry usage. Set to 1 to turn on in-memory portable registry usage for use with an immediate write, text-based .reg file (equal to the -m command line switch). Set to 2 to turn on in-memory portable registry usage for use with an application-end write, text-based .reg file (equal to the -M and -Mt command line switches). Set to 3 to to turn on in-memory portable registry usage for use with an application-end write, binary-based .reg file (equal to the -Mb command line switch). Set to 4 to turn on in-memory portable registry usage for use with a no-write text-based .reg file (equal to the -Mn command line switch). Set to 5 to turn on in-memory portable registry usage for use with a no-write binary-based .reg file (equal to the -Mn command line switch). |
NoPlugins |
Set to 0 to have the path executable injected with the JPERuntime file. Set to 1 to just have the path executable launched, without injecting it with the JPERuntime file. |
Params |
Set to the string of parameters that you want to get passed along to the launched executable. These override any parameters which may have been specified on the launcher's command line. |
Path |
Set to the path to the executable to be launched and/or injected, including filename and extension. The path's drive becomes the %appdrive% token, its directory becomes the %appdir% token, and its filename becomes the %appname% token. |
PipeOnly |
Set to 0 to allow for any of the launch settings to be overridden by their counterpart runtime setting. Set to 1 to not allow any of the launch settings to be overridden by their counterpart runtime setting. This will also cause the executable to load faster since the runtime will not look for any overriding runtime ini to read the overriding settings from. But it requires that you have all of the launch settings set properly. |
Prompt |
Not currently used. |
RedirReg |
Set to 0 for no registry redirection. Set to 1 for registry redirection. |
RedirWFS |
Set to 0 for no special directory file system redirection. Set to 1 for special directory file system redirection. |
RunPriority |
Set to 0 for a normal run priority. Set to 1 for an idle run priority. Set to 2 for a high run priority. Set to 3 for a realtime run priority. |
RunScr |
Set to 0 to have a launched screensaver initiate a properties dialog. Set to 1 to run a launched screensaver. |
Runtime |
Set to a string of semi-colon delimited paths that gets prefixed to the PATH environment variable. |
RunType |
Set to 0 for a normal main window. Set to 1 for a hidden main window. Set to 2 for a minimized main window. Set to 3 for a maximized main window. |
StartIn |
Not currently used. |