Plasma/Krunner/es: Difference between revisions

From KDE Wiki Sandbox
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(41 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages />
<languages />


'''KRunner''' is the launcher built into the Plasma desktop. While its basic function is to launch programs from a sort of mini-command-line, its functionality can be extended by "runners" to assist the user to accomplish a lot of tasks.
<div class="mw-translate-fuzzy">
'''KRunner''' es un lanzador construido sobre el escritorio Plasma. Si bien su función básica es lanzar programas desde una especie de línea de comandos, sus funcionalidades pueden ser extendida por los llamados "runners" que ayudan al usuario a lograr hacer una gran cantidad de tareas.
</div>
 
{{Note|1=You may need to install additional '''KRunner''' addons package depending on your distribution to use some of the functionalities listed here. Note that a large number of active addons may slow down the start of KRunner, adjust this by clicking the "settings" icon to the left of the text entry field.}}


[[Image:KRunner.png||center]]
[[Image:KRunner.png||center]]


==Features==
==Características==


This woefully incomplete list attempts to present some basic examples of '''KRunner''' use. Discover more by clicking on the '?' icon in '''KRunner'''.
Lamentablemente esta lista está incompleta y solo se presentan algunos ejemplos básicos del uso de '''KRunner'''. Descubre mas haciendo click en el icono '?' en '''KRunner'''.


===Start and stop applications===
===Iniciar y terminar aplicaciones===


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.
(builtin plugin: Applications)


Examples:
<div class="mw-translate-fuzzy">
Puedes iniciar programas escribiendo simplemente el nombre de la aplicación que quieras abrir. Necesitas escribir como mínimo tres caractéres para empezar a buscar coincidencias. Las coincidencias serán encontradas en tu menú de aplicaciones.
</div>
 
You may type a single character and KRunner will start finding matches. Matches will be found to applications from your easily customizable applications menu (for that, right-click in menu).
 
Ejemplos:
{|class="tablecenter" style="border: 1px solid grey"
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
| Entrada || Salida
|-
|-
| <code> gwe </code> || ''(starts [[Special:myLanguage/Gwenview|Gwenview]])''
| <code> gwe </code> || ''(starts [[Special:myLanguage/Gwenview|Gwenview]])''
|}
|}


You can use '''KRunner''' to kill applications, too. Type in the keyword <code>kill</code> 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.
[[Image:KRunner_app.png||center]]
 
<div class="mw-translate-fuzzy">
Puedes usar '''KRunner''' para matar aplicaciones también. Escribe en el teclado <code>kill</code> seguido del nombre del proceso y '''KRunner''' mostrará varias opciones para cerrar la aplicación (SIGTERM) o matarla forzosamente (SIGKILL). '''KRunner''' buscará nombres de procesos parciales (a partir de tres caracteres) para ejecutar los procesos.
</div>


Note that the keyword <code>kill</code> can be changed in the "Terminate Applications" runner to avoid confusion with the shell command kill which accepts process IDs.
Nota que el comando <code>kill</code> puede ser cambiado en el runner "Terminar aplicaciones" para avoler la confusión del comando kill el cual acepta las ID de los procesos.


===Issue (shell) commands===
===Direct installation===


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.
(builtin plugin: Software Center)


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).
In case that you look for an application that has not been installed yet, KRunner will suggest a set of applications that match your search. In specific, since KRunner has been integrated with Plasma Software Center, [[Special:myLanguage/Discover | Discover]], will present you a list of applications, enabling you to proceed to direct installation.


Examples:
===Problemas de los comandos===
 
(builtin plugin: Command Line)
 
Además para los programas listados en el menú de las aplicaciones, '''KRunner''' puede se usado para ejecutar comandos de la consola, incluyendo lanzadores binarios. Observa que cuando introduces un comando, '''KRunner''' no acepta comandos parciales u ofrece un autocompletado de los comandos.
 
En la ejecución de un comando aparece un icono de llave inglesa que permite elegir opciones adicionales. Puedes optar por ejecutar el comando en una ventana de terminal e iniciarlo allí (eso puede ser útil si el comando produce una salida de texto que usted desea leer), o ejecutar el programa como un usuario diferente (introduciendo el nombre de usuario y la contraseña de este usario).
 
