KRunner - ArchWiki

Jump to content
From ArchWiki

Related articles

- KDE

This article or section needs language, wiki syntax or style improvements. See Help:Style for reference.

Reason: Need to add permission information. (Discuss in Talk:KRunner)

KRunner is an application built into Plasma 5 to perform functions and run commands quickly, and features a "runner" system to customize functions available for use.

## Installation

Install the krunner package.

## Usage

To open KRunner in Plasma, you can either right-click the desktop and press "run command", or you can use the default keybindings, `Alt+Space` or `Alt+F2`. In some workspaces such as a blank desktop, starting to type will automatically bring up KRunner.

## Open KRunner with the Meta key

To set the Meta key as a shortcut to open KRunner, run

    $ kwriteconfig5 --file kwinrc --group ModifierOnlyShortcuts --key Meta "org.kde.krunner,/App,,toggleDisplay"

To apply the change to the current session, send a specific D-Bus signal to KWin:

    $ qdbus org.kde.KWin /KWin reconfigure

If are not using the D-Bus, then you should restart a KWin instance; run `kwin_x11 --replace` for X11 and `kwin_wayland --replace` for Wayland.

## Switch active windows

The factual accuracy of this article or section is disputed.

Reason: Disabling plugins will also affect search in the application launcher (`Alt+F1`) and the overview mode (`Meta+W`), which is probably not what users want. If there is no way do disable plugins just for KRunner, the xdotool method may still be preferable (but it obviously does not work in Wayland). (Discuss in Talk:KRunner#Possible ideas for expansion)

In Krunner configuration, there is a plug-in configuration button where you can choose needed search source. See the user manual for detail.

If you want to specify krunner search only by active window titles, just enable window plugin and disable the others.

### Full list of windows with search by titles

This approach will require xdotool.

1. Go to System Settings > Workspace > Shortcuts > Custom Shortcuts.
2. Create new Global shortcut -> Command/URL (by right click)
3. Tick the checkbox to the right of the name.
4. In Trigger tab select the desired key combination.
5. In Action tab type `/usr/local/bin/krunner-search-by-windows.sh`
6. Create file `/usr/local/bin/krunner-search-by-windows.sh` with the following content:

       #!/bin/bash
       qdbus org.kde.krunner /App querySingleRunner windows ""
       sleep 0.2
       xdotool key "ctrl+A"
       xdotool type 'window '
       xdotool key "shift+BackSpace"

7. Make file executable and give run permission to all.

Note the space after `window`.

Now you are able to get list of opened windows by specified shortcut and search by this list as you type;

### Search by titles without full windows list

This approach is more limited but far less ugly.

1. Go to System Settings > Workspace > Shortcuts > Custom Shortcuts.
2. Create new Global shortcut -> D-bus Command (by right click)
3. Tick the checkbox to the right of the name
4. In Trigger tab select the desired key combination
5. In Action tab insert the following:

        - Remote application : org.kde.krunner
        - Remote Object      : /App
        - Function           : querySingleRunner
        - Arguments          : windows ""

## See also

- KRunner on KDE UserBase Wiki

Categories:

- Application launchers
- KDE

Hidden categories:

- Pages or sections flagged with Template:Style
- Pages or sections flagged with Template:Accuracy