zocker-160 / keyboard-center

Application for mapping macro keys on Logitech keyboards
GNU General Public License v3.0
66 stars 3 forks source link
g710 g815 g910 hacktoberfest keyboard linux logitech logitech-gaming logitech-gaming-keyboard

keyboard-center Keyboard Center

DEB builder

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!

showcase

NOTE: This application is written for Linux only, on Windows use whatever bloatware the vendor wants you to use.

Features

[^1]: For more information see this and this and this

Supported Keyboards

Install

Arch / Manjaro

Debian / Ubuntu

NOTE: v2 only works with Ubuntu 24.04 LTS and newer due to Python3.12 dependency

OpenRGB Integration

Step 1: Create Profile(s) in OpenRGB

OpenRGBprofiles

Step 2: Specify Profile in Keyboard Center

OpenRGBkeyboardcenter

note: if you install OpenRGB after Keyboard Center, you will need to restart it.

LUA scripting

The basics of LUA scripting are explained in the LUA template. \ For examples see the examples folder.

Manage Background Service

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

Settings are stored in a settings.json file, which is located at

CLI options

Known issues

Icons on buttons and in the menu not visible

Keyboard 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.

Dependencies

Debian / Ubuntu

Arch / Manjaro

Contribute New Keyboard

overall it should look something like this:

addKeyAnim

ko-fi