Common Issues
Quick reference for the problems users most often report. Hotkey conflicts have their own page (see 12.2); crash reporting is covered in 12.3.
| Symptom | Likely cause | Fix |
|---|---|---|
| App won't launch | x64-only binary; .NET 8 runtime is bundled but the executable may be missing or blocked | Confirm Tex.Wpf.exe exists at the installed path; reinstall if missing. The app will not run on 32-bit Windows |
| Hotkeys don't fire | Another app owns the combination, or the OS is blocking it | See 12.2 |
| OCR first-use is slow | Lazy Tesseract init takes 2-5 seconds on the first call per session | Expected; subsequent OCR requests are fast. Leave the app running between captures |
| Capture is blank or black | DRM'd video, some games, and other protected content are intentionally blocked by Windows | Not a Tex bug. Use the target app's built-in share/record feature instead |
| Tray icon disappeared | Windows Explorer restarted (or crashed) and dropped the icon handle | Exit Tex from Task Manager and relaunch |
| Hotkey / theme / notification change ignored | These apply immediately and should not need a restart | If an immediate change is not visible, re-open the Settings window to force a re-bind |
| Other settings change ignored | Some settings are read once at startup (e.g. UI.StartMinimized, UI.StartWithWindows, installed OCR language packs) | Restart Tex for these to take effect |
| Recording fails to start | Hardware encoder (NVENC / QuickSync / AMF) is unavailable or busy | In Settings > Recording, set Recording.UseHardwareEncoding to false to fall back to software encoding |
Related pages
- 12.2 — Hotkey conflicts
- 12.3 — Crash reports and logs
- 10 — Settings and Preferences (for the full settings schema)