xmodmap

本文章或章节需要扩充。

原因： 为什么 xmodmap 仅推荐用于最简单的任务？ (在 Talk:Xmodmap 中讨论)

xmodmap 是一个用于修改 Xorg 中键位映射和指针按钮映射的实用程序。

xmodmap 与 X 键盘扩展 (XKB) 没有直接关系，因为它在 X 内部处理 键码 (keycodes) 的方式使用了不同的（pre-XKB）理念。通常，它仅推荐用于最简单的任务。高级布局配置请参阅 X 键盘扩展。

注

xmodmap 的设置会被 setxkbmap 重置，后者不仅会将字母数字键更改为映射表中的值，还会将所有其他键重置为启动默认值（参见 LQWiki:Configuring keyboards）。
由于 Xorg 的限制，xmodmap 的设置不会自动应用于热插拔设备。如果在应用自定义表之后向系统添加键盘，则必须重新应用该自定义表。[1]

简介

在 Xorg 中有两种类型的键盘值：键码 (keycodes) 和 键符号 (keysyms)。

keycode (键码): keycode 是当按下某个按键或鼠标按钮时，内核接收到的数字表示。
keysym (键符号): keysym 是分配给 keycode 的值。例如，按下 a 会产生 keycode 38，它被映射到 keysym 0×61，这与 ASCII 表中的 a 相匹配。; keysyms 由 Xorg 在一张定义 keycode-keysym 关系的 keycodes 表中管理，这张表被称为键位映射表 (keymap table)。可以通过运行 xmodmap 来显示此表。

安装

可以通过 xorg-xmodmap 软件包安装xmodmap。

可选地，安装 xkeycaps，它是 xmodmap 的图形化前端。

键位映射表

打印当前格式化为表达式的键位映射表

$ xmodmap -pke

[...]
keycode  57 = n N
[...]

每个 keycode 后面跟着它所映射的 keysym。上述示例表明 keycode 57 映射到小写 n，而大写 N 映射到 keycode 57 加上 Shift。

表中的每个 keysym 列对应于修饰键的特定组合

按键
Shift+Key
Mode_switch+Key
Mode_switch+Shift+Key
ISO_Level3_Shift+Key
ISO_Level3_Shift+Shift+Key

并非所有 keysyms 都必须设置，但如果只想分配后面的 keysym，请使用 NoSymbol 值。

要查看哪个 keycode 对应于某个按键，请参阅 Keyboard input#Identifying keycodes in Xorg 中关于 xev 实用程序的详细信息，当你按下按键时，它会输出相关的键码/键符号信息。

提示多媒体键有预定义的描述性 keysyms，例如 XF86AudioMute 或 XF86Mail。这些 keysyms 可以在 /usr/include/X11/XF86keysym.h 中找到。许多多媒体程序旨在开箱即用地与这些 keysyms 配合工作，无需配置任何第三方应用程序。

请注意，xmodmap 受 xkbd 设置的影响，因此 US(intl) xkbd 布局可以使用所有 8 个 keysym，但默认的 US 布局则不行（缺少在 level3 中定义的 ralt_switch 符号）。为了使所有 8 个 keysym 可用，你应该配置键盘的 (intl) 变体。以 US 布局为例，在调用 xmodmap 以在当前 X 会话中测试更改之前，执行 $ setxkbmap -layout 'us(intl)'。要永久更改，请编辑 xorg 配置或你的 .xprofile 或 .xinitrc 文件。详见 Xorg/Keyboard configuration#Setting keyboard layout 的完整解释。

自定义表

创建键映射表（即 ~/.Xmodmap）

$ xmodmap -pke > ~/.Xmodmap

测试更改

$ xmodmap ~/.Xmodmap

激活自定义表

使用 GDM, XDM 或 LightDM 时，无需加载 ~/.Xmodmap。对于 startx，请使用

~/.xinitrc

[[ -f ~/.Xmodmap ]] && xmodmap ~/.Xmodmap

或者，编辑全局启动脚本 /etc/X11/xinit/xinitrc。

测试更改

进行临时更改

$ xmodmap -e "keycode 46 = l L l L lstroke Lstroke lstroke"
$ xmodmap -e "keysym a = e E"

修饰键

xmodmap 也可以用于覆盖修饰键 (modifier keys)，例如交换 Control 和 Super（Windows 键）。

详细打印当前修饰键表（完整示例）

$ xmodmap -pm

xmodmap:  up to 4 keys per modifier, (keycodes in parentheses):