Ejemplos:
{|class="tablecenter" style="border: 1px solid grey"
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
| Entrada || Salida
|-
|-
|<code> ls ~/Documents </code> || ''lists contents of ~/Documents (preferably in a terminal)''
|<code> ls ~/Documentos </code> || ''lista de contenidos de ~/Documentos (preferentemente un terminal)''
|-
|-
|<code> cp ~/Documents/myFile ~/myFile </code> || ''copies myFile from ~/Documents to ~/''
|<code> cp ~/Documentos/miArchivo ~/miArchivo </code> || ''copia miArchivo desde ~/Documentos a ~/''
|-
|-
|<code> mplayer myMovie.mkv </code> || ''plays myMovie.mkv in mplayer''
|<code> mplayer miVídeo.mkv </code> || ''reproduce miVídeo.mkv en mplayer''
|}
|}


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 <code>#</code> to open the man page formatted for easy readability in your browser.
<div class="mw-translate-fuzzy">
De paso, si la línea de comandos es lo tuyo, podrías apreciar la integración con las páginas de ayuda (man). Simplemente escribe un comando precedido por <code>#</code> para abrir la página de ayuda en formato web para una fácil lectura desde tu navegador.
</div>


Examples:
<div class="mw-translate-fuzzy">
Ejemplos:
{|class="tablecenter" style="border: 1px solid grey"
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
| Entrada || Salida
|-
|-
|<code> #ls </code> || ''opens the manual for ls in a browser''
|<code> #ls </code> || ''abre el manual para ls en un navegador''
|}
|}
</div>


