qsrun/README.md

77 rindas
2.0 KiB
Markdown

2019-07-15 23:18:06 +02:00
qsRun
2018-01-03 09:52:05 +01:00
========
2019-07-15 23:18:06 +02:00
qsRun is a launcher. It contains user defined entries for applications and also searches
system-applications. Using libcalculate, it can also be used as a calculator.
2018-01-03 09:52:05 +01:00
If you run a desktop environment like KDE it is questionable whether you will
find this useful, since they usually bring applications that are more or less
2019-07-15 23:18:06 +02:00
comparable to qsRun, although much more
2018-01-03 09:52:05 +01:00
powerful (like KRunner). It can be useful for users running a window manager like
fluxbox etc.
Dependencies
------------
2019-07-15 23:18:06 +02:00
Qt >=5.7.
2018-01-03 09:52:05 +01:00
For the calculation engine, libqalculate is needed.
Currently no conditional compile flags are supported...
Getting started
----------------
Currently it may not be considered a classical GUI application because the
configuration must be done outside of it.
2019-07-15 23:18:06 +02:00
mkdir $HOME/.config/qsRun
2018-01-03 09:52:05 +01:00
In this folder user-defined entries should be put (See "Entry format").
Config format
------------
2019-07-15 23:18:06 +02:00
Path: $HOME/.config/qsRun/qsrunner.config
2018-01-03 09:52:05 +01:00
```
[General]
2019-07-15 23:18:06 +02:00
sysAppsPaths="/usr/share/applications/" TODO: multiple dir example
2018-01-03 09:52:05 +01:00
```
systemApplicationsPath will default to "/usr/share/applications/",
therefore specifying it explicitly is not necessary.
Entry format
------------
It rudimentary supports .desktop files, but for user entries, the own format
should be preferred.
It's a simple format: [key] [value].
Example: quasselclient.qsrun:
```
command quasselclient
name Quassel
icon /usr/share/icons/hicolor/128x128/apps/quassel.png
row 1
col 0
key I
```
"key" means a shortcut key, you can launch those by pressing Ctrl + "key", so in
the example above: CTRL + I.
Simply pressing Ctrl will show you the associated shortcuts on each individual
button.
General usage
2018-01-03 10:16:44 +01:00
-------------
2018-01-03 09:52:05 +01:00
Starting to type will search user defined entries first, followed by system
entries. Then the PATH variable will be searched, if there is a single match you can also
press TAB for auto completion.
In general it will launch anything once you press enter, however it won't open a
terminal.
Calculator
2018-01-03 10:16:44 +01:00
----------
2018-01-03 09:52:05 +01:00
Start by typing "=", followed by your expression, e. g: "=(2+3)^2"