These settings will help you portablize an application's file system special folder usage and optimize an already portablized application's file system special folder usage.
By default, all of the file system special folder accesses made by an application are not redirected into a portable file system. The following sections allow you to modify that behavior.
There are several substitution tokens that may be used within any of the settings requiring a file system path.
Launched application related tokens are %appdrive%, e.g. H:, %appdir%, e.g. H:\Portables\Firefox, and %appname%, e.g. Firefox.
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 configuration ini will be used.
The [Filesystem] section
Setting | Description |
---|---|
Use |
Set to 1 to specify file system special folder redirection. By default, this turns on file system special folder redirection for the entire set of special folders. Use the FilesystemExclude and FilesystemInclude sections to modify this behavior. Set to 0 to specify no file system special folder redirection. Defaults to the application's JauntePE launcher's RedirWFS setting. |
Data |
Some full path, or current configuration ini relative path, which specifies where the portablized data reside. Defaults to the application's JauntePE launcher's JPERuntimeWFS setting. |
Ini |
Some full path, or current configuration ini relative path, which specifies where to go to get the rest of the file system-related runtime settings. This is useful if you need to point an application "back" to the ini used during the application install. It may also be used as a way to group applications together under a application-group-specific ini. If used, this is the only setting interpreted within a given configuration ini. If not used, all file system portablization settings are taken from the current configuration ini. |
The [Redirection] section
Setting | Description |
---|---|
ExcludeAppDir |
Set to 1 to specify that the JauntePE runtime is to auto-add a FilesystemExclude entry for the application's executable's directory, which allows the application to be run correctly from any file system special folder, such as the user desktop. Set to 0 to specify that the JauntePE runtime treats the application directory like any other potentially-redirected directory, even if it is a special folder directory. Defaults to 0 (there is no equivalent launch setting.) |
WFSMerge |
Set to 1 to specify that the JauntePE runtime should process application file system browsing requests against both the portable file system as well as the system file system, merging the results together so that it appears to the application as if there is only one file sytem in use. Set to 0 to specify that the JauntePE runtime should process application file system browsing requests against the portable file system first, and if no matching directory or file is found, then against the system file system. Defaults to 0 (there is no equivalent launch setting.) |
The [FilesystemExclude] section
In this section you specify the file system special folders that you don't want to be portablized. There are two ways to do this. The first is to enter an ascending, consecutively numbered list of special folder numbers for the associated file system special folders that you don't want to be portablized. The second is to enter 1=* as the only entry, which tells JauntePE to exclude all file system special folders from being portablized. You then optionally enter a list of special folder numbers for the associated file system special folders that you do want to be portablized via the FilesystemInclude section.
Here is an example that excludes all "Windows install directory" special folders from redirection:
[FilesystemExclude]
1=20
2=36
3=37
4=41
5=56
In addition to using special folder numbers by themselves, you may also use special folder number tokens, optionally followed by a subdirectory path. The tokens are entered as a %#% string, with # being one of the special folder numbers. You can use the %appdir% and %appname% replacement tokens anywhere within any subdirectory path for this type of entry.
Here is an example that excludes the DirectX subdirectory of the "Windows system" special folder from redirection. The second entry also excludes the application's subdirectory of the "user profile" special folder from redirection:
[FilesystemExclude]
1=%37%\DirectX
2=%40%\%appname%
The [FilesystemInclude] section
In this section you specify the file system special folders that you want to be portablized. You do this by entering an ascending, consecutively numbered list of special folder numbers for the associated file system special folders. Since all of the file system special folders are portablized by default, you only make use of this section when you have 1=* as the only entry in the FilesystemExclude section.
Here is an example that includes all "Windows install directory" special folders for redirection:
[FilesystemExclude]
1=*
[FilesystemInclude]
1=20
2=36
3=37
4=41
5=56
In addition to using special folder numbers by themselves, you may also use special folder number tokens, optionally followed by a subdirectory path. The tokens are entered as a %#% string, with # being one of the special folder numbers. You can use the %appdir% and %appname% replacement tokens anywhere within any subdirectory path for this type of entry.
Here is an example that includes the DirectX subdirectory of the "Windows system" special folder for redirection. The second entry also includes the application's subdirectory of the "user profile" special folder for redirection:
[FilesystemExclude]
1=*
[FilesystemInclude]
1=%37%\DirectX
2=%40%\%appname%
The [FilesystemIgnore] section
In this section you specify the file system special folders that you want to hide from the application as existing in the file system. You do this by entering an ascending, consecutively numbered list of special folder numbers for the associated file system special folders.
This list of file system special folders is used by JauntePE only after it has been determined that a given file system special folder is to be portablized and that the file system special folder does not exist in the portable file system. Then, if the given path is a "FilesystemIgnore" path, the application is told that the path does not exist. In practice, putting file system special folder paths into this section prevents an application from using the contents of any like file system special folders.
In addition to using special folder numbers by themselves, you may also use special folder number tokens, optionally followed by a subdirectory path. The tokens are entered as a %#% string, with # being one of the special folder numbers. You can use the %appdir% and %appname% replacement tokens anywhere within any subdirectory path for this type of entry.
Finally, you may use a special \*.* path-ending qualifier on any entry using a special folder number token, as an indicator to JauntePE to "ignore" the contents of the path's directory but to treat the directory itself as if it exists.
Here is an example of what JPE Quickie uses when the "This is for an application already normally installed or run" checkbox is selected.
[FilesystemIgnore] | ||
1=%22%\*.* | this is the "All User's" start menu folder | |
2=%25%\*.* | this is the "All User's" desktop folder | |
3=%31%\*.* | this is the "All User's" favorites folder | |
4=%35%\*.* | this is the "All User's" app data folder | |
5=%38%\*.* | this is the "Program Files" folder | |
6=%40%\*.* | this is the "User Profile" folder | |
7=%45%\*.* | this is the "All User's" templates folder | |
8=%46%\*.* | this is the "All User's" documents folder |
The [SpecialFolders] section
In this section you specify the subdirectory paths you want to use as overrides for any of the portable file system special folder default relative paths. You do this by equating the special folder number with the overriding subdirectory path.
Following is an example that overrides the default relative path for all of the "desktop" special folders:
[SpecialFolders]
0=Desktop1
16=Desktop2
25=Desktop3
Here's a list of all of the currently used folder numbers (as of Vista) and their associated JauntePE default relative paths and summary descriptions. The JauntePE default relative path is what would be used if you don't override the special folder with your own relative path within the [SpecialFolders] section.
The "Summary Description"s given below have all been summarized from this MSDN Library web page.
Special Folder Number | JauntePE Default Relative Path | Summary Description |
---|---|---|
0 | User\Desktop | This is your desktop's virtual folder. There is no equivalent file system directory that I am aware of. |
1 | Internet | This is your Internet Explorer's virtual folder. There is no equivalent file system directory that I am aware of. |
2 | User\StartMenu\Programs | This is your Start Menu's Programs menu's file system directory. "C:\Documents and Settings\%username%\Start Menu\Programs" is an example path. |
3 | Computer\Controls | This is your "Control Panel" virtual folder. There is no equivalent file system directory that I am aware of. |
4 | Computer\Printers | This is your "Printers" virtual folder. There is no equivalent file system directory that I am aware of. |
5 | User\Documents | This is your "My Documents" file system directory. "C:\Documents and Settings\%username%\My Documents" is an example path. |
6 | User\Favorites | This is your "Favorites" file system directory. "C:\Documents and Settings\%username%\Favorites" is an example path. |
7 | User\StartMenu\Programs\Startup | This is your Start Menu's, Program's, Startup file system directory. "C:\Documents and Settings\%username%\Start Menu\Programs\Startup" is an example path. |
8 | User\Recent | This is your "Most Recently Used Documents" file system directory. "C:\Documents and Settings\%username%\Recent" is an example path. |
9 | User\SendTo | This is your "Send To" file system directory. "C:\Documents and Settings\%username%\SendTo" is an example path. |
10 | Desktop\RecycleBin | This is your "Recycle Bin" virtual folder. There is no equivalent file system directory that I am aware of. |
11 | User\StartMenu | This is your Start Menu file system directory. "C:\Documents and Settings\%username%\Start Menu" is an example path. |
12 | User\Documents | This is your "My Documents" virtual folder. There is no equivalent file system directory that I am aware of. |
13 | User\Documents\Music | This is your "My Music" file system directory. "C:\Documents and Settings\%username%\My Documents\My Music" is an example path. |
14 | User\Documents\Video | This is your "My Videos" file system directory. "C:\Documents and Settings\%username%\My Documents\My Videos" is an example path. |
15 | Unknown | ? |
16 | User\Desktop | This is your desktop's file system directory. "C:\Documents and Settings\%username%\Desktop" is an example path. |
17 | Drives | This is your "My Computer" virtual folder. There is no equivalent file system directory that I am aware of. |
18 | Network | This is your "Network Neighborhood" virtual folder. There is no equivalent file system directory that I am aware of. |
19 | User\NetHood | This is your "NetHood" file system directory. "C:\Documents and Settings\%username%\NetHood" is an example path. |
20 | Windows\Fonts | This is your system fonts virtual folder as well as its file system directory. "C:\Windows\Fonts" and "C:\WINNT\Fonts" are example paths. |
21 | User\Templates | This is your document templates file system directory. "C:\Documents and Settings\%username%\Templates" is an example path. |
22 | Common\StartMenu | This is your machine's Start Menu file system directory. "C:\Documents and Settings\All Users\Start Menu" is an example path. |
23 | Common\StartMenu\Programs | This is your machine's Start Menu's Programs menu's file system directory. "C:\Documents and Settings\All Users\Start Menu\Programs" is an example path. |
24 | Common\StartMenu\Programs\Startup | This is your machine's Start Menu's Program's Startup file system directory. "C:\Documents and Settings\All Users\Start Menu\Programs\Startup" is an example path. |
25 | Common\Desktop | This is your machine's desktop's file system directory. "C:\Documents and Settings\All Users\Desktop" is an example path. |
26 | User\AppData | This is your application-specific data file system directory. "C:\Documents and Settings\%username%\Application Data" is an example path. |
27 | User\PrintHood | This is your "PrintHood" file system directory. "C:\Documents and Settings\%username%\PrintHood" is an example path. |
28 | User\Local\AppData | This is your application-specific, non-roaming, data file system directory. "C:\Documents and Settings\%username%\Local Settings\Application Data" is an example path. |
29 | Alt\Startup | This is your Start Menu's Program's Startup's, non-localized, file system directory. I'm not sure what an example path for this would be. |
30 | Common\Alt\Startup | This is your machine's Start Menu's Program's Startup's, non-localized, file system directory. I'm not sure what an example path for this would be. |
31 | Common\Favorites | This is your machine's "Favorites" file system directory. "C:\Documents and Settings\%username%\Favorites" is an example path. |
32 | User\Local\INetCache | This is your Internet Explorer's (wininet) cache file system directory. "C:\Documents and Settings\%username%\Local Settings\Temporary Internet Files" is an example path. |
33 | User\Cookies | This is your Internet Explorer's (wininet) cookies file system directory. "C:\Documents and Settings\%username%\Cookies" is an example path. |
34 | User\Local\History | This is your Internet Explorer's (wininet) browsing history file system directory. "C:\Documents and Settings\%username%\Local Settings\History" is an example path. |
35 | Common\AppData | This is your machine's application-specific data file system directory. "C:\Documents and Settings\All Users\Application Data" is an example path. |
36 | Windows | This is your machine's Windows install file system directory. "C:\Windows" and "C:\WINNT" are example paths. |
37 | Windows\System | This is your machine's Windows system folder. "C:\Windows\system32" and "C:\WINNT\system32" are example paths. |
38 | ProgramFiles | This is your machine's default application install file system directory. "C:\Program Files" is an example path. |
39 | User\Documents\Pictures | "C:\Documents and Settings\%username%\My Documents\My Pictures" is an example path. |
40 | User | This is your profile file system directory. "C:\Documents and Settings\%username%" is an example path. |
41 | Windows\System | x86 system directory on RISC. |
42 | ProgramFiles | x86 "C:\Program Files" on RISC. |
43 | ProgramFiles\Common | ? |
44 | ProgramFiles\Common | x86 "C:\Program Files\Common" on RISC. |
45 | Common\Templates | This is your machine's document templates file system directory. "C:\Documents and Settings\All Users\Templates" is an example path. |
46 | Common\Documents | This is your machine's "My Documents" file system directory. "C:\Documents and Settings\All Users\Documents" is an example path. |
47 | Common\StartMenu\Programs\AdminTools | ? |
48 | User\StartMenu\Programs\AdminTools | ? |
49 | Connections | ? |
50 | Unknown | ? |
51 | Unknown | ? |
52 | Unknown | ? |
53 | Common\Documents\Music | This is your machine's "My Music" file system directory. "C:\Documents and Settings\All Users\Documents\My Music" is an example path. |
54 | Common\Documents\Pictures | This is your machine's "My Pictures" file system directory. "C:\Documents and Settings\All Users\Documents\My Pictures" is an example path. |
55 | Common\Documents\Video | This is your machine's "My Videos" file system directory. "C:\Documents and Settings\All Users\Documents\My Videos" is an example path. |
56 | Windows\Resources | ? |
57 | User\Local\Resources | ? |
58 | Common\OEM | ? |
59 | User\Local\AppData\CDBurnArea | ? |
60 | Unknown | ? |
61 | ComputersNearMe | ? |
62 | . | ? |