Tunlookup is a popular cross-platform desktop application created by Peter Nguyen that allows users to instantly translate selected text with a simple keystroke shortcut. However, like any productivity tool that relies on system permissions and active internet connections, users can occasionally run into execution bugs.
If your translation workflow has stalled, follow this fast troubleshooting guide to resolve the most common Tunlookup errors immediately. 1. Keystroke Shortcut Fails to Trigger
If pressing your standard hotkey (like Ctrl + Q on Windows or ⌘ + D on macOS) does not bring up the translation window, the application usually lacks the deep system integration it requires to listen for global hotkeys.
Grant Accessibility Permissions (macOS): Open System Settings > Privacy & Security > Accessibility. Ensure the checkbox next to Tunlookup is turned on.
Check Version Settings: On versions 3.0.4 and newer, the app relies on a single-keystroke intercept. Older versions might require a double tap (Ctrl + C then Ctrl + Q).
Resolve Software Conflicts: Background dictionary programs, clipboard managers, or gaming software might be hijacking your selected hotkey. Close competing apps or remap the hotkey inside Tunlookup settings. 2. Network and Timeout Errors
Because Tunlookup dynamically fetches translations online, network disruptions or overly restrictive security setups can break its connection to the translation engine.
Flush Your Local DNS: Clear out corrupt internet routing data by opening your terminal or command prompt and running ipconfig /flushdns (Windows) or sudo dscacheutil -flushcache (macOS).
Whitelist the App: Your native system firewall or third-party antivirus software might actively block Tunlookup’s outbound traffic. Add Tunlookup to your firewall’s “Allowed Apps” list.
Toggle Your VPN: If you use a VPN or a proxy server, the translation server might block your temporary IP address. Temporarily turn off your VPN to test the connection. 3. Database and History Sync Failures
Tunlookup includes local dictionary logging and cloud syncing capabilities. If the application freezes while saving words or during cloud synchronization, your local profile database is likely corrupted.
Re-authenticate Your License: Go directly to the Sync tab in your application settings, re-enter your active Pro license key, and click Activate.
Perform a Clean App Restart: Completely close the application (ensure it is fully shut down in the Windows Task Manager or macOS Activity Monitor), then relaunch it to force a database reload.
Clear Cache Folders: If problems persist, navigate to your operating system’s local app data directory (e.g., AppData/Roaming on Windows) and delete the temporary cache files associated with Tunlookup. 4. Selection Highlight Misreads Text
Sometimes the app triggers, but the translation window is blank or shows garbled text characters. This happens when the app cannot cleanly scrape the active text from your clipboard or screen.
Verify the Target Application: Some protected programs (like secure PDF viewers, banking portals, or certain video game client overlays) explicitly block third-party tools from reading on-screen text or accessing the system clipboard. Try selecting text in a basic text editor to isolate the bug.
Update the Application: Ensure you are running the newest stable release by checking the official Tunlookup GitHub repository to prevent syntax scaling bugs on newer operating system updates.
To help pinpoint your specific issue, what operating system version are you running, and what error behavior or message do you see when the tool fails?
thephucit/tunlookup: Translates selected text with a keystroke
Leave a Reply