Krunner

Krunner/Calcfunc

Features
This woefully incomplete list attempts to present some basic examples of KRunner use. Discover more by clicking on the '?' icon inKRunner.

Start and stop applications
You can launch programs by simply typing the name of the application you want to launch. You need to type at least three characters to start finding matches. Matches will be found to applications in your applications menu.

Examples: You can use KRunner to kill applications, too. Type in the keyword kill followed by a process name and KRunner will provide options to close the application (SIGTERM) or forcibly quit it (SIGKILL). KRunner will match partial process names (at least three characters) to running processes.

Note that the keyword kill can be changed in the "Terminate Applications" runner to avoid confusion with the shell command kill which accepts process IDs.

Issue (shell) commands
In addition to applications listed in the applications menu, KRunner can also be used to run shell commands, including launching binaries. Note that when entering shell commands, KRunner will not accept partial commands or offer command auto completion.

Running a command like this brings up a wrench icon which offers additional options. You can choose to spawn a terminal and run the command there (this can be useful if your command produces text output that you want to read), or choose to run the program as a different user (by providing the username and password of that user).

Examples: Incidentally, if the command line is your thing, you may appreciate the built in integration to man pages. Simply type a command name preceded by a # to open the man page formatted for easy readability in your browser.

Examples:

Browse websites
You can simply start typing the URL of a website to open it in your default browser. You may even type in the name of a bookmark from Konqueror and KRunner will open it for you. If you have visited the website in the past, KRunner can fetch you results from your browser's history, too.

Examples: KRunner already knows your web shortcuts in Konqueror, so you can directly start using them.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner also provides options to download files from the web using KGet by providing their URL.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Additional runners exist for fast searching on Wikipedia, Wikitravel and KDE Techbase.

<span class="mw-headline" id="Open_files.2C_folders_and_devices" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Open files, folders and devices
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner can also open files and directories on your local machine for you. If you want to browse remote machines, you can do that, too. Notice how KRunner uses kioslaves for ssh (fish:) and samba (smb:).

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">If you don't know the path to a file, simply type the name of the file. If the file is a recently opened document, KRunner will list it for you. If you have the Nepomuk subsystem installed, you can also search your computer for the file by its indexed contents. KRunnerwill also open folders you've bookmarked in Dolphin (in your Places sidebar) if you type their name in. What's more, if you want to access devices on your system (both mounted and unmounted), you can do that, too. KRunner will even provide device-specific options.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: ===<span class="mw-headline" id="Multitask_with_sessions.2C_windows.2C_desktops_and_activities" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Multitask with sessions, windows, desktops and activities === <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Several KDE applications allow you to save and load sessions. KRunner allows you to launch these sessions. You can either type in the name of the application or directly type in the name of the session. Runners exist for opening sessions saved in Kate, Konqueror,Konsole, etc.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner is a multitasker's dream. If you have too many windows open, just type in the title of the window and switch directly to it. You can similarly type in the name of a virtual desktop and switch directly to it. If you roll with activities, switch activities by typing their name in. KRunner will find a match as soon as you type three characters in.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner will even switch desktop sessions for you. Type in the keyword switch or new session to start a separate X session. You can switch back and forth between sessions by using the switch keyword.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Several plasma widgets can be launched as windowed applications. You can simply type the name of a widget and KRunner will launch a window for you.

<span class="mw-headline" id="Talk_to_people" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Talk to people
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Type in the name of a contact in your KAddressBook to get a list of options to contact them. Typing in an email address into KRunnerwill open a KMail composer window. You can also search through contacts in your Kopete contact list.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">The addressbook and kopete runners don't seem to be working in SC 4.8.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples:

<span class="mw-headline" id="Listen_to_some_music" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Listen to some music
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can control any modern audio player such as Amarok using KRunner. You can use several keywords (all configurable) to play,pause or skip songs. Typing in the name of an artist, album or song that is in Amarok's library will let you either play immediately, play next (queue) or play at the end (append) of the current playlist. You can use keywords to increase or decrease the volume of the player, or even to mute or quit it.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples:

<span class="mw-headline" id="Be_on_time" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Be on time
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can get the current date or time by typing in the keywords date or time. Selecting the result will copy it to your clipboard so you can paste it elsewhere. The format of the date and time respects your system settings.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can even get the date and time at another location by specifying the time zone or the city listed in the TZ database.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">There is a runner for interfacing with Korganizer and fetching events, but it doesn't seem to be working in SC 4.8.

