The Klipper Handbook
Prev |  | Next

# Chapter 3. Configuring Klipper

# 3.1. Viewing Options

To view or change Klipper's settings, bring up the Klipper popup menu, and select Configuration. The Klipper Configuration Dialog will appear. Its contents are described below.

## 3.1.1. General Options

Popup menu at mouse-cursor position

  Make the Klipper popup menus appear at the position of the mouse cursor, instead of their default positions of in the KDE Panel. Useful if you use the mouse more than the keyboard.

Save clipboard contents on Exit

  Makes Klipper keep the contents of the clipboard history on exit, and restore them next time it is run.

Timeout for Action popups

  Set the time that a popup menu will remain for if you do nothing with it.

## 3.1.2. Action Options

Editing Expressions/Actions

  On the Actions tab, click the regular expression or action that you want to edit. A small box will appear in which the text can be edited as you wish. Make sure you press Enter when you are done.

Adding Expressions/Actions

  Click the Add Action button to add a regular expression for Klipper to match. Klipper uses Qt's `QRegExp`, which understands most regular expressions as you would use in grep or egrep for instance.

  | You can find detailed information about the use of `QRegExp` regular expressions at http://doc.trolltech.com/qregexp.html#details. Note that Klipper does not support the wildcard mode mentioned on this page.

  Edit the regular expression as described above. To add a command to execute, right click, select Add Command and edit the command which appears in the tree under the regular expression.

  Note that %s in the command line is replaced with the clipboard contents, e.g. if your command definition is `kedit %s` and your clipboard contents are `/home/phil/textfile`, the command `kedit `/home/phil/textfile`` will be run. To include %s in the command line, escape it with a backslash, as so: `\%s`.

## 3.1.3. Shortcut Options

The shortcuts tab allows you to change the keyboard shortcuts which are used to access Klipper functions. You can change the shortcut to one of three things:

No Key

  The selected action cannot be accessed directly from the keyboard

Default Key

  The selected action uses Klipper's default key. These are the shortcuts referred to in this manual.

Custom Key

  The selected action is assigned to the keys you choose.

  To choose a custom key for the action you have selected, click on the representation of a key in the lower right of the screen to activate it, and type the desired key on your keyboard. Your chosen key may be optionally be combined with one or more of the Shift, Ctrl, or Alt modifier keys, by activating the corresponding option.

Prev | Home | Next
Actions |  | Credits and License