Apple Macbook Keyboard Layout


To serve the functionality of the Macintosh operating systems (and because of historical differences), the Apple Keyboard's layout differs somewhat from that of the ubiquitous IBM PC keyboard, mainly in its modifier and special keys. Some of these keys have unique symbols defined in the Unicode block Miscellaneous Technical. I own an Apple MacBook Pro 2016 15 inch model with the german keyboard layout (i.e. A1707 model with the second generation butterfly keys). In an attempt to fix a sticky key I removed the enter-key myself and broke a part of the plastic hinge in the process. Now I am looking for a replacement key for the enter-key for the german keyboard layout. How do you get the Apple Magic keyboard to work on Windows 10 with the fn key and the correct layout? I'm using a Magic Keyboard with British English layout but none of the fn functions work such as media keys, volume, Page Up, Page Down, Home, End, Del, etc. Replacement Laptop Keyboard US Layout for Apple MacBook Pro 13 Retina A1425: Description: Name: Laptop Keyboard Applicable for Apple MacBook Pro 13 Retina A1425 Laptop Year version: 2012 2013 Layout: US English (small Enter key) It is easy to instal and use, lightweight and portable, slim. Please replace the keyboard in the off state. Get Magic Keyboards, trackpads and mice for Mac. Shop sensor switches and keyboard cases for your Mac. Buy online with fast, free shipping.

Some keyboard models that use the Apple keyboard driver may have swapped keys or missing functionality. This article describes how to change the settings for the keyboard so that it behaves as expected.

Numlock is on

You may find that the numlock is on. The symptoms are that only the physical keys 7,8,9,u,i,o,j,k,l and surrounding keys work and output numbers. To fix this hit Fn+F6 twice. You might need to use a utility like numlockx.

Alternatively, set the keycodes manually using xmodmap to avoid use Numlock:

Repeating keys on a wireless keyboard

Unpair the keyboard and then re-pair it. The trick is to hold down the power button throughout the entire pairing process.

hid_apple module options

  • fnmode - Mode of top-row keys
  • swap_opt_cmd - Swap the Option ('Alt') and Command ('Flag') keys
  • iso_layout - Enable/Disable hardcoded ISO-layout of the keyboard. Possibly relevant for international keyboard layouts
  • swap_fn_leftctrl - Swap the Fn and left Control keys

Function keys do not work

If your F<num> keys do not work, this is probably because the kernel driver for the keyboard has defaulted to using the media keys and requiring you to use the Fn key to get to the F<num> keys. To change the behavior temporarily, append2 to /sys/module/hid_apple/parameters/fnmode.

To make the change permanent, set the hid_applefnmode option to 2:

To apply the change to your initial ramdisk, in your mkinitcpio configuration (usually /etc/mkinitcpio.conf), make sure you either have modconf included in the HOOKS variable or /etc/modprobe.d/hid_apple.conf in the FILES variable. You would then need to regenerate the initramfs.

Switching Cmd and Alt/AltGr

This will switch the left Alt and Cmd key as well as the right Alt/AltGr and Cmd key.

Apple Macbook Pro Keyboard Layout

Temporary and immediate solution:

Permanent change, taking place at next reboot:

You then need to regenerate the initramfs.

Swap the Fn and left Control keys

This will switch the Fn and left Control keys.


Temporary and immediate solution:

Permanent change, taking place at next reboot:

You then need to regenerate the initramfs.

< and > have changed place with § and ½

If the < and > are switched with the § and ½ keys, set the xkb optionapple:badmap, for instance by running the following command in your graphical environment:

Alternatively, set the keycodes manually using xmodmap:

If you use a Canadian multilingual layout (where the 'ù' and the '/' is switch) use this:

