Xmodmap (简体中文)
xmodmap是一个用于修改 Xorg 中键位图和指针按钮映射的工具。
xmodmap与 X keyboard extension (XKB)没有直接关系。这两个程序对于X中的如何处理"键码"的理解是不一样的（xmodmap 更早）。一般来说，它只被推荐用于最简单的任务。请参阅 X keyboard extension 了解高级布局配置。
简介
在 Xorg 中有两种类型的键盘值：键码和键符。
- 键码 keycode
- 键码是当按键或鼠标按钮被按下时，内核收到的表示数字。
- 键符 keysym
- 键符是键码所对应的符号表达值。例如，按
a产生38号键码，它被映射到0×61号键符，对应 ASCII表中的a。 - 在Xorg中，键符通过一个定义键码-键符对应关系的表管理。这个表叫做键映射表。可以通过运行
xmodmap来显示。
安装
xmodmap 由 xorg-xmodmap 包提供。
也可以安装 xkeycaps，这是一个xmodmap的图形前端。
键映射表
打印以表达式格式呈现的键映射表：
$ xmodmap -pke
[...] keycode 57 = n N [...]
每个键码后面都跟着映射到的键符。上面的例子意思是：键码57被映射到小写n键符，而大写N键符则对应按下Shift输入的57号键码。
表中的每一列键符都对应着一个特定的修饰键组合，Key为键码所对应的按键：
KeyShift+KeyMode_switch+KeyMode_switch+Shift+KeyISO_Level3_Shift+KeyISO_Level3_Shift+Shift+Key
并非所有的键符都必须设置，但如果要跳过一个键符，请将其值设为NoSymbol。
要查看一个键对应的键码，请参见Keyboard input#Identifying keycodes in Xorg以了解xev实用程序的细节，它将在你按下一个键时输出相关的键码与键符信息。
XF86AudioMute 或 XF86Mail 。这些键符可以在{ {ic中找到。许多多媒体程序都被设计成可以直接通过这些键符控制，而不需要配置任何第三方应用程序。
}}
请注意，xmodmap会受到 xkbd 设置的影响，所以所有8个键符都可以用于美式键盘（国际）的 xkbd 布局，但不能用于默认的美式键盘（它缺少ISO Level3中定义的ralt_switch符号）。为了让所有8个键位都可用，你应该配置把键盘设置为美式键盘（国际）。 以美式键盘布局为例，在调用 xmodmap 之前调用 $ setxkbmap -layout 'us(intl)' 以在当前X会话中测试您的更改。要永久地做这个改变，请编辑 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也可以用来覆盖修饰键，例如交换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)
找到键符的修饰键
- ISO_Level3_Shift
- 非美式键盘上的AltGr键调用修饰键ISO_Level3_Shift。（在美式键盘上，右alt
Alt_R与左altAlt_L具有相同的功能，因此将布局设置为美式键盘（国际）会更灵活。参见#键映射表） - Mode_switch
- 默认情况下，Mode_switch修饰键可能会被映射到一个虚拟的键。
重新安排修饰键位
Mode_Switch，（正确的是 Mode_switch）会导致错误。在重排之前，需要清除修饰键。原来的键和新的键都得清除。例如，如果您打算将Caps_Lock换到A键，将B换成NumLock键，那么Caps_Lock,Num_Lock,A,B四个键都得清除，然后分配键位，最后再把他们加回来。
~/.Xmodmap
[...] clear lock clear mod2 keycode 38 = Caps_Lock keycode 77 = Num_Lock add lock = Caps_Lock add mod2 = Num_Lock
!用于注释一行，所以在下面的例子中，只有 Control 和 Mod4 这两个修饰符被清除。然后，键符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
反向滚动
OS X Lion中可用的自然滚动功能（模仿智能手机或平板电脑滚动）可以通过xmodmap来实现。由于 synaptics 驱动程序使用 4/5/6/7 按钮进行上/下/左/右滚动，你只需要调换一下 ~/.Xmodmap 中按钮的声明顺序：
~/.Xmodmap
pointer = 1 2 3 5 4 7 6 8 9 10 11 12
然后更新xmodmap：
$ xmodmap ~/.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
将 CapsLock 换成 Control
将 CapsLock 改为 Control 的最简单的例子。
~/.Xmodmap
clear lock clear control keycode 66 = Control_L add control = Control_L Control_R
将CapsLock转为Control，将左Control转为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 变成右 Hyper
如果用户希望在全键盘布局中使用 Hyper 键，不妨将右 Super 键作为 Hyper 键。
~/.Xmodmap
remove mod4 = Super_R keycode 134 = Hyper_R add mod3 = Hyper_R
将Shift-数字键与数字键对换（克罗地亚语布局）
对于类似克罗地亚语的布局应该也能正常工作。
~/.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 与多媒体键
- Pascal Bleser 写的 使用 xmodmap 映射键盘上缺少的键
- LinuxQuestions上的Xmodmap识别的键符列表