<span class="mw-headline" id="Calculator" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Calculator
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner features a very versatile calculator that can be called by starting or ending a calculation with an = sign. In addition to basic arithmetic, you can call scientific functions like sqrt, sin, log, etc. A list of the supported functions is here. Note that trigonometric functions like sin, cos, etc expect the angle in radians. KRunner understands pi in expressions.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner can also handle symbolic mathematics and perform integration and differentiation on expressions

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can also use KRunner to solve polynomial functions to find its roots.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner intelligently handles units as part of the calculations. Try the following examples to see how.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Since KRunner understands most units, you can use it to convert them very quickly. Note that unit conversions don't require an =sign.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner knows currencies, too. Conversions between currencies is done by fetching the exchange rate from the European Central Bank website.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples:

<span class="mw-headline" id="Go_places" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Go places
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">If you have bookmarked locations in the Marble (in OpenStreetMap), KRunner can open the map directly.

<span class="mw-headline" id="Spell_checking_and_special_characters" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Spell checking and special characters
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner can tell you whether your spelling is correct and/or suggest corrections. The default keyword to start the spellchecker isspell and can be configured.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner can also allow you to pick special characters if you can specify the hexadecimal unicode for the character, preceded by a #sign.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples:

<span class="mw-headline" id="Manage_your_computer" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Manage your computer
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can directly open system settings control modules from KRunner. Often, if you want to change something, just type associated terms and KRunner will find the control module with the settings you want.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples: <p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">KRunner can also be used to adjust the screen brightness by using the keywords "screen brightness". You can specify a percentage or just turn the brightness halfway or fully down. Additionally, keywords exist to suspend, logout, shutdown or restart your machine.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Examples:

<span class="mw-headline" id="Open_KRunner" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Open KRunner
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">The easiest way to open KRunner is to trigger its global shortcut (<span class="keycap" style="font-family:'LiberationSans','BitstreamVeraSans','SansSerif';font-weight:bold;padding:1px4px2px;line-height:14px;white-space:pre-wrap;text-shadow:none;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;color:rgb(0,0,0);">Alt+F2, by default). In some activities (e.g. Desktop), you can simply click on the desktop and start typing. In others (e.g. Search and Launch), KRunner may be built into the activity itself.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can also right-click on your plasma workspace and select <span class="menuchoice" style="font-family:'LiberationSans','BitstreamVeraSans','SansSerif';font-weight:bold;padding:1px4px2px;line-height:14px;white-space:pre-wrap;text-shadow:none;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;color:rgb(0,0,0);">Run Command... or just simply launch it from the commandline by typing krunner.

<span class="mw-headline" id="Use_KRunner" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Use KRunner
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Use <span class="keycap" style="font-family:'LiberationSans','BitstreamVeraSans','SansSerif';font-weight:bold;padding:1px4px2px;line-height:14px;white-space:pre-wrap;text-shadow:none;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;color:rgb(0,0,0);">Tab  or <span class="keycap" style="font-family:'LiberationSans','BitstreamVeraSans','SansSerif';font-weight:bold;padding:1px4px2px;line-height:14px;white-space:pre-wrap;text-shadow:none;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;color:rgb(0,0,0);">Shift+Tab  to navigate up and down results. Use <span class="keycap" style="font-family:'LiberationSans','BitstreamVeraSans','SansSerif';font-weight:bold;padding:1px4px2px;line-height:14px;white-space:pre-wrap;text-shadow:none;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;color:rgb(0,0,0);">arrow keys  to move between options (if any) in a result. Use <span class="keycap" style="font-family:'LiberationSans','BitstreamVeraSans','SansSerif';font-weight:bold;padding:1px4px2px;line-height:14px;white-space:pre-wrap;text-shadow:none;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;color:rgb(0,0,0);">Enter (or left click) to select a result.

<span class="mw-headline" id="Discover_KRunner" style="font-family:'OpenSans',Helvetica,Arial,sans-serif!important;">Discover KRunner
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Click on the wrench icon to bring up configuration options where you can enable/disable/configure runners that will process your searches. Additional options are available to change the position on the screen where krunner appears. You can even change the style to a task-oriented interface, if you like.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Clicking on the waveform icon will open the System Monitor.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">Clicking on the '?' icon opens a scrollable list that explains the syntax of all the available runners. This is a good way to discover new functionality!

Tips, Tricks and FAQs
<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">You can use KRunner in a special "single runner" mode. While in this mode, krunner will only have one active runner to process your searches. This feature isn't supported by all runners, but quite a few already do. Open the global keyboard shortcuts control module directly from krunner and choose the "Run Command Interface" to see what's available. Set a global shortcut for the mode you want and launch krunner in that mode. You can have as many modes as you can find shortcuts for.

<p style="margin-top:0px;margin-bottom:0.8em;font-family:'OpenSans','HelveticaNeue',Helvetica,Arial,sans-serif;line-height:22.3999996185303px;color:rgb(46,52,54);">This blog covers some of the advanced usage of the calculator runner.