< and > have changed place with ^ and ° (or @ and #, or ` and ~)

With German layout, circumflex/degree symbol and </> are exchanged. With French layout, @/# are exchanged. With the US layout, `/~ and </> are exchanged.

Apple Macbook Pro Uk Keyboard Layout

To change the behavior temporarily, overwrite/sys/module/hid_apple/parameters/iso_layout with 0:

To make the change permanent, set the hid_appleiso_layout option to 0:

Apple Macbook Air Us Keyboard Layout

You then need to regenerate the initramfs.

PrintScreen and SysRq

Apple Keyboards have an F13 key instead of a PrintScreen/SysRq key. This means that Alt+SysRq sequences do not work, and application actions associated with PrintScreen (such as taking screenshots in many games that work under Wine) do not work. To fix this, you can add setxkbmap -option 'apple:alupckeys' to your .xinitrc. This will map PrintScreen/SysRq to F13, as well as Scroll lock to F14 and Pause to F15.

Alternatively, follow the Map scancodes to keycodes article to map the F13 scancode to the PrintScreen/SysRq keycode, where 458856 (0x070068) is the scancode of F13, and sysrq is the keycode of PrintScreen/SysRq.

Treating Apple keyboards like regular keyboards

Depending on the customisations you want to accomplish, there are two solutions available and some options that are in the kernel. You need to choose one of the other.

Use a patch to hid-apple

While the original hid-apple module does not have options to further customize the keyboard, like swapping Fn and left Ctrl keys or having Alt on the left side of Super, there is a patched version adding this functionality to the module. To use it, install the hid-apple-patched-git-dkmsAUR package. This will install the patched hid-apple and mask out the original one.

The package uses DKMS to automatically recompile the module during kernel upgrades. While the dkms will be pulled in by dependency. You still need to install an appropriate kernel header package manually. See the DKMS page for more info.

In addition to the patched kernel module, a configuration file is also provided by the package at /usr/lib/modprobe.d/hid_apple.conf, which enables PC-like layout by default:

  • Top-row keys are normally function keys, switchable to media keys by holding Fn key, as in #Function keys do not work.
  • Four keys at the lower left corner act as Ctrl, Fn, Super, Alt, in this order.
  • Two keys at the lower right corner act as Alt, Ctrl, in this order.
  • If you have an Ejectcd key, it will act as Delete key.

If you wish to change the default options, copy the configuration file to /etc/modprobe.d and make desired changes:

The file under /etc/modprobe.d will completely override the one with the same name under /usr/lib/modprobe.d, and the content is NOT merged.

Alternatively, put additional options in a file with a different name if you want to keep default ones,

Note: Do not forget to update initramfs after manual changes to configuration files.

Please refer to the project README for the exact meaning of each configuration option and tweaking the configuration file to suit your needs. Learn more about modprobe.d at Kernel module#Using files in /etc/modprobe.d/.

After installation, reboot for the change to take effect, or #Change the Behavior Without Reboot.

Troubleshooting configuration not picked up by the module

Macbook Keyboard Layout

First, make sure the patched version is loaded, see what parameters are provided by the module:

If you don't see new options like swap_fn_leftctrl, ejectcd_as_delete, etc., check your dkms installation.

Then, check if configuration files are correctly included in initramfs: Calyx point for mac download.

Check the presence and content of inintramfs/usr/lib/modprobe.d/hid_apple.conf and any other relevant configuration files in inintramfs/etc/modprobe.d. If they are not there, you should check your /etc/mkinitcpio.conf to include those. By default, there shouldbe a modconf hook that automatically include those files, if not, add it to the HOOKS array after autodetect.

Alternatively, list those files in FILES array explicitly:

Refer to Mkinitcpio#BINARIES and FILES and Mkinitcpio#HOOKS for more explanation on what this means.

Finally, rebuild the initramfs and reboot.

Use un-apple-keyboard

If you do not need all of these customizations and you do not want to compile a new module manually or using dkms, there is an AUR package un-apple-keyboardAUR which does not rely on a new kernel module, but rather just to mappings. It enables the following features:

  • The keyboard is considered as an ISO keyboard (e.g. < and > located at the right of the Left Shift key are working like expected).
  • The function keys are disabled by default. You need to press the Fn key in combination to trigger them. By default, the behavior are thus keys F1 to F12
  • The Alt and Cmd keys are swapped.
  • F13 is mapped to SYSRQ, F14 to Scroll Lock and F15 to Pause.

The first 3 aforementioned features are brought to you using the default linux kernel module hid-apple.

The last one is provided by providing a mapping to keyfuzzAUR.

Change the Behavior Without Reboot

Warning: If the builtin keyboard and touch pad are the only input device, beware that doing so might leave your computer in an inoperable state unless hard reboot when the second command failes.

To reload the kernel module without reboot, run rmmod hid_apple && modprobe hid_apple.

Magic Keyboard does not connect

If you have a magic keyboard that will not connect to the system through the built in tools, such as the Gnome 3 bluetooth menu in settings, install blueman and its dependencies and attempt to connect with it. If it still fails to connect, make sure you have bluetoothctl and hcitool installed.

Enable dvorak/dvp

By default xkb loads translation table (actually called xkb_symbols) macintosh_vndr/us for macintosh keyboard:

This translation table located in /usr/share/X11/xkb/symbols/macintosh_vndr/us and don't contains dvorak/dvp layout. You can use default translation table from /usr/share/X11/xkb/symbols/us and add command setxkbmap in your .profile for forced loading layout:

Apple Macbook Keyboard Layout Shortcuts

No input during root disk decryption

You may have to manually add the hid_apple module to the mkinitcpio configuration:

Or place the keyboard hook before autodetect so that all keyboard drivers are included:

Regenerate the initramfs after doing either of these.

See also

Retrieved from ''


[EN] French MacBook keyboard layout for Windows.
To be used in virtualized environments (Windows guests running on VMWare or VirtualBox), BootCamp, native Windows, etc.

[FR] Disposition de clavier MacBook français pour Windows.
A utiliser en environnement virtualisé (invités Windows sur VMWare, VirtualBox), BootCamp, Windows natif, etc.


[EN] Download le fichier, uncompress the archive and run setup.exe. Accept if a Windows UAC prompt appears. Then, configure the keyboard layout in the regional settings of the configuration panel.


[FR] Télécharger le fichier, décompresser l’archive et lancer setup.exe. Accepter si une fenêtre Windows UAC apparaît. Ensuite, configurer la disposition du clavier dans les options du panneau de configuration.


Apple Macbook Pro Keyboard Layout

[EN] Compiled with Microsoft Keyboard Layout Creator 1.4. Windows all versions.

[FR] Compiled with / Compilé avec Microsoft Keyboard Layout Creator 1.4. Windows toutes versions.
md5 : a07c36d1a87bdd8a66d786c59d1f2d69