Simple application launcher for Linux
Go to file
Albert S. a1a9dfb729 Added basic single instance functionality 2019-06-03 07:42:54 +02:00
screenshots added screenshot 2018-01-03 10:16:44 +01:00
BUGS Removed search functionality ( this is covered by qss now). 2018-08-12 17:15:16 +02:00
LICENCE added licence 2018-01-05 15:52:11 +01:00
README.md Removed search functionality ( this is covered by qss now). 2018-08-12 17:15:16 +02:00
calculationengine.cpp added licence 2018-01-05 15:52:11 +01:00
calculationengine.h added licence 2018-01-05 15:52:11 +01:00
config.cpp ConfigReader: support multiple dirs 2019-05-30 10:57:33 +02:00
config.h ConfigReader: support multiple dirs 2019-05-30 10:57:33 +02:00
configprovider.cpp Added ConfigProvider class to allow window to reload config 2019-06-03 07:42:02 +02:00
configprovider.h Added ConfigProvider class to allow window to reload config 2019-06-03 07:42:02 +02:00
entrypushbutton.cpp assign numbers 1-9 as shortcuts for the first 9 results of system applications 2019-06-01 13:38:58 +02:00
entrypushbutton.h assign numbers 1-9 as shortcuts for the first 9 results of system applications 2019-06-01 13:38:58 +02:00
main.cpp Added basic single instance functionality 2019-06-03 07:42:54 +02:00
qsRun.pro Removed search functionality ( this is covered by qss now). 2018-08-12 17:15:16 +02:00
singleinstanceserver.cpp Added basic single instance functionality 2019-06-03 07:42:54 +02:00
singleinstanceserver.h Added basic single instance functionality 2019-06-03 07:42:54 +02:00
window.cpp assign numbers 1-9 as shortcuts for the first 9 results of system applications 2019-06-01 13:38:58 +02:00
window.h Removed search functionality ( this is covered by qss now). 2018-08-12 17:15:16 +02:00

README.md

qsRunner

qsRunner 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.

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 comparable to qsRunner, although much more powerful (like KRunner). It can be useful for users running a window manager like fluxbox etc.

Dependencies

It has been only tested for Qt 5.7.

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.

mkdir $HOME/.config/qsRunner In this folder user-defined entries should be put (See "Entry format").

Config format

Path: $HOME/.config/qsRunner/qsrunner.config

[General]
systemApplicationsPath="/usr/share/applications/"

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

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

Start by typing "=", followed by your expression, e. g: "=(2+3)^2"