Code Monkey home page Code Monkey logo

eurkey-mac's Introduction

EurKEY-macOS

The Keyboard Layout for Europeans, Coders and Translators. This repo is a fork and contains a modified verison of the EurKEY base layout. It builds on the official layout. You can find version 1.3, the latest official release, in the bundle as well. See the changelog below for my modifications.

EurKEY-macOS is a rework targeted at MacBooks with the with pyhiscal English International keyboard (ISO) instead of the ANSI layout from the official upstream. Since it is an ISO layout, it has one additional key (`) and the big Enter key.

The keyboard layout should be compatible with the other ISO layouts typically available in Europe (e.g. German ISO). However, the printed keys will obviously be different. I tested the layout on the current tenkeyless MacBook keyboard (MacBook Air 2024). Working numpad keys are therefore not guaranteed.

Installation

  • Download the EurKEY.bundle file.
  • Copy the EurKEY.bundle file to /Library/Keyboard Layouts/ (for global installation) or ~/Library/Keyboard Layouts/ (for user installation).
  • Open System Settings > Keyboard > Input Sources
    A screenshot showing the system preferences and where to find the edit button for the input sources.
  • Click the + button
    A screenshot showing how to open the dialogue to add a new input source.
  • Add EurKEY from the list of available input sources
    A screenshot showing where EurKEY is located in the input sources list.
  • Select EurKEY as the input method
    A screenshot showing the dropdown menu in the menu bar extra.

Notes on Ukelele and template icons

I have tried to configure a template icon for the bundle and stumbled onto behaviour that I consider a bug in Ukelele. Template icons are the new style of icons that switch color depending on the system theme.

I tried simply setting a template icon from the GUI using the checkbox, but it never saved it correctly. I had to manually edit *.bundle/Info.plist file and set the flag.

The structure of the Info.plist file is as follows:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>CFBundleIdentifier</key>
	<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS</string>
	→ Bundle Identifier

	<key>CFBundleName</key>
	<string>EurKEY-macOS</string>
	→ Filename of the *.bundle file

	<key>CFBundleVersion</key>
	<string></string>
	<key>KLInfo_EurKEY v2.0</key>
	→ Name of the keyboard layout in the collection list

	<dict>
		<key>TICapsLockLanguageSwitchCapable</key>
		<false/>
		<key>TISIconIsTemplate</key>
		<true/>
		→ Set to true to use the icon as a template

		<key>TISInputSourceID</key>
		<string>de.felixfoertsch.keyboardlayout.EurKEY-macOS.eurkeyv2.0</string>
		→ Identifier for the layout within the bundle, spaces are simply removed from the name.
		→ The syntax is: reverse-prefix-notation.BundleIdentifier.LayoutName

		<key>TISIntendedLanguage</key>
		<string>en</string>
	</dict>
</dict>
</plist>

Changelog

v2.0 (WIP)

  • Configures every key exactly as it is printed on the MacBook keyboard (ISO, English - International).
  • Removes distiction between left/right modifier keys.
  • Uses the *.bundle format to group the layout versions.
  • Adds new monochrome macOS template icon that switches color with the system theme.
  • Renames all dead key states to their initializing key combination for easier identifcation. The following table shows the mappings:
    Key Combinations Dead Key Symbol
    ⌥` `
    ⌥⇧` ~
    ⌥' ´
    ⌥⇧' ¨
    ⌥6 ^
    ⌥⇧6 ˇ
    ⌥7 ˚
    ⌥⇧7 ¯
    ⌥m Ω
    ⌥⇧m
    ⌥\ ¬

v1.4

  • Switches behaviour of superscript and subscript numbers: The subscript numbers are the default; the superscript numbers are available via ⌥⇧<number>.

v1.3

Attribution

You can find the original EurKEY layout on Steffen Brüntjens Website. My modified versions are originally based on the work of Leonardo Brondani Schenkel.

License

eurkey-mac's People

Contributors

felixfoertsch avatar jonasdiemer avatar lbschenkel avatar saesh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

kmplngj

eurkey-mac's Issues

(v1.3) Die Tilde funktioniert nicht

HI,

bei mir funktioniert die Taste links von der 1 nicht korrekt. Laut Steffen Bruentjens layout pdf sollte diese Taste die Tilde und das Backtick erzeugen. Bei mir kommt dort 'ẞ' bzw. '±'.

Viele Grüße
Steffen

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.