Simple application launcher
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Albert S. d6ec7a7e1c formating fixes / copyright update... 9 months ago
screenshots added screenshot 2 years ago
.gitignore added .gitignore 10 months ago
LICENCE added licence 2 years ago
README.md improved README 10 months ago
TODO updated TODO 10 months ago
calculationengine.cpp formating fixes / copyright update... 9 months ago
calculationengine.h formating fixes / copyright update... 9 months ago
config.cpp formating fixes / copyright update... 9 months ago
config.h formating fixes / copyright update... 9 months ago
configprovider.cpp formating fixes / copyright update... 9 months ago
configprovider.h reformating (no functional change) 10 months ago
entrypushbutton.cpp formating fixes / copyright update... 9 months ago
entrypushbutton.h formating fixes / copyright update... 9 months ago
main.cpp formating fixes / copyright update... 9 months ago
qsrun.pro rename: qsRun => qsrun 10 months ago
singleinstanceserver.cpp Added basic single instance functionality 1 year ago
singleinstanceserver.h reformating (no functional change) 10 months ago
window.cpp formating fixes / copyright update... 9 months ago
window.h formating fixes / copyright update... 9 months ago

README.md

qsrun

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.

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

Dependencies

Qt >=5.7.

For the calculation engine, libqalculate is needed.

Currently no conditional compile flags are supported...

Building

Assuming the necessary dependencies are installed:

qmake 
make

Getting started

$HOME/.config/qsrun In this folder user-defined entries should be put (See “Entry format”).

Config format

Path: $HOME/.config/qsrun/qsrun.config

Example:

[General]
sysAppsPaths = "/usr/share/applications/", "/var/lib/snapd/desktop/applications/"

sysAppsPaths will default to “/usr/share/applications/” if no value is given.

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”