shift       Shift_L (0x32),  Shift_R (0x3e)
lock        Caps_Lock (0x42)
control     Control_L (0x25),  Control_R (0x69)
mod1        Alt_L (0x40),  Meta_L (0xcd)
mod2        Num_Lock (0x94)
mod3      
mod4        Super_R (0x86),  Super_L (0xce),  Hyper_L (0xcf)
mod5        ISO_Level3_Shift (0x5c),  ISO_Level3_Shift (0x6c),  Mode_switch (0x85),  Mode_switch (0xcb)

查找 keysym 列修饰键

本文或本章节是与 #键位映射表合并的候选对象。

备注： 本节的目的似乎不在于“查找”任何东西。修饰键的含义应该在首次提到的 #键位映射表中进行解释。(在 Talk:Xmodmap 中讨论)

ISO_Level3_Shift: 非美国键盘上的 AltGr 键调用修饰键 ISO_Level3_Shift。（在美国键盘上，右 alt Alt_R 与左 alt Alt_L 功能相同，因此更建议将布局设置为 US international。参见 #键位映射表。）
Mode_switch: Mode_switch 修饰键在默认情况下可能会映射到你的键盘上不存在的按键。

注意修饰键名称 ISO_Level3_Shift 和 Mode_switch 在 xmodmap 和 X 键盘扩展之间的用法不同。另请参阅 [2]。

将修饰键重新分配给键盘按键

注意 xmodmap 是区分大小写的。使用错误的大小写，例如使用 Mode_Switch 而不是正确的 Mode_switch 将导致错误。

在分配之前，需要清除修饰键。这适用于你打算分配的修饰键以及你打算使用的按键上的修饰键。例如，如果你打算将 Caps_Lock 分配给 A 键，将 B 分配给 NumLock 键，你需要先清除 Caps_Lock 和 Num_Lock 的修饰键，然后分配键符号 (keysyms)，最后再把修饰键添加回去。

~/.Xmodmap

[...]
clear lock
clear mod2
keycode  38 = Caps_Lock
keycode  77 = Num_Lock
add lock = Caps_Lock
add mod2 = Num_Lock

! 是注释，因此在以下示例中只有修饰键 Control 和 Mod4 被清除。然后将 keysyms Control_L, Control_R, Super_L 和 Super_R 分配给相反的修饰键。将左右键都分配给同一个修饰键意味着这两个键将被相同对待。

~/.Xmodmap

[...]
!clear Shift
!clear Lock
clear Control
!clear Mod1
!clear Mod2
!clear Mod3
clear Mod4
!clear Mod5
!add Shift   = Shift_L Shift_R
!add Lock    = Caps_Lock
add Control = Super_L Super_R
!add Mod1    = Alt_L Alt_R
!add Mod2    = Mode_switch
!add Mod3    =
add Mod4    = Control_L Control_R
!add Mod5    =

注意该示例假设 Control_L 和 Control_R 键符号已分配给 Control 修饰键，而 Super_L 和 Super_R 键符号已分配给 Mod4 修饰键。如果你收到以下错误消息 X Error of failed request: BadValue (integer parameter out of range for operation)，你需要相应地进行调整。运行 xmodmap 会产生一个修饰键及其分配按键的列表。

以下示例将 CapsLock 修改为 Control，并将 Shift+CapsLock 修改为 CapsLock

~/.Xmodmap

clear lock
clear control
add control = Caps_Lock Control_L Control_R
keycode 66 = Control_L Caps_Lock NoSymbol NoSymbol

组合键

本文或本章节是与 Xorg/键盘配置#配置组合键合并的候选对象。

备注： 与 Xorg/Keyboard_configuration#Configuring_compose_key 重复 (在 Talk:Xmodmap 中讨论)

组合键 (compose key) 用于创建键盘上无法直接访问的特殊字符和符号。这对于输入非英语语言的带重音字母特别有用。例如，依次按下 Compose e ' 将产生 é。某些字符在按下 Compose 后需要按下 2 个以上的键。通常会将一个选定的修饰键映射为 Compose。大多数桌面环境的 GUI 设置中都可以设置组合键，但如果使用了本文所述的自定义键映射表，这些选项将不起作用。要使用 Xmodmap 设置组合键，请使用 Multi_key 标识符。例如，将右 alt 键 (AltGr) 映射为组合键：

~/.Xmodmap

[...]
keycode 108 = Multi_key Alt_R Meta_R Alt_R Meta_R

键码数字可能会根据键盘型号而有所不同。

反向滚动

本文或本章节是与鼠标按键合并的候选对象。

备注： xmodmap 不是实现此功能的唯一方法。(在 Talk:Xmodmap 中讨论)

OS X Lion 中提供的自然滚动 (natural scrolling) 功能（模拟智能手机或平板电脑滚动）可以通过 xmodmap 实现。由于 synaptics 驱动程序使用按钮 4/5/6/7 分别进行上/下/左/右滚动，你只需在 ~/.Xmodmap 中交换这些按钮声明的顺序即可

