WTFKey

Cross-platform keyboard layout auto-switcher

Problem

You type "ghbdtn" instead of "привет" because you forgot to switch keyboard layout.

Solution

WTFKey detects wrong layout and fixes it automatically — via popup or hotkey.

Features

• Cross-platform (Windows, macOS, Linux)
• Zero telemetry, zero ads
• <10ms latency, <30MB RAM
• Single binary, no dependencies
• Popup, hotkey, or auto mode
• Open source (PolyForm Noncommercial)

Installation

Windows

1. Download wtfkey_windows_amd64.zip from Releases
2. Extract and run wtfkey.exe

macOS

1. Download wtfkey_darwin_amd64.zip from Releases
2. Extract and move to Applications
3. Grant Accessibility permission: System Preferences → Security & Privacy → Privacy → Accessibility

Linux

1. Download wtfkey_linux_amd64.zip from Releases
2. Extract and run ./wtfkey

Usage

WTFKey runs in the system tray. Right-click the icon to:

• Enable/Disable
• Open Settings
• Quit

Modes

Mode	Description
Popup	Shows confirmation popup before replacing
Hotkey	Press Ctrl+Shift+S to replace last word
Auto	Replaces automatically (use with caution)

Configuration

Config file location:

• Windows: %APPDATA%\WTFKey\config.yaml
• macOS: ~/Library/Application Support/WTFKey/config.yaml
• Linux: ~/.config/wtfkey/config.yaml

Building from Source

Desktop App (Go)

cd desktop
go build -o wtfkey

Website (Rails)

bin/setup
bin/dev

Contributing

Contributions welcome! Please read our contributing guidelines.

1. Fork the repository
2. Create feature branch
3. Make changes
4. Submit pull request

License

PolyForm Noncommercial 1.0.0

• Personal use
• View/modify source
• Commercial use (requires license)

Links

• Website: https://wtfkey.com
• Issues: https://github.com/JohnDolan615/wtfkeys/issues