Plasma/Krunner: Difference between revisions

From KDE UserBase Wiki
(Some look changes, additional information about web shortcuts, and ready for translation.)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar|Tutorials/Krunner}}
<languages />
<translate>


==Krunner==
==Basic control==<!--T:1-->
Krunner is tool for searching and launching files and applications. It can also be used for more generic operations such as calculator or unit converter. '''On most systems krunner can be activated by pressing the Alt+F2 key combination.'''


===Krunner syntax===
===Krunner syntax=== <!--T:2-->
The '?' icon to the right of the entry field explains the syntax of each of the active Runners.  Scroll to see all the possible keywords and syntaxes that Runners recognise.


===Navigating through results===
<!--T:3-->
The '?' icon to the right of the entry field explains the syntax of each of the active Runners. Scroll to see all the possible keywords and syntaxes that Runners recognise.
 
===Navigating through results=== <!--T:4-->
 
<!--T:5-->
When search brought more than one result, you can use Tab/Tab+Shift and arrow keys to move forward and backward in result list and use Enter to select a result in addition to using mouse.
When search brought more than one result, you can use Tab/Tab+Shift and arrow keys to move forward and backward in result list and use Enter to select a result in addition to using mouse.


==Use cases==
==Use cases== <!--T:6-->
===Using as a calculator===
 
===Using as a calculator=== <!--T:7-->
 
<!--T:8-->
You can use Krunner as a calculator. Just press Alt+F2 and type the expression you want to evaluate such as 32*12= or =32*12. You can put the = sign before or after the expression.
You can use Krunner as a calculator. Just press Alt+F2 and type the expression you want to evaluate such as 32*12= or =32*12. You can put the = sign before or after the expression.


It is possible to evaluate more sophisticated expressions such as:
<!--T:9-->
It is possible to evaluate more sophisticated expressions such as: <code>=sqrt(4) + 32 * sin(60)</code>


=sqrt(4) + 32 * sin(60)
===Using as an application launcher=== <!--T:10-->


===Using as an application launcher===
<!--T:11-->
This you probably already knew, Krunner can also launch applications.  Start Krunner (Alt+F2) and type the name of the application you want to run.
This you probably already knew, Krunner can also launch applications.  Start Krunner (Alt+F2) and type the name of the application you want to run.


===Running BASH commands===
===Running BASH commands=== <!--T:12-->
 
<!--T:13-->
In addition to applications Krunner also recognizes all binaries throughout your system.  You can use this ability to run bash commands such as cp, mv, etc.
In addition to applications Krunner also recognizes all binaries throughout your system.  You can use this ability to run bash commands such as cp, mv, etc.


<!--T:14-->
To do so, start Krunner (Alt+F2) and type the commands just as you would in [[Konsole]]:
To do so, start Krunner (Alt+F2) and type the commands just as you would in [[Konsole]]:


<!--T:15-->
  cp ~/Documents/myFile ~/myFile  (not a useful example but you get the idea)
  cp ~/Documents/myFile ~/myFile  (not a useful example but you get the idea)


===Running Internet commands===
===Launching websites=== <!--T:16-->
Enter a URL - http://www.somewhere.com - and the page will pop up in your browser.
 
<!--T:17-->
Enter a URL - <code>http://www.somewhere.com</code> - and the page will pop up in your browser.
 
===Using web shortcuts=== <!--T:18-->
 
<!--T:19-->
You can also use web shortcuts with KRunner. Example: <code>gg:some-term</code> will bring up Google search results.


Try web shortcuts, too - gg:some-term will bring up Google search results.
<!--T:20-->
In order to use a web shortcut, first make sure it exists and is checked. You can manage them through [[Konqueror]]'s configuration, [[Rekonq]]'s, or try writting <code>Web Shortcuts</code> in KRunner.


===KRunner as a unit converter=== <!--T:21-->