===Browse websites===
===Buscar páginas web===


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 [[Special:myLanguage/Konqueror|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.
(builtin plugins: Bookmarks, Locations, Web Search Keywords)


Examples:
<div class="mw-translate-fuzzy">
Usted puede simplemente comenzar escribiendo la URL del sitio web que desea abrir en su navegador predeterminado. Puede incluso escribir el nombre de un marcador de [[Special:myLanguage/Konqueror|Konqueror]] y '''KRunner''' lo abrirá para ti. Si has visitado una página web en el pasado, '''KRunner''' también puede buscar los resultados desde el historial de tu navegador.
</div>
 
Ejemplos:
{|class="tablecenter" style="border: 1px solid grey"
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
| Entrada || Salida
|-
|-
|<code> myBookmark </code> || ''opens the bookmark in a browser''
|<code> miMarcador </code> || ''abre el marcador en un navegador''
|-
|-
|<code> kde.org </code> || ''opens the [http://www.kde.org KDE homepage] in a browser''
|<code> kde.org </code> || ''abre [http://www.kde.org la página de inicio de KDE] en un navegador''
|-
|-
|<code> http://userbase.kde.org/ </code> || ''opens [http://userbase.kde.org/ Userbase] in a browser''
|<code> http://userbase.kde.org/ </code> || ''abre [http://userbase.kde.org/ Userbase] en un navegador''
|}
|}


'''KRunner''' already knows your web shortcuts in [[Special:myLanguage/Konqueror|Konqueror]], so you can directly start using them.
<div class="mw-translate-fuzzy">
'''KRunner''' conoce los atajos de teclado de [[Special:myLanguage/Konqueror|Konqueror]], por lo que puedes utilizarlos directamente.
</div>


Examples:
Ejemplos:
{|class="tablecenter" style="border: 1px solid grey"
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
| Entrada || Salida
|-
|-
|<code> gg:KDE </code> || ''searches Google for KDE''
|<code> gg:KDE </code> || ''busca en Google KDE''
|-
|-
|<code> wp:krunner </code> || ''searches Wikipedia for krunner''
|<code> wp:krunner </code> || ''busca en Wikipedia krunner''
|}
|}


'''KRunner''' also provides options to download files from the web using [[Special:myLanguage/KGet|KGet]] by providing their URL.
'''KRunner''' además ofrece opciones para descargar archivos desde una web utilizando [[Special:myLanguage/KGet|KGet]] escribiendo la URL.


Additional runners exist for fast searching on Wikipedia, Wikitravel and KDE Techbase.
Existen runners adicionales para una búsqueda rápida en Wikipedia, Wikitravel y KDE Techbase.


===Open files, folders and devices===
===Abrir archivos, carpetas y dispositivos===


'''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:).
(builtin plugin: Locations)


Examples:
'''KRunner''' puede además abrir archivos y directorias en tu equipo local. Si desea buscar equipos remotos, puedes hacerlo también. Prestad atención como '''KRunner''' usa kioslaves para ssh (fish:) y samba (smb:).
 
Ejemplos:
{|class="tablecenter" style="border: 1px solid grey"
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
| Entrada || Salida
|-
|-
|<code> file:/home/ </code> || ''opens file:///home/ (the Home directory) in [[Special:myLanguage/Dolphin|Dolphin]]''
|<code> file:/home/ </code> || ''opens file:///home/ (el directorio Home) en [[Special:myLanguage/Dolphin|Dolphin]]''
|-
|-
|<code> file:myMovie.mkv </code> || ''opens /home/myMovie.mkv''
|<code> file:miVídeo.mkv </code> || ''abre /home/miVídeo.mkv''
|-
|-
|<code> fish:you@server.com </code> || ''opens fish:/you@server.com/ via fish (file over ssh) protocol''
|<code> fish:you@server.com </code> || ''abre fish:/you@server.com/ vía fish (archivo sobre protocolo ssh)''
|-
|-
|<code> smb:myWindowsBox </code> || ''opens smb:/myWindowsBox via Samba''
|<code> smb:miCarpetadeWindows </code> || ''abre smb:/miCarpetadeWindows vía Samba''
|}
|}


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 [[Special:myLanguage/Nepomuk|Nepomuk]] subsystem installed, you can also search your computer for the file by its indexed contents. '''KRunner''' will also open folders you've bookmarked in [[Special:myLanguage/Dolphin|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.
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 enabled "File Search" provided by [https://community.kde.org/Baloo Baloo] daemon, you can also search your computer for the file by its indexed contents. '''KRunner''' will also open folders you've bookmarked in [[Special:myLanguage/Dolphin|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.


Examples:
Examples:
Line 125: Line 159:
|-
|-
|<code> switch </code> || ''shows options to switch to an existing session or start a new one''
|<code> switch </code> || ''shows options to switch to an existing session or start a new one''
|-
|<code> new session </code> || ''starts a new session''
|}
|}


Line 146: Line 182:
===Listen to some music===
===Listen to some music===


You can control any modern audio player such as [[Special:myLanguage/Amarok|Amarok]] using krunner. You can use several keywords (all configurable) to <code>play</code>, <code>pause</code> or skip songs. Typing in the name of an artist, album or song that is in [[Special:myLanguage/Amarok|Amarok]]'s library will let you either play immediately, play next (<code>queue</code>) or play at the end (<code>append</code>) of the current playlist. You can use keywords to <code>increase</code> or <code>decrease<code> the volume of the player, or even to <code>mute</code> or <code>quit</code> it.
You can control any modern audio player such as [[Special:myLanguage/Amarok|Amarok]] using '''KRunner'''. You can use several keywords (all configurable) to <code>play</code>, <code>pause</code> or skip songs. Typing in the name of an artist, album or song that is in [[Special:myLanguage/Amarok|Amarok]]'s library will let you either play immediately, play next (<code>queue</code>) or play at the end (<code>append</code>) of the current playlist. You can use keywords to <code>increase</code> or <code>decrease</code> the volume of the player, or even to <code>mute</code> or <code>quit</code> it.


Examples:
Examples:
Line 171: Line 207:
|<code> time </code> || The current time is ...
|<code> time </code> || The current time is ...
|}
|}
[[Image:KRunner_time.png||center]]


You can even get the date and time at another location by specifying the time zone or the city listed in the TZ database.
You can even get the date and time at another location by specifying the time zone or the city listed in the TZ database.
Line 189: Line 227:
===Calculator===
===Calculator===


'''KRunner''' features a very versatile calculator that can be called by starting or ending a calculation with an <code>=</code> sign. In addition to basic arithmetic, you can call scientific functions like <code>sqrt()</code>, <code>sin()</code>, <code>log()</code>, etc. A list of the supported functions is [http://qalculate.sourceforge.net/gtk-manual/apa.html here]. Note that trigonometric functions like <code>sin()</code>, <code>cos()</code>, etc expect the angle in radians. '''KRunner''' understands <code>pi</code> in expressions.
'''KRunner''' features a very versatile calculator that can be called by starting or ending a calculation with an <code>=</code> sign. In addition to basic arithmetic, you can call scientific functions like <code>sqrt()</code>, <code>sin()</code>, <code>log()</code>, etc. A list of the supported functions is [http://qalculate.github.io/manual/qalculate-definitions-functions.html here]. Note that trigonometric functions like <code>sin()</code>, <code>cos()</code>, etc expect the angle in radians. '''KRunner''' understands <code>pi</code> in expressions.


Examples:
Examples:
Line 198: Line 236:
|-
|-
|<code> = sqrt(4) + 32*sin(30*pi/180) </code> || 18
|<code> = sqrt(4) + 32*sin(30*pi/180) </code> || 18
|}
[[Image:KRunner_calc.png||center]]
'''KRunner''' also supports combinatorics functions, like <code>perm()</code> or <code>comb()</code>.
Examples:
{|class="tablecenter" style="border: 1px solid grey"
| Input || Output
|-
|<code> = perm(10,5) </code> || 30240
|-
|<code> = comb(10,5) </code> || 252
|}
|}


Line 217: Line 268:
| Input || Output
| Input || Output
|-
|-
|<code> = solve( x^2 + 4*x - 21 = 0 ) </code>|| [7, -3]  
|<code> = solve( x^2 + 4*x - 21 = 0 ) </code>|| [3, -7]  
|}
|}


Line 309: Line 360:
|-
|-
|<code> lock </code> || ''locks the screen''
|<code> lock </code> || ''locks the screen''
|-
|<code> restart </code> || ''restarts computer''
|-
|<code> shutdown </code> || ''shutdowns computer''
|}
|}


Line 315: Line 370:
===Open KRunner===
===Open KRunner===


The easiest way to open '''KRunner''' is to trigger its global shortcut (<keycap>Alt+F2</keycap>, 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.
The easiest way to open '''KRunner''' is to trigger its global shortcut (<keycap>Alt+Space</keycap> or <keycap>Alt+F2</keycap>, 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.


You can also right-click on your plasma workspace and select <menuchoice>Run Command...</menuchoice> or just simply launch it from the commandline by typing <code>krunner</code>.
You can also right-click on your plasma workspace and select <menuchoice>Run Command...</menuchoice> or just simply launch it from the commandline by typing <code>krunner</code>.
Line 321: Line 376:
===Use KRunner===
===Use KRunner===


Use <keycap>Tab</keycap> or <keycap>Shift+Tab</keycap> to navigate up and down results. Use <keycap>arrow keys</keycap> to move between options (if any) in a result. Use <keycap>Enter</keycap> (or left click) to select a result.
Use <keycap>Tab</keycap>/<keycap>Ctrl+j</keycap> or <keycap>Shift+Tab</keycap>/<keycap>Ctrl+k</keycap> to navigate up and down results. Use <keycap>arrow keys</keycap> to move between options (if any) in a result. Use <keycap>Enter</keycap> (or left click) to select a result.


===Discover KRunner===
===Discover KRunner===


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.
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.
Clicking on the waveform icon will open the System Monitor.


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!
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!
 
<span id="Tips, Tricks and FAQs"></span>
==Tips, Tricks and FAQs==
==Tips, Tricks and FAQs==


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. {{Smiley}}
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. {{Smiley}}


This [http://sciencekde.wordpress.com/2010/12/07/advanced-calculator-runner/ blog] covers some of the advanced usage of the calculator runner.
This [https://sciencekde.wordpress.com/2010/12/07/advanced-calculator-runner/ blog] covers some of the advanced usage of the calculator runner.




[[Category:Tutorials]]
[[Category:Tutoriales/es]]
[[Category:System]]
[[Category:Sistema/es ]]

Latest revision as of 23:05, 23 September 2022

Other languages:

KRunner es un lanzador construido sobre el escritorio Plasma. Si bien su función básica es lanzar programas desde una especie de línea de comandos, sus funcionalidades pueden ser extendida por los llamados "runners" que ayudan al usuario a lograr hacer una gran cantidad de tareas.

Note
You may need to install additional KRunner addons package depending on your distribution to use some of the functionalities listed here. Note that a large number of active addons may slow down the start of KRunner, adjust this by clicking the "settings" icon to the left of the text entry field.


Características

Lamentablemente esta lista está incompleta y solo se presentan algunos ejemplos básicos del uso de KRunner. Descubre mas haciendo click en el icono '?' en KRunner.

Iniciar y terminar aplicaciones

(builtin plugin: Applications)

Puedes iniciar programas escribiendo simplemente el nombre de la aplicación que quieras abrir. Necesitas escribir como mínimo tres caractéres para empezar a buscar coincidencias. Las coincidencias serán encontradas en tu menú de aplicaciones.

You may type a single character and KRunner will start finding matches. Matches will be found to applications from your easily customizable applications menu (for that, right-click in menu).

Ejemplos:

Entrada Salida
gwe (starts Gwenview)

Puedes usar KRunner para matar aplicaciones también. Escribe en el teclado kill seguido del nombre del proceso y KRunner mostrará varias opciones para cerrar la aplicación (SIGTERM) o matarla forzosamente (SIGKILL). KRunner buscará nombres de procesos parciales (a partir de tres caracteres) para ejecutar los procesos.

Nota que el comando kill puede ser cambiado en el runner "Terminar aplicaciones" para avoler la confusión del comando kill el cual acepta las ID de los procesos.

Direct installation

(builtin plugin: Software Center)

In case that you look for an application that has not been installed yet, KRunner will suggest a set of applications that match your search. In specific, since KRunner has been integrated with Plasma Software Center, Discover, will present you a list of applications, enabling you to proceed to direct installation.

Problemas de los comandos

(builtin plugin: Command Line)

Además para los programas listados en el menú de las aplicaciones, KRunner puede se usado para ejecutar comandos de la consola, incluyendo lanzadores binarios. Observa que cuando introduces un comando, KRunner no acepta comandos parciales u ofrece un autocompletado de los comandos.

En la ejecución de un comando aparece un icono de llave inglesa que permite elegir opciones adicionales. Puedes optar por ejecutar el comando en una ventana de terminal e iniciarlo allí (eso puede ser útil si el comando produce una salida de texto que usted desea leer), o ejecutar el programa como un usuario diferente (introduciendo el nombre de usuario y la contraseña de este usario).

Ejemplos:

Entrada Salida
ls ~/Documentos lista de contenidos de ~/Documentos (preferentemente un terminal)
cp ~/Documentos/miArchivo ~/miArchivo copia miArchivo desde ~/Documentos a ~/
mplayer miVídeo.mkv reproduce miVídeo.mkv en mplayer

De paso, si la línea de comandos es lo tuyo, podrías apreciar la integración con las páginas de ayuda (man). Simplemente escribe un comando precedido por # para abrir la página de ayuda en formato web para una fácil lectura desde tu navegador.

Ejemplos:

Entrada Salida
#ls abre el manual para ls en un navegador

Buscar páginas web

(builtin plugins: Bookmarks, Locations, Web Search Keywords)

Usted puede simplemente comenzar escribiendo la URL del sitio web que desea abrir en su navegador predeterminado. Puede incluso escribir el nombre de un marcador de Konqueror y KRunner lo abrirá para ti. Si has visitado una página web en el pasado, KRunner también puede buscar los resultados desde el historial de tu navegador.

Ejemplos:

Entrada Salida
miMarcador abre el marcador en un navegador
kde.org abre la página de inicio de KDE en un navegador
http://userbase.kde.org/ abre Userbase en un navegador

KRunner conoce los atajos de teclado de Konqueror, por lo que puedes utilizarlos directamente.

Ejemplos:

Entrada Salida
gg:KDE busca en Google KDE
wp:krunner busca en Wikipedia krunner

KRunner además ofrece opciones para descargar archivos desde una web utilizando KGet escribiendo la URL.

Existen runners adicionales para una búsqueda rápida en Wikipedia, Wikitravel y KDE Techbase.

Abrir archivos, carpetas y dispositivos

(builtin plugin: Locations)

KRunner puede además abrir archivos y directorias en tu equipo local. Si desea buscar equipos remotos, puedes hacerlo también. Prestad atención como KRunner usa kioslaves para ssh (fish:) y samba (smb:).

Ejemplos:

Entrada Salida
file:/home/ opens file:///home/ (el directorio Home) en Dolphin
file:miVídeo.mkv abre /home/miVídeo.mkv
fish:you@server.com abre fish:/you@server.com/ vía fish (archivo sobre protocolo ssh)
smb:miCarpetadeWindows abre smb:/miCarpetadeWindows vía Samba

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 enabled "File Search" provided by Baloo daemon, you can also search your computer for the file by its indexed contents. KRunner will 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.

Examples:

Input Output
Home opens the Home directory in Dolphin
myFlashDrive shows options to mount or open the contents of myFlashDrive

Multitask with sessions, windows, desktops and activities

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.

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.

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.

Examples:

Input Output
Desktop 1 switches the virtual desktop to Desktop 1
myWorkActivity switches the activity to myWorkActivity
switch shows options to switch to an existing session or start a new one
new session starts a new session

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.

Talk to people

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 KRunner will open a KMail composer window. You can also search through contacts in your Kopete contact list.

The addressbook and kopete runners don't seem to be working in SC 4.8.

Examples:

Input Output
kde@mail.kde.org compose a mail to the KDE mailing list
myContact show options to contact myContact

Listen to some music

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.

Examples:

Input Output
play song search plays a song immediately
pause pauses Amarok or your designated music player
next plays next song in playlist

Be on time

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.

Examples:

Input Output
date Today's date is ...
time The current time is ...

You can even get the date and time at another location by specifying the time zone or the city listed in the TZ database.

Examples:

Input Output
time UTC The current time in UTC is ...
time oslo The current time in Europe/Oslo is ...
time kolkata The current time in Asia/Kolkata is ...

There is a runner for interfacing with Korganizer and fetching events, but it doesn't seem to be working in SC 4.8.

Calculator

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.

Examples:

Input Output
32*12 = 384
= sqrt(4) + 32*sin(30*pi/180) 18

KRunner also supports combinatorics functions, like perm() or comb().

Examples:

Input Output
= perm(10,5) 30240
= comb(10,5) 252

KRunner can also handle symbolic mathematics and perform integration and differentiation on expressions

Examples:

Input Output
= integrate( -x/y^2, y ) -x/y
diff( log(x) ) = 1/x

You can also use KRunner to solve polynomial functions to find its roots.

Examples:

Input Output
= solve( x^2 + 4*x - 21 = 0 ) [3, -7]

KRunner intelligently handles units as part of the calculations. Try the following examples to see how.

Examples:

Input Output
= 2.5 kg * 10 m/s^2 25 N
220 V / 10 A = 22 ohms

Since KRunner understands most units, you can use it to convert them very quickly. Note that unit conversions don't require an = sign.

Examples:

Input Output
30 F -1.11111 degrees C (°C), 273.039 K, ...
27.8 km 1.09449e+06 inches (in), 17.2742 miles (mi), ...
5 gallons in liters 18.9271 liters (l)

KRunner knows currencies, too. Conversions between currencies is done by fetching the exchange rate from the European Central Bank website.

Examples:

Input Output
1 dollar 0.657002 pounds sterling (GBP), 0.742501 euros (EUR), ...
125 euros 110.606 pounds sterling (GBP), 15,785 yen (JPY), ...
30 JPY in RUB 9.40731 rubles (RUB)

Go places

If you have bookmarked locations in the Marble (in OpenStreetMap), KRunner can open the map directly.

Spell checking and special characters

KRunner can tell you whether your spelling is correct and/or suggest corrections. The default keyword to start the spellchecker is spell and can be configured.

Examples:

Input Output
spell linux Suggested words: Linux, lynx, ...

KRunner can also allow you to pick special characters if you can specify the hexadecimal unicode for the character, preceded by a # sign.

Examples:

Input Output
#03b2 β
#00b1 ±

Manage your computer

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.

Examples:

Input Output
keyboard opens the Keyboard settings control module
fonts opens the fonts settings control module
password opens the Password & User account control module

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.

Examples:

Input Output
screen brightness 100 increases screen brightness to 100%
sleep suspends computer to RAM
lock locks the screen
restart restarts computer
shutdown shutdowns computer

Usage

Open KRunner

The easiest way to open KRunner is to trigger its global shortcut (Alt+Space or 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.

You can also right-click on your plasma workspace and select Run Command... or just simply launch it from the commandline by typing krunner.

Use KRunner

Use Tab/Ctrl+j or Shift+Tab/Ctrl+k to navigate up and down results. Use arrow keys to move between options (if any) in a result. Use Enter (or left click) to select a result.

Discover KRunner

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.

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

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.

This blog covers some of the advanced usage of the calculator runner.

Retrieved from "https://wikisandbox.kde.org/index.php?title=Plasma/Krunner/es&oldid=472029"