Managing Shortcuts and Groups

Adding Groups

The module allows to you to sort related shortcuts into Groups. For instance, if you have some shortcuts that relate to your music player, you could create a group for them called Music Player.

To add a new group, click on the Edit button below the left pane and select the New Group option.

Adding Shortcuts

To add a new shortcut, click on the Edit button below the left pane and select the New option.

The first menu that appears allows you to select the type of trigger. The following options are available:

Global Shortcut

These are standard keyboard shortcuts that will be recognized anywhere, as long as a KDE Plasma Workspace is running.

Window Action

Window Actions are triggers that occur when something happens to a particular window, like when it appears, gains focus, or is closed.

Mouse Gesture Action

A mouse gesture action is triggered when a particular movement of the mouse (or touchpad or touchscreen) is performed.

Once you've selected the type of trigger, another submenu appears that allows you to select an action type. The following types are available:

Command/URL

This action will launch a command or open a URL when the shortcut is triggered.

D-Bus Command

This action will call a D-Bus method in a running application or system daemon. For more information on D-Bus, see the D-Bus Introduction on KDE TechBase.

Send Keyboard Input

This action will send keyboard input to the currently running application, just as if you had typed it in yourself.

Once you've selected the action type, you can then edit the shortcut to your liking. See the section called “Modifying Shortcuts” for more information.

Deleting Shortcuts and Groups

To delete a shortcut or group, select it, then click on the Edit button below the left pane, and select the Delete option.

Exporting Groups

You can export a group, so you can save the shortcuts contained within and use them on another computer or maintain a backup.

To export a group, select the group to be exported, then click on the Edit button below the left pane and select the Export Group... option, which opens a new window that lets you define some options about the exported group. The following options are available:

Export Actions

This allows you to select the state the shortcuts will be in when they are imported later. Select Actual State to maintain their current state, Enabled to ensure they are all enabled, or Disabled to ensure they are all disabled.

Id

Here you may enter text to identify the group. If the group is included by default, this text may be filled in by default.

Allow Merging

This defines what happens if the group already exists on the system the exported group is imported to. When enabled, any new actions will be added to the group on the target system, while actions that have the same name but a different configuration will updated with the configuration from the imported file. When disabled, the module will refuse to import the file.

Filename

Here you may enter the filename you wish to export the shortcut to. You may also select the Browse button to the right of the text box to open the File dialog and select a file from there.

Tip

Exported files use the extension .khotkeys by default.


The Export Group dialog.

Exporting a group of shortcuts.


Importing Groups

To import a group, click the Edit button below the left pane and select Import.... A file selection dialog opens that permits you to locate a file previously created using the Export function.