Home Portal

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • All settings of Windows and Firefox described below need to be configured on each computer on which you want this feature to be enabled.
  • All settings of XTRF described below need to be configured for each XTRF user who would like this feature.

Settings to be Pre-Configured in Windows

Your server's XTRF Home Directory, which is the location where XTRF stores your files, needs to be mapped via your local network to a local virtual drive. The path of the XTRF Home Directory on your server can be found in Advanced Configuration, referred to as the System Home Directory.


For the purpose of this article, let us assume that the XTRF Home Directory is E:\XTRF_data and that you mapped it to drive X:. As a result, the content of the E:\XTRF_data folder on your server is displayed whenever you open drive X: on your computer. Now you can map XTRF paths so that it always uses X:  wherever  E:\XTRF_data is used.

Settings to be Configured in XTRF

  1. Go to System > Preferences > Directories Mapping. These settings allow all system paths to be transformed from server-based into locally recognized ones.
  2. A table with two columns, Server Side Directory and Local Directory, displays all the current mappings.
  3. Click Edit.

    • The Server Side Directory should be the same as what you entered for System Home Directory in Advanced Configuration.
    • For Local Directory, enter the local path to the mapped directory from the server.
  4. Make any necessary modifications.
    • To add new mappings, enter them into the appropriate field and then click Add Folder Mapping. For example, set E:\XTRF_data as the Server Side Directory and X: as the Local Directory.


      Please note that both Server Side Directory and Local Directory should end with a slash (for Linux paths) or backslash (for Windows paths).

    • To remove any unnecessary mappings, click Delete Icon next to the desired item.
  5. Click Save.

Settings to be Configured in Firefox

  1. Open about:config
  2. Right-click on the list.
  3. Select New / Boolean
  4. Enter the following string name: network.protocol-handler.expose.file
  5. Set the value to false.
  6. Close all Firefox windows.
  7. Open the prefs.js file. The location of the file is:
    • for Windows Vista and 7: C:\Users\[YOUR_USER_NAME]\AppData\Roaming\Mozilla\Firefox\Profiles\[YOUR_PROFILE_NUMBER].default\
  8. Add the following lines and save the file:

    Code Block
    user_pref("capability.policy.policynames", "localfilelinks");
    user_pref("capability.policy.localfilelinks.sites", "YOUR_XTRF_ADDRESS");
    user_pref("capability.policy.localfilelinks.checkloaduri.enabled", "allAccess");

    Replace YOUR_XTRF_ADDRESS with the proper URL address, e.g. http://xtrf.yourcompany.com/

Settings to be Configured in Windows

  1. Download the files xtrfdir.batxtrfdir_explorer.reg and xtrfdir_totalcmd.reg and place them in C:\xtrfdir


    If you place the files in a different folder, you must edit the REG files and change the path leading to the BAT file. Remember to use double backslash in your path (like in the default path).

  2. Check if xtrfdir.bat contains correct paths to the applications:

    1. EXPLORER_PATH should point to Windows Explorer executable (explorer.exe)

    2. TOTALCMD_PATH should point to Total Commander executable (TOTALCMD.EXE)


      Setting the path to Total Commander is optional. Use it only if you have Total Commander installed on your system and you want to use it to handle XTRFDIR links.

  3. Run xtrfdir.bat

  4. If you want the links to be opened in Windows Explorer, run xtrfdir_explorer.reg. If you want the links to be opened in Total Commander, run xtrfdir_totalcmd.reg. You will then be asked to confirm the modifications to the Windows Registry.

  5. When you first open an xtrfdir:// link in your browser, you will be prompted to confirm the use of the new protocol. Click "Accept".
  6. To change application used by the XTRFDIR protocol afterwards, run a different REG file.