===KRunner as a unit converter===
<!--T:22-->
KRunner can help you convert numbers from one unit to another for area, length, mass, speed and volume in KDE SC 4.2 and currency, energy, pressure and  temperature in KDE SC 4.3. For each category, a default unit is set.
KRunner can help you convert numbers from one unit to another for area, length, mass, speed and volume in KDE SC 4.2 and currency, energy, pressure and  temperature in KDE SC 4.3. For each category, a default unit is set.


''Example'':
<!--T:23-->
<code>
''Example'': <code>6 feet in meters</code> will output 1.8288 m.
6 feet in meters
</code>
will output 1.8288 m


<!--T:24-->
When you don't give the target unit, conversion is done automatically into default unit of the category.  
When you don't give the target unit, conversion is done automatically into default unit of the category.  


''Example'':
<!--T:25-->
<code>
''Example'': <code>10 acres</code> will output 40469 m².
10 acres
</code>
will output 40469 m².


===Controlling Power Management via PowerDevil addon===
===Controlling Power Management via PowerDevil addon=== <!--T:26-->


<!--T:27-->
It is possible to control the various PowerDevil options via Krunner:
It is possible to control the various PowerDevil options via Krunner:


power profile - brings up available profiles
<!--T:28-->
screen brightness - turns off or dims screen
*<code>power profile</code> brings up available profiles.
screen brightness <percent> - sets the brightness percent of the screen
*<code>screen brightness</code> turns off or dims screen.
suspend - brings up suspend options
*<code>screen brightness <percent></code> sets the brightness percent of the screen.
power governor - set the cpu governor
*<code>suspend</code> brings up suspend options.
power scheme - set the power scheme
*<code>power governor</code> sets the cpu governor.
*<code>power scheme</code> sets the power scheme.


<!--T:29-->
[[Category:Tutorials]]
[[Category:Tutorials]]
[[Category:System]]
[[Category:System]]
</translate>

Revision as of 00:18, 12 August 2010

Basic control

Krunner syntax

The '?' icon to the right of the entry field explains the syntax of each of the active Runners. Scroll to see all the possible keywords and syntaxes that Runners recognise.

Navigating through results

When search brought more than one result, you can use Tab/Tab+Shift and arrow keys to move forward and backward in result list and use Enter to select a result in addition to using mouse.

Use cases

Using as a calculator

You can use Krunner as a calculator. Just press Alt+F2 and type the expression you want to evaluate such as 32*12= or =32*12. You can put the = sign before or after the expression.

It is possible to evaluate more sophisticated expressions such as: =sqrt(4) + 32 * sin(60)

Using as an application launcher

This you probably already knew, Krunner can also launch applications. Start Krunner (Alt+F2) and type the name of the application you want to run.

Running BASH commands

In addition to applications Krunner also recognizes all binaries throughout your system. You can use this ability to run bash commands such as cp, mv, etc.

To do so, start Krunner (Alt+F2) and type the commands just as you would in Konsole:

cp ~/Documents/myFile ~/myFile  (not a useful example but you get the idea)

Launching websites

Enter a URL - http://www.somewhere.com - and the page will pop up in your browser.

Using web shortcuts

You can also use web shortcuts with KRunner. Example: gg:some-term will bring up Google search results.

In order to use a web shortcut, first make sure it exists and is checked. You can manage them through Konqueror's configuration, Rekonq's, or try writting Web Shortcuts in KRunner.

KRunner as a unit converter

KRunner can help you convert numbers from one unit to another for area, length, mass, speed and volume in KDE SC 4.2 and currency, energy, pressure and temperature in KDE SC 4.3. For each category, a default unit is set.

Example: 6 feet in meters will output 1.8288 m.

When you don't give the target unit, conversion is done automatically into default unit of the category.

Example: 10 acres will output 40469 m².

Controlling Power Management via PowerDevil addon

It is possible to control the various PowerDevil options via Krunner:

  • power profile brings up available profiles.
  • screen brightness turns off or dims screen.
  • screen brightness <percent> sets the brightness percent of the screen.
  • suspend brings up suspend options.
  • power governor sets the cpu governor.
  • power scheme sets the power scheme.