Skip to content

README.md

Latest commit

Β 

History

History
127 lines (83 loc) Β· 3.61 KB

README.md

File metadata and controls

127 lines (83 loc) Β· 3.61 KB

LayoutSwitch ⌨️

Fix text typed in the wrong keyboard layout β€” instantly.

Typed a whole sentence and realized you were in the wrong language? Select the text, press F8, and it's fixed. One key, works everywhere.

Demo

The Problem

Every bilingual typist knows this pain:

You type:  akuo
You meant: Χ©ΧœΧ•Χ

Windows has no built-in fix for this. Until now.

The Solution

  1. Select the mistyped text
  2. Press F8
  3. Done βœ…
Before After
akuo Χ©ΧœΧ•Χ
Χ©ΧœΧ•Χ akuo
vpua yh akr Χ”Χ•Χ“Χ’ ΧœΧ™ Χ©ΧœΧ—

Features

  • πŸ”‘ One key β€” just F8, no Ctrl+Shift combos
  • 🌍 Works everywhere β€” Word, Chrome, VS Code, WhatsApp, Outlook, Excel, Notepad, any app
  • πŸͺΆ Tiny β€” 2KB script, zero UI, zero tray icons, zero bloat
  • πŸš€ Auto-start β€” launches with Windows silently
  • πŸ”„ Auto-detect β€” knows if your text is Hebrew or English
  • πŸ”“ Open source β€” read the code, modify it, trust it

Supported Layouts

  • English (US/QWERTY) ↔ Hebrew (Standard Israeli)

Want to add another language pair? PRs welcome! See Contributing.

Installation

Option 1: One-Click Installer (Recommended)

  1. Download the latest release
  2. Extract the ZIP
  3. Run LayoutSwitch-Installer.bat
  4. Done β€” F8 works immediately

The installer will:

  • Install AutoHotkey v2 if needed (via winget)
  • Copy the script to your Documents folder
  • Add it to Windows Startup

Option 2: Manual (Windows)

  1. Install AutoHotkey v2
  2. Download LayoutSwitch.ahk
  3. Double-click to run
  4. (Optional) Copy to %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\ for auto-start

macOS Installation

  1. Install Hammerspoon (or brew install --cask hammerspoon)
  2. Download the mac/ folder
  3. Run bash install.sh
  4. Grant Accessibility permissions: System Settings β†’ Privacy β†’ Accessibility β†’ Hammerspoon βœ…
  5. Done β€” F8 works!

How It Works

The script maps each physical key position between English and Hebrew keyboard layouts. When you press F8:

  1. Copies selected text to clipboard
  2. Detects if the text is Hebrew or English (by Unicode range)
  3. Converts each character using the keyboard position map
  4. Pastes the corrected text back

No AI, no internet, no API calls. Pure local character mapping.

Uninstall

Windows: Delete %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\LayoutSwitch.ahk

macOS: Delete ~/.hammerspoon/layout-switch.lua and remove the dofile line from ~/.hammerspoon/init.lua

Requirements

Windows: Windows 10/11 + AutoHotkey v2 (auto-installed)

macOS: macOS 10.15+ + Hammerspoon (free, open source)

Why Not Just Use...

Alternative Problem
Langover Heavy install, tray icon, shareware
KEset Chrome extension only β€” doesn't work in Word, WhatsApp, etc.
Online converters Copy β†’ paste β†’ convert β†’ copy β†’ paste back. Tedious.
Windows built-in Doesn't exist ❌
LayoutSwitch One key. Every app. 2KB. Free. βœ…

Contributing

Want to add support for another language pair (Russian, Arabic, French, etc.)?

  1. Fork this repo
  2. Add a new Map() in LayoutSwitch.ahk with the key mappings
  3. Submit a PR

License

MIT β€” do whatever you want with it.

Author

Built by Meir Arad | M Digital

If this saved you time, give it a ⭐