Skip to content

About

The home of the EurKEY Next keyboard layout

Resources

Stars

144 stars

Watchers

5 watching

Forks

 
 

Repository files navigation

EurKEY Next

A macOS keyboard layout for Europeans, coders, and translators. This repo contains a modified version of the EurKEY base layout for macOS, bundling multiple versions so users can pick what they need.

A keyboard layout is a map that tells your Mac which character should appear on screen when you press a physical key. The same key can produce y on a US layout or z on a German layout — the layout, not the keycap, decides. EurKEY Next is one such map. Install it once, switch to it like any other input source, and your keys now produce accented characters (ä, é, ñ, č, …) and programmer symbols without reaching for a character palette.

What is it good for?

You stay on one layout to write in English, German, French, Spanish, Czech, and most other European languages. English letters behave exactly as on a US layout; accents and special characters live on the Option layer, one keystroke away.

Example. Your MacBook has a US-international (ISO) keyboard. You code in English, email in German, and chat in Spanish. Without EurKEY you flip between three input sources and dig through a popup for ä. With EurKEY you stay put: type ⌥u then a → ä, write English code normally, reach ñ with ⌥n n. No input-source switching, no character palette.

EurKEY Next is not an app or a keymap plugin. It is a standard macOS keyboard-layout bundle, installed the same way Apple's built-in layouts are. Once added, it shows up next to "U.S." in your input source list and works system-wide.

What is a "dead key"?

A dead key is a key that produces nothing on its own — it waits for the next keystroke and combines with it. Type the dead key, release, then type the base letter; the combined character appears. For example, ⌥u (acute-acute dead key) followed by a produces ä. This is how every macOS European layout has worked for decades; EurKEY just makes the dead keys predictable and programmer-friendly.

Installation

Homebrew

brew install eurkey-next

Then log out and back in (or restart), open System Settings → Keyboard → Input Sources, click +, and select EurKEY Next.

From DMG

  1. Download the latest EurKEY-Next-YYYY.MM.DD.dmg from Releases.
  2. Open the DMG and drag EurKEY-Next.bundle to the Install Here (Keyboard Layouts) folder.
  3. Log out and back in (or restart).
  4. System Settings → Keyboard → Input Sources → + → select EurKEY Next.

Manual

  1. Download or clone this repo.
  2. Copy EurKEY-Next.bundle to /Library/Keyboard Layouts/ (system-wide) or ~/Library/Keyboard Layouts/ (user-only).
  3. Log out and back in.
  4. System Settings → Keyboard → Input Sources → + → select EurKEY Next.

After installing, click the input source icon in the menu bar and switch to EurKEY Next.

System Settings showing the Edit button for input sources.

Dialog to add a new input source.

EurKEY Next in the input sources list.

Selecting EurKEY Next from the menu bar dropdown.

Versions

The bundle ships 4 layout versions:

Version Description
EurKEY Next Every key configured exactly as printed on the MacBook keyboard. Removes left/right modifier key distinction. Monochrome template icon.
v1.4 v1.3 with swapped super/subscript numbers: ⌥m 1…0 → subscript (₁…₀), ⌥m ⇧1…⇧0 → superscript (¹…⁰).
v1.3 Official EurKEY spec implementation.
v1.2 Legacy version based on Leonardo Schenkel's port. Predates the v1.3 spec (no ⌥\ dead key, § instead of ẞ on ⌥⇧S).

EurKEY Next works with both ISO and ANSI keyboards. It targets the physical English International keyboard on European MacBooks (ISO) but is fully compatible with US ANSI keyboards. The ISO key between left Shift and Z (§/±) does not exist on ANSI — these characters are reachable via the ⌥\ dead key: ⌥\ s → §, ⌥\ S → ±. Tested on the current tenkeyless MacBook keyboard (MacBook Air 2024); numpad keys are not guaranteed.

Dead key compositions (EurKEY Next)

Key combination Dead key symbol
⌥`` `` `
⌥⇧`` `` ~
⌥' ´
⌥⇧' ¨
⌥6 ^
⌥⇧6 ˇ
⌥7 ˚
⌥⇧7 ¯
⌥m α
⌥⇧m 𝕄
⌥\ ¬

Known issues

  • Icon not visible in keyboard switcher badge (macOS Sonoma/Sequoia): the template icon (which adapts to light/dark mode) disappears in the input-source switching badge attached to text fields. This is a macOS bug affecting third-party template icons — Apple's built-in layouts are not affected. Non-template icons work correctly but lose dark-mode adaptation.

Development

The repo includes build and validation scripts for maintainers — end users do not need to run them. They build the bundle, generate the DMG, and verify layouts against the v1.3 spec.

bash scripts/validate-layouts.sh       # validate all layouts (builds the bundle first if missing)
bash scripts/build-bundle.sh           # build the bundle (validates + generates Info.plist)
bash scripts/build-dmg.sh              # create a DMG installer
python3 scripts/parse_keylayout.py "EurKEY-Next.bundle/Contents/Resources/EurKEY v1.3.keylayout" --summary

Ukelele's GUI checkbox for template icons does not save correctly — the TISIconIsTemplate flag must be set manually in Info.plist (<key>TISIconIsTemplate</key><true/>). scripts/build-bundle.sh generates Info.plist with this flag set for all layout versions.

Attribution

The original EurKEY layout is by Steffen Brüntjen. The macOS port is originally based on the work of Leonardo Brondani Schenkel.

License

About

The home of the EurKEY Next keyboard layout

Resources

Stars

144 stars

Watchers

5 watching

Forks

Releases

Contributors

Languages