Frequently Asked Questions

Download the installer for your platform from the homepage, run it, and follow the on-screen instructions. You'll need to grant keyboard monitoring permissions when prompted. WTFKey will start automatically and run in the background.

Windows 10 or later, macOS 11 (Big Sur) or later, or Linux (Ubuntu 20.04+, Fedora 35+, or equivalent). WTFKey requires ~10MB of disk space and uses less than 30MB of RAM.

On Windows and macOS, you'll need administrator privileges for the initial installation. On Linux, installation can be done in user space without root access, though some distributions may require sudo for system-wide installation.

Since WTFKey isn't signed with an Apple Developer certificate, macOS blocks it by default. To open: Right-click the app → Open → click 'Open' in the dialog. Or go to System Settings → Privacy & Security → scroll down → click 'Open Anyway'.

WTFKey uses intelligent pattern recognition to detect when you've typed in the wrong keyboard layout. It analyzes character sequences and compares them against known layout mappings to identify mistakes in real-time with sub-10ms latency.

WTFKey offers three modes: 1) Popup mode - shows a notification with the corrected text you can click to replace, 2) Hotkey mode - press a configured hotkey (default: Ctrl+Shift+Space) to convert the last typed word, 3) Auto mode - automatically replaces text as you type (experimental).

Right-click the WTFKey system tray icon and select Preferences. Choose your preferred correction mode from the dropdown menu. Changes take effect immediately without requiring a restart.

Windows: %APPDATA%/WTFKey/config.json | macOS: ~/Library/Application Support/WTFKey/config.json | Linux: ~/.config/wtfkey/config.json. You can edit this JSON file to customize WTFKey's behavior.

Open the config file and add application names or window titles to the 'excludedApps' array. For example: ['chrome.exe', 'Terminal', 'password-manager']. Wildcards (*) are supported. Changes are detected automatically.

Yes! Edit the config file and add new language pairs under the 'layouts' section. Each pair needs a character mapping between the two keyboard layouts. Check our GitHub repository for community-contributed layouts you can copy.

Yes. WTFKey is open source (MIT license) and works completely offline. Your keystrokes are processed locally and never sent to any server. The source code is available on GitHub for full transparency and security audits.

Absolutely not. WTFKey has zero telemetry, no analytics, and no data collection of any kind. We don't track your usage, keystrokes, or any personal information. The only data we collect is anonymous download counts from our website.

WTFKey requires keyboard monitoring permissions to detect layout mistakes and accessibility permissions to perform text replacements. These permissions are necessary for core functionality and are only used locally on your machine.

WTFKey is released under the MIT License. It's completely free and open source. You can use it, modify it, and distribute it without restrictions. Commercial use is also allowed.

First, check that WTFKey is running (look for the system tray icon). Verify you've granted all required permissions. Check the config file for syntax errors. Try restarting WTFKey. If issues persist, check our GitHub Issues page for known problems and solutions.

Windows: Use 'Add or Remove Programs' in Settings | macOS: Drag WTFKey from Applications to Trash, then remove ~/Library/Application Support/WTFKey | Linux: Use your package manager (apt remove wtfkey) or run the uninstall script from the installation directory.

Please open an issue on our GitHub repository. Include your operating system, WTFKey version, keyboard layouts you're using, and detailed steps to reproduce the bug. Logs (if available) are also helpful. We appreciate all bug reports!

Absolutely! WTFKey is open source and we welcome contributions. Whether it's code, documentation, translations, bug reports, or feature requests - your help makes WTFKey better for everyone. Check out our GitHub repository to get started.