FAQ

I’ve bought an older DocFetcher Pro version, where can I download the latest release?

To get the latest release files, log in to the gumroad.com account with which you purchased DocFetcher Pro. In your account, all products you purchased are listed under “Library”, and that’s where you can also access new DocFetcher Pro release files.

If you can’t find your Library anywhere in your Gumroad account: A Gumroad account can be either in a “seller” or a “buyer” mode. Your Library is only visible in the “buyer” mode, and you can switch to it via a link “Switch to buying” somewhere in your account.

When upgrading portable DocFetcher Pro, how can I keep my settings and indexes?

When upgrading from one version of portable DocFetcher Pro to a newer version, do not unpack the latter on top of the former. This will get program files mixed up, potentially causing abnormal program behavior. Here’s the correct way to upgrade the program and also keep your settings and indexes:

  1. Unpack the new program version to a fresh location.
  2. Copy only the folders conf and indexes from the old program folder to the new program folder.

Note: If you’re using non-portable DocFetcher Pro, then on Windows (and only on Windows) you can safely install the new program version in the same folder as the existing version (e.g., C:\Program Files\DocFetcher Pro). This is safe because the installer will automatically remove the existing version before installing the new one. The installer will also retain any existing settings and indexes. On platforms other than Windows, non-portable DocFetcher Pro must be unpacked to a fresh location, and it will reuse any existing settings and indexes in your home folder.

How can I transfer my settings and indexes from the demo to the full version?

How the settings and indexes from the demo can be transferred to the full version depends on the DocFetcher Pro version you’re using:

  • Windows, non-portable (installed): Open the folder C:\Users\[Your Username]\AppData\Local. In that folder, you’ll find a folder named DocFetcher Pro Demo. Make a copy of it in the same location by selecting it and pressing Ctrl+C and then Ctrl+V. Rename the copy to DocFetcher Pro. If there was already a folder named DocFetcher Pro, then rename the latter to something else or remove it before renaming the copied folder.
  • Linux and macOS, non-portable: In your home folder, rename the folder .docfetcherprodemo to .docfetcherpro. Rename or remove an existing .docfetcherpro folder beforehand if there is one.
  • Any platform, portable: Copy only the folders conf and indexes from the demo program folder to the full version program folder.

Note that the above instructions assume that you wish to transfer settings and indexes from a non-portable demo to a non-portable full version, or from a portable demo to a portable full version. Transferring between non-portable and portable is also possible and essentially just comes down to locating the conf and indexes folders and copying them to the right place.

After indexing, the GUI remains sluggish and unresponsive, what can I do?

There are two likely reasons: First, the “Use type-ahead search” option in the preferences can have a significant impact on performance. If it’s enabled, try disabling it.

Second, it’s possible that you have indexed one or more very large folders, and that these folders are being frequently modified in the background, triggering continuous index updating in DocFetcher Pro and thus slowing the latter down. In that case, try turning off automatic index updating on all indexes. To do so for a single index, right-click on it in the Search Scope pane and untoggle “Auto-Update Index”. Alternatively, you can disable automatic index updating on all indexes at once by launching the program with a --disable-auto-index-update argument.

The page “Index Updates” in the user manual explains how DocFetcher Pro’s automatic index updating works, and what the alternatives are when automatic index updating is not available.

Can you bring back the global hotkey from DocFetcher?

No, but there’s a workaround. For some context: On Windows and Linux, the free DocFetcher has a global hotkey (by default Ctrl + F8) to bring the program window to the front. This feature was not carried over to DocFetcher Pro as the hotkey is known to cause stability issues. However, it is possible to emulate the hotkey with additional software, as explained below. How to emulate the hotkey on macOS will not be explained, but it can be done with Automator and AppleScript.

On Windows

  1. Download the open-source software AutoHotkey from here and install it. Afterwards, restart Windows.
  2. Press Windows key + R, type shell:startup, then press Enter. This opens your startup applications folder.
  3. Right-click in that folder and select New > AutoHotkey Script. Give the new .ahk file a name, e.g., DocFetcher Pro Hotkey.ahk. The .ahk file is a script that will be run every time Windows starts up.
  4. Right-click the .ahk file, then select Edit Script.
  5. Replace all text in the .ahk file with this:
^F8::
if WinActive("DocFetcher Pro") {
    WinMinimize, DocFetcher Pro
} else {
    WinActivate, DocFetcher Pro
}
  1. Save and close the .ahk file.
  2. Restart Windows.
  3. From now on, you can press Ctrl + F8 to bring a running DocFetcher Pro instance to the front. After pressing Ctrl + F8, you can further press Ctrl + F to focus the search field in DocFetcher Pro. If you press Ctrl + F8 while DocFetcher Pro is already the active window, it will be minimized instead.
  4. The ^F8:: line in the .ahk script above is what binds the script to the Ctrl + F8 hotkey. For other hotkeys, see this page in the AutoHotkey documentation.
  5. To learn more about AutoHotkey, see the AutoHotkey documentation, and the tutorial in particular.

On Linux

  1. Install AutoKey. On Debian-based distros such as Ubuntu, run this command in the terminal: sudo apt install autokey-gtk
  2. If not already installed, install the following dependencies: wmctrl and xdotool.
  3. Start AutoKey.
  4. In AutoKey, create a new script: File > New > Script
  5. Paste the following code into the code editor:
output = system.exec_command("wmctrl -lx", getOutput=True)
if "DocFetcher Pro.DocFetcher Pro" in output:
    winClass = window.get_active_class()
    if winClass == "DocFetcher Pro.DocFetcher Pro":
        system.exec_command("xdotool windowminimize $(xdotool getactivewindow)")
    else:
        system.exec_command("wmctrl -x -a \"DocFetcher Pro.DocFetcher Pro\"")
  1. Beneath the code editor, assign a hotkey, e.g., Ctrl + F8.
  2. Add AutoKey to your startup applications. You can do this from within AutoKey: Edit > Preferences > Automatically start AutoKey at login
  3. Save the script and close the AutoKey window. It’ll keep running in the background.
  4. From now on, you can press Ctrl + F8 to bring a running DocFetcher Pro instance to the front. After pressing Ctrl + F8, you can further press Ctrl + F to focus the search field in DocFetcher Pro. If you press Ctrl + F8 while DocFetcher Pro is already the active window, it will be minimized instead.