Keyboard Center is an application attempting to create an easy way for users to map their macro keys of their >100$ keyboard to useful actions, because Logitech does not give a fuck.
Unlike some other solutions, this application works alongside with RGB software like OpenRGB!
NOTE: This application is written for Linux only, on Windows use whatever bloatware the vendor wants you to use.
[^1]: For more information see this and this and this
.deb
from release pageapt install ./<packagename>.deb
NOTE: v2 only works with Ubuntu 24.04 LTS and newer due to Python3.12 dependency
note: if you install OpenRGB after Keyboard Center, you will need to restart it.
The basics of LUA scripting are explained in the LUA template. \ For examples see the examples folder.
Keyboard Center places itself into the system tray (unless disabled see CLI options).
If you try to open a secondary instance, it ~will~ should reactivate the primary one if minimized or hidden.
Settings are stored in a settings.json
file, which is located at
$XDG_CONFIG_HOME/keyboard-center
or if not defined$HOME/.config/keyboard-center
-v
--version
: prints version (duh)--background-mode
: hides tray icon--dev
: meant for development purposes onlyKeyboard Center relies on icons provided by the desktop environment.
Some DEs (like i3) don't seem to provide those, so in that case you can manually overwrite the used icon theme by setting XDG_SESSION_DESKTOP
and XDG_CURRENT_DESKTOP
ENV variables.
Two known good values are KDE
(recommended) and GNOME
.
Thanks to @scott-carrion for this info.
git
git clone https://github.com/zocker-160/keyboard-center
cd keyboard-center
usbVendor
and usbProduct
in src/newDeviceDebugger.py
is set properly\
(you can check with lsusb
)sudo
if you get permission errorspython3 src/newDeviceDebugger.py
and press all memory keys, macro keys and multimedia keys one after each otherpython3 src/newDeviceDebugger.py --info
CTRL + C
(can take a second or two)overall it should look something like this: