Apple Keyboard

From ArchWiki
Jump to: navigation, search

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

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 this behaviour, you have to change a driver setting. Do the following as root:

echo 2 > /sys/module/hid_apple/parameters/fnmode

If it tells you that the file doesn't exist, you probably have an older kernel and will have to do the following instead:

echo 2 > /sys/module/hid/parameters/pb_fnmode

Place whichever command worked for you in /etc/rc.local to make the setting permanent.

< and > have changed place with § and ½

If the < and > are switched with the § and ½ keys, run the following command:

setxkbmap -option apple:badmap

Place that command into ~/.bashrc file to have it run automatically when you log in.

You can also apply the change system-wide by creating (or editing) /etc/X11/xorg.conf.d/10-keymap.conf as such:

Section "InputClass"
    Identifier "keyboard catchall"
    MatchIsKeyboard "true"
    Driver "evdev"
    Option "XkbOptions" "apple:badmap"

If the above approach doesn't seem to work, you can add these two lines to your ~/.Xmodmap file:

keycode  49 = less greater less greater bar brokenbar
keycode  94 = section degree section degree notsign notsign

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

keycode  94 = slash backslash slash backslash bar brokenbar
keycode  49 = ugrave Ugrave ugrave Ugrave notsign notsign

Then run xmodmap ~/.Xmodmap. This command can also go into ~/.bashrc.

< and > have changed place with ^ and °

With German layout, circumflex/degree symbol and 'smaller than'/'bigger than' are exchanged.

To fix this, do the following:

xmodmap -e 'keycode 49 = less greater less greater bar brokenbar bar' -e 'keycode 94 = dead_circumflex degree dead_circumflex degree U2032 U2033 U2032'

Now try your keys. When it works, you may want the change permanently. So execute this:

xmodmap -pke | grep " 49" >> ~/.Xmodmap
xmodmap -pke | grep " 94" >> ~/.Xmodmap

Media Keys

The evdev driver should produce keycodes that map to the appropriate keysyms for your media keys by default. You can confirm that by running xev in a console window and watching the console output as you press your media keys.

For these keys to have any effect, you will have to assign actions to them. Refer to Extra Keyboard Keys in Xorg for more about that.

If you have confirmed that your media keys are not producing the correct keycodes, create or edit the ~/.Xmodmap file so that it includes these lines:

keycode 160 = XF86AudioMute
keycode 176 = XF86AudioRaiseVolume
keycode 174 = XF86AudioLowerVolume

keycode 144 = XF86AudioPrev
keycode 162 = XF86AudioPlay
keycode 153 = XF86AudioNext

keycode 101 = XF86MonBrightnessDown
keycode 212 = XF86MonBrightnessUp

keycode 204 = XF86Eject

and then run xmodmap ~/.Xmodmap. Place that command in the ~/.bashrc file to have it run automatically when you log in.

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. Both issues can be addressed by installing keyfuzzAUR from the Arch User Repository.

With keyfuzz installed, run the following command:

echo "458856 99" | /usr/sbin/keyfuzz -s -d /dev/input/by-id/usb-Apple__Inc_Apple_keyboard-event-kbd

458856 (0x070068) is the scancode of F13, and 99 is the keycode of PrintScreen/SysRq. You can determine the scancode of a particular key with getscancodesAUR from the AUR, and the keycode from /usr/include/linux/input.h.

Other versions of the Apple Aluminum Keyboard may require a slightly different device path, so adjust it as needed. You can make this change permanent by putting the command in /etc/rc.local.

Treating Apple Keyboards Like Regular Keyboards

If you want to use your Apple keyboard like a regular US-layout keyboard, with Alt on the left side of Meta, you can use the AUR package un-apple-keyboardAUR. Currently it only works for the aluminium USB model. The package does the following things:

  • Adds a /etc/modprobe.d/hid_apple.conf file which enables the F keys by default, as above.
  • Uses keyfuzz to remap F13-15 to PrintScreen/SysRq, Scroll Lock, and Pause, respectively
  • Swaps the ordering of the Template:Keypress and Template:Keypress (Template:Keypress) keys to match all other keyboards, again using keyfuzz.
  • Applies these changes automatically when you plug in your keyboard, with a udev rule.

You will need to add /etc/modprobe.d/hid_apple.conf to FILES in mkinitcpio.conf. Otherwise if you boot your computer with the Apple keyboard plugged in, the F keys will not be the default.