KBM: Better Keyboard Macros for Linux*

^{*and potentially other operating systems.}

Install on any Linux with Xorg.

npm i -g kbm (may require sudo)
kbm config to setup keyboards
kbm daemon to run the macros

All configuration is in ~/.config/kbm

The Problem

My current/old setup is stupid.

• i3wm handling some key binds.
• sxhkd handling a lot of the other ones.
• akm, a tool i made for basic usage external keyboards.

They all have their own file format for setting them, and you cannot write more than one line, causing this giant list of programs that should go with the macros, not as separate shell scripts in.

The Solution

Make something to solve all the problems, even if it helps no one else.

This program is capable of listening on as many dedicated keyboards for raw events, and running complex commands. It can also hook into X11 and add global keybindings there.

oh also KBM stands for Keyboard Macros.

Basic Feature List

• Same format for external and x11 keybinds
• Any key can be a modifier (external only)
• Key name aliases
• Functions
• Inline bash/node/python scripts
• A VSCode Extension

Config Examples

There are no examples besides the ones I personally use.