# Remap keys without xmodmap or any X tools

Due to a coffee accident some numbers of my laptop's keyboard stopped working. I used xmodmap to use F1, F2, etc, as replacements and saved the configs to ~/.Xmodmap.

However, that caused a few problems.

1. I don't always use X on this computer, and without starting X xmodmap does not apply.

2. It causes X to take more time to start.

3. For some reason it caused XFCE keyboard shortcuts that had nothing to do with any of the keys changed via xmodmap to stop working (in fact, all keyboard shortcuts stopped working, except for the window manager shortcuts). After a few minutes passed since I start X, the XFCE shortcuts start working normally again! This lag isn't very annoying, but is also an issue.

I imagine there is some kind of mapping that is read by the OS before X starts. Isn't there a way to change that mapping? Is it any way to change the keyboard mapping w/o using X tools? Im using Debian stable.

PS: Apparently the file that calls xmodmap .Xmodmap on startx is /etc/xdg/xfce4/xinitrc. It's contents can be found here.

• Have you thought about removing the keyboard and literally washing it? It will take a day to dry out, but is perfectly safe. Also, replacing a laptop keyboard is relatively inexpensive (~$25) compared to the aggravation of re-training your fingers. – jdh Mar 18 '14 at 19:29 • I realize it's been a while since this was asked and the information's likely no longer needed, but on the "no unanswered questions" principle I added an answer below. Hopefully it will be of some use to someone, even if it's not the original asker. – FeRD Jul 25 '14 at 8:55 • If a coffee accident made your keyboard shortcut unresponsive at times, like in OP's question - not working for a short time after X has started - for example, probably it may be that the modifier buttons are electrically closed due to the coffee leftovers under the buttons. This will make the computer think that Ctrl+Alt+S is pressed when you press Ctrl+S for example. Run xev in a terminal and press each key of your keyboard and check whether the KeyUp event is detected. – fz_salam Jul 17 '16 at 9:53 ## 3 Answers ## First, the good news The Linux system console absolutely has its own set of keyboard mappings, which can be managed using the tools from the kbd package, specifically dumpkeys and showkey for discovery and loadkeys to load in a customized mapping. The SuperUser question How to change console keymap in Linux? has an answer with good information on how to use these tools. ## Now, the bad news While it's true that those tools will allow you to remap the keys on the Linux console, without involving xmodmap or requiring that X be running, they will only affect the keymappings on the virtual text console. The changes will have absolutely no effect in the graphical environment, because X's XInput/evdev system reads from the input devices directly and does its own processing. So, if you were hoping to avoid using xmodmap by just remapping on the console and having it apply everywhere, I'm afraid that won't work. In fact, you'd need to remap both the console (using loadkeys) and X11 (using a method like xmodmap), to use the same keyboard layout everywhere. The solution to the xmodmap slowness (and bugginess, since its remappings are glitchy and non-persistent in desktop environments that use layout switching) would be to define an entirely new keyboard layout based off of whatever layout you were previously using, rather than applying runtime modifications. On X startup, you'd load that new, remapped layout instead of whatever you're using now. (It seems this is now the only way to reliably modify the keyboard layout in recent Ubuntus — and possibly other distros — as their xmodmap is no longer useful.) For information on defining and using a custom xkb keyboard layout, see: 1. Howto: Custom keyboard layout definitions in the Ubuntu Community Wiki. 2. How to modify a keyboard layout in Linux, a blog post by Romano Giannetti. Both were written this year (2014), so the information should be current. The Ubuntu wiki information should be applicable to any distro, for the most part, as they all use the xkb system in X. • Wonderful! That was exactly what I was looking for. However, as you mentioned in the comments, it's no longer the case, since I got a new notebook. I cannot test the answer, but since it's exactly what I was looking for I'm pretty sure it'd work, or at least give an alternative to xmodmap. Thanks! – Alex Jul 29 '14 at 4:32 There are actually ways to remap at a level low enough to apply to the whole system, X11 or not, and they've become more important than ever now that we're seeing uptake of Wayland compositors which neglect to expose a UI for libinput's remapping support. You basically need to reconfigure how the kernel's input layer translates raw scancodes into keycodes before they reach the console or the evdev API that X11 and Wayland sit on top of. I'm aware of two ways to do that: 1. Modify the hardware database (hwdb) entry for your keyboard. udev lets you do that by adding rules files to /etc/udev/hwdb.d/ and triggering a database rebuild with systemd-hwdb update, and then forcing it to be applied without a restart via udevadm trigger. This ArchiWiki page has full instructions and explicitly says that it'll work for both X11 and console input. 2. There's a daemon named evdevremapkeys which was specifically written for remapping key events on evdev devices to monkey-patch remapping support into evdev clients which don't support them, like Wayland compositors. It basically uses the same approach as userspace drivers like G15Daemon which need to compensate for non-standard input devices. (Open up the evdev device, swallow any events it intends to remap, so nothing else listening on the device can see them, then emit the corrected events via the uinput API for creating kernel-level input devices from userspace.) • There's actually an ioctl that can be used to set the mappings without need for a demon or hwdb, but for some reason there don't seem to be any standard tools available for this (I had to write my own tool to experiment). – dirkt Jan 25 at 12:13 • That's quite interesting, thanks! I guess the major downside there is, while it may work for both the console and the graphical interface, because the remapping is being done at the hardware level it's completely device-dependent. There are no generic abstractions to leverage, because you're inserting yourself in between the hardware and those abstractions. Even their simple example of remapping the same two keys on a pair of attached keyboards, the keys have completely different identifiers for each of the two devices! – FeRD May 4 at 21:42 • It looks like, while AT keyboard devices are probably pretty universal, USB hardware would have to be targeted and mapped individually. (Meaning, attach a new keyboard, you not only have to add more udev rules to apply remappings to that device, but you potentially have to root around in /usr/lib/udev/hwdb.d/60-keyboard.hwdb to discover exactly what scancode identifiers you need need to use, to specify the keys you wish to remap for that device. – FeRD May 4 at 21:48 Disclaimer: I am the author of this project, I encountered similar issues when moving to Wayland and needing a replacement for xmodmap. I found the alternative methods to be poorly documented and difficult to work with, so I wrote a new alternative. You can use a software suite called Hawck, it uses the lower-level Linux input and keyboard APIs, so is agnostic towards your display server. In your particular case, the solution would be to clone the project from GitHub and run the install.sh script. Unfortunately this requires you to reboot, as the installer will add your user to a new group. Then you will need to start up the Hawck daemons$ sudo systemctl start hawck-inputd
$hawck-macrod Followed by the Hawck UI$ hawck-ui

You can then go to the "Edit Scripts" section and add a script with the following contents:

key "F1" => insert "1"
key "F2" => insert "2"

And enable the script by clicking the toggle button above the editor, you will now be prompted for your password.

To permanently enable this script, go to the settings section of the UI, and click the autostart toggle button.

More documentation can be found in the GitHub README, as well as in the man-pages for hawck-macrod, hawck-inputd, and lsinput

• "Unfortunately this requires you to reboot, as the installer will add your user to a new group." Pffft. That's hardly an excuse to reboot. It's exactly what the newgrp command was created for! 😁 (Or, worst-case — meaning, if the entire desktop session needs to be started after the user is already a member of the new group — maaaaaaybe you have to log out and back in again. But... reboot!? Rebooting is for kernel updates! Only. For. Kernel. Updates! And just until Linux is finally containerized enough to make even those reboots unnecessary. 😉) – FeRD Oct 2 at 14:29
• (And yeah, I saw the note in the README about logging out and in not working on Ubuntu. ¯\_(ツ)_/¯ Shame, really, folks run a perfectly broken OS like that.) – FeRD Oct 2 at 14:34