Documentation

FAQ & Troubleshooting

Explains common issues when using FJ Flow and advanced technical details regarding caret coordinate retrieval...

Explains common issues when using FJ Flow and advanced technical details regarding caret coordinate retrieval.

Indicator does not correctly follow the caret (input cursor)

FJ Flow supports many modern applications, including general text editors, Chromium-based browsers (Microsoft Edge, Google Chrome), and VS Code (Electron app). However, some special editors or environments require additional configurations or workarounds.

1. No tracking in Firefox + Google Docs (Google Documents)

  • Current Limitation: In Google Docs running on Firefox, due to structural limitations of the browser and the web application, caret (input cursor) position information cannot be retrieved by any means, and auto-tracking will not work. Currently, this complete inability to retrieve positions has only been confirmed in the combination of Firefox + Google Docs.
  • Other Editors & Browsers: Even on Firefox, tracking works without issues in other online editors (such as Microsoft Word Online) and standard text input fields. Additionally, Google Docs tracks normally when opened in Chromium-based browsers like Google Chrome or Microsoft Edge.
  • Workaround: When using Firefox + Google Docs, please use the “final fallback using click position” feature described below (which temporarily uses the coordinates of a left-clicked input area), or open Google Docs in a Chromium-based browser.

2. Special apps or games utilizing custom text rendering

  • Fallback Feature: As a last resort when caret positions cannot be retrieved using any Windows API, UIA, or IA2, a self-healing logic is implemented to temporarily substitute the coordinates where the user last left-clicked for 10 seconds (valid only if there are no key inputs like arrow keys after clicking).
  • If there is an application where tracking does not work, try clicking the text input field once.

3. Indicator misaligns when moving or scrolling windows

  • Behavior/Specifications: FJ Flow caches caret coordinates to minimize CPU usage. However, it automatically detects the following events to discard the cache and update position information in real time:
    • Dragging, moving, or resizing windows
    • Switching focused input controls
    • Scrolling operations using the mouse wheel or touchpad
  • Therefore, the indicator will automatically snap back to the correct position through normal operations.

Space Shift key extension does not respond well

  • Incorrect Space long-press duration: By default, Space Shift triggers when the Space key is held down for 300ms or longer. Adjust the delay to your preference in the “Space Shift” item under the “Lock Details” tab in the settings, or by editing fjFlow.json.
  • Conflict with other key customization tools: If other hotkey utilities (such as other AutoHotkey scripts, PowerToys Keyboard Manager, or manufacturer keyboard software) are running simultaneously, hook conflicts may prevent keys from being captured correctly. Please try pausing conflicting tools to verify operation.

Temporarily disabling the tool

  • You can instantly pause or resume the tool’s operations without using the tray menu by double-tapping (pressing twice in rapid succession) either the left or right Ctrl key on your keyboard.
  • While paused, the system tray icon will change to show the “Paused” state, and the indicator will disappear.