This repository is providing tools to set global keyboard shortcuts in LXQt sessions, that is shortcuts which apply to the LXQt session as a whole and are not limited to distinct applications.

The core components are two binaries lxqt-globalkeysd and lxqt-config-globalkeyshortcuts. lxqt-globalkeysd is running in a daemon-like manner as so-called LXQt Module and doing the actual work. GUI lxqt-config-globalkeyshortcuts is used to customize the shortcut settings.

The only runtime dependencies is liblxqt. Additional build dependencies are CMake and optionally Git to pull latest VCS checkouts.

Code configuration is handled by CMake. CMake variable CMAKE_INSTALL_PREFIX has to be set to /usr on most operating systems, depending on the way library paths are dealt with on 64bit systems variables like CMAKE_INSTALL_LIBDIR may have to be set as well.

To build run make, to install make install which accepts variable DESTDIR as usual.

Official binary packages are provided by all major Linux and BSD distributions. Just use your package manager to search for string lxqt-globalkeys.

Window managers can assign shortcuts as well and their scope may overlap with the one of lxqt-globalkeys in LXQt sessions. This was e. g. affecting elderly configuration files rc.xml of Openbox which were assigning Ctrl+Alt+D to toggling the display of the desktop which lxqt-globalkeys tries to do as well. This resulted in a warning message "Global shortcut C+A+d+ cannot be registered", see lxqt/lxqt#1032. As depicted in this issue lxqt-notificationd will show a warning when conflicts like this come up and users can thus decide whether they want to have the shortcut in question handled by the respective window manager or lxqt-globalkeys.

Daemon-like lxqt-globalkeysd can be adjusted from section "Basic Settings" in configuration dialogue LXQt Session Settings of lxqt-session.

Configuration dialogue "Global Actions Manager" (binary lxqt-config-globalkeyshortcuts) which is used to customize shortcuts can be opened from the panel's main menu - Preferences - LXQt Settings - Shortcut Keys and is provided by the Configuration Center of lxqt-config as well.

Translations can be done in LXQt-Weblate