~/.Xmodmap

pointer = 1 2 3 5 4 7 6 8 9 10 11 12

然后更新 xmodmap

$ xmodmap ~/.Xmodmap

交换鼠标按键

本文或本章节是与鼠标按键合并的候选对象。

备注： xmodmap 不是实现此功能的唯一方法。(在 Talk:Xmodmap 中讨论)

在 synaptics 驱动程序中，鼠标左键、中键和右键分别对应按钮 1、2 和 3。要交换鼠标左键和右键，同样只需反转它们在 ~/.Xmodmap 中的列出顺序

~/.Xmodmap

pointer = 3 2 1

对于简单的鼠标设置，这应该足够了。同样，更新 xmodmap

$ xmodmap ~/.Xmodmap

模板

西班牙语

~/.Xmodmap

keycode  24 = a A aacute Aacute ae AE ae
keycode  26 = e E eacute Eacute EuroSign cent EuroSign
keycode  30 = u U uacute Uacute downarrow uparrow downarrow
keycode  31 = i I iacute Iacute rightarrow idotless rightarrow
keycode  32 = o O oacute Oacute oslash Oslash oslash
keycode  57 = n N ntilde Ntilde n N n
keycode  58 = comma question comma questiondown dead_acute dead_doubleacute dead_acute
keycode  61 = exclam section exclamdown section dead_belowdot dead_abovedot dead_belowdot
!Maps the Mode key to the Alt key
keycode 64 = Mode_switch

世界语 (Esperanto)

接下来是一个示例，通过按下 AltGr 和相关字母即可输入世界语字母。例如，如果你输入 AltGr+C，你将获得字母 "Ĉ"。

~/.Xmodmap

keycode 54 = c C c C ccircumflex Ccircumflex
keycode 42 = g G g G gcircumflex Gcircumflex
keycode 43 = h H h H hcircumflex Hcircumflex
keycode 44 = j J j J jcircumflex Jcircumflex
keycode 39 = s S s S scircumflex Scircumflex
keycode 30 = u U u U ubreve Ubreve

将 CapsLock 变为 Control

将 CapsLock 变为 Control 的最简单示例。

~/.Xmodmap

clear lock
clear control
keycode 66 = Control_L
add control = Control_L Control_R

将 CapsLock 变为 Control，将 LeftControl 变为 Hyper

笔记本电脑用户可能更喜欢将 CapsLock 用作 Control。Left Control 键可以用作 Hyper 修饰键（用于 emacs, openbox 或 i3 的额外修饰键）。

~/.Xmodmap

clear      lock 
clear   control
clear      mod1
clear      mod2
clear      mod3
clear      mod4
clear      mod5
keycode      37 = Hyper_L
keycode      66 = Control_L
add     control = Control_L Control_R
add        mod1 = Alt_L Alt_R Meta_L
add        mod2 = Num_Lock
add        mod3 = Hyper_L
add        mod4 = Super_L Super_R
add        mod5 = Mode_switch ISO_Level3_Shift

将 Super_R 变为 Hyper_R

希望在全尺寸键盘布局上拥有 Hyper 键的用户，可能希望将右 Super 键用作 Hyper。

~/.Xmodmap

remove  mod4 = Super_R
keycode  134 = Hyper_R
add     mod3 = Hyper_R

将每个数字键 N 与 Shift-N 互换（适用于克罗地亚语布局）

对于与克罗地亚语类似的布局也应该有效。

~/.Xmodmap

keycode 10 = exclam 1 1 exclam asciitilde dead_tilde asciitilde
keycode 11 = quotedbl 2 2 quotedbl dead_caron caron dead_caron
keycode 12 = numbersign 3 3 numbersign asciicircum dead_circumflex asciicircum
keycode 13 = dollar 4 4 dollar dead_breve breve dead_breve
keycode 14 = percent 5 5 percent degree dead_abovering degree
keycode 15 = ampersand 6 6 ampersand dead_ogonek ogonek dead_ogonek
keycode 16 = slash 7 7 slash grave dead_grave grave
keycode 17 = parenleft 8 8 parenleft dead_abovedot abovedot dead_abovedot
keycode 18 = parenright 9 9 parenright dead_acute apostrophe dead_acute
keycode 19 = equal 0 0 equal dead_doubleacute doubleacute dead_doubleacute

参见

xmodmap(1)
Christian Weiske 编写的通过 .Xmodmap 配置多媒体键 HOWTO
Pascal Bleser 编写的使用 xmodmap 映射不支持的按键
LQWiki: xmodmap 识别的键符号 (Keysyms) 列表