// troubleshooting guide · docfetcher

DocFetcher Won't Start or Open

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 19, 2026
reports:
2
Method
how we research
Share

RUNBOOK · docfetcher/wont-start4 FIXES

// quick answer

If DocFetcher does nothing when launched, disable the startup manual and HTML preview in settings-conf.txt, then try the script launcher to see the error. Old versions also fail without a matching 64-bit Java.

Most likely fix: Turn off the startup manual and HTML preview

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Turn off the startup manual and HTML preview

    1. 01Close DocFetcher
    2. 02Open settings-conf.txt in the conf folder: C:\Users\<you>\AppData\Roaming\DocFetcher\conf (Windows), ~/.docfetcher/conf (Linux/macOS) or <app folder>\conf (portable)
    3. 03Add the lines ShowManualOnStartup = false and PreferHtmlPreview = false
    4. 04Optionally add HotkeyEnabled = false, then start DocFetcher
    Did this fix it?
  2. FIX 2Launch from the script to see the error

    1. 01Windows: move misc\DocFetcher.bat into the DocFetcher folder and run it from a command prompt
    2. 02Linux: chmod +x DocFetcher.sh and run ./DocFetcher.sh in a terminal
    3. 03macOS: cd into DocFetcher.app/Contents/MacOS in Terminal and run the executable there
    Did this fix it?
  3. FIX 3Update to 1.1.26 or newer

    1. 01Install the latest release, which bundles its own Java runtime
    2. 02Note it is 64-bit only: Windows 7 SP1+, macOS 11+, Linux with GTK 3
    Did this fix it?
  4. FIX 4Update graphics drivers

    1. 01If startup fails right after a GPU driver update, install a newer or older driver version
    Did this fix it?

SANDBOX · docfetcher RUNS IN YOUR BROWSER

Try it: a launcher with snippets and clipboard history

A hands-on DocFetcher-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Double-clicking DocFetcher shows nothing, the window flashes and closes, or it hangs on startup.

Why it happens

  • C-01Embedded HTML preview or startup manual failing to load
  • C-02Global hotkey conflict
  • C-03Graphics driver problems (some NVIDIA 378.xx drivers were reported)
  • C-04Old version without a bundled Java, or 32-bit Java on 64-bit Windows

// this guide also covers

  • docfetcher won't start
  • docfetcher not opening
  • docfetcher doesn't start
  • docfetcher not launching windows 11

Still not working?

If DocFetcher keeps failing, you're not alone. See every DocFetcher problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch DocFetcher Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other DocFetcher errors

All 10 DocFetcher errors and fixes →