a02c15f03c
* Bumped Standards to 3.9.8, no changes needed * Bumped compat to 10 * Removed --parallel from rules, standard compat 10 * Bumped minimum version debhelper (>= 10) * Bumped minimum version libqtxdg-dev (>= 2.0.0) * Bumped minimum version liblxqt0-dev (>= 0.11.0) * Bumped minimum version liblxqt-globalkeys0-dev (>= 0.11.0), * Bumped minimum version liblxqt-globalkeys-ui0-dev (>= 0.11.0), * Added build dependency libmuparser-dev * Added build dependency libqt5svg5-dev * Added build dependency libqt5xdgiconloader-dev (>= 2.0.0) * Removed build dependency qtscript5-dev * Added Recommends lxqt-runner-l10n * Fixed VCS fields, using https and plain /git/ * Fixed copyrights Format field to https * Fixed copyrights Source field to lxqt-runner * Bumped years in copyrights * Added translation control to rules * Set CMAKE_BUILD_TYPE=RelWithDebInfo * Exported LC_ALL=C.UTF-8, make builds reproducible
35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
# lxqt-runner
|
|
|
|
## Overview
|
|
|
|
lxqt-runner provides a GUI that comes up on the desktop and allows for launching applications or shutting down the system.
|
|
|
|
|
|
|
|
Technically it consists of a single binary `lxqt-runner`. The binary is run in a daemon-like manner as so-called LXQt Module and brings up the GUI when a configured keyboard shortcut is hit.
|
|
|
|
## Installation
|
|
|
|
### Compiling source code
|
|
|
|
Runtime dependencies are muparser, KWindowSystem, menu-cache and [lxqt-globalkeys](https://github.com/lxde/lxqt-globalkeys).
|
|
Additional build dependencies are CMake and optionally Git to pull latest VCS checkouts. The localization files were outsourced to repository [lxqt-l10n](https://github.com/lxde/lxqt-l10n) so the corresponding dependencies are needed, too. Please refer to this repository's `README.md` for further information.
|
|
|
|
Code configuration is handled by CMake. CMake variable `CMAKE_INSTALL_PREFIX` has to be set to `/usr` on most operating systems.
|
|
|
|
To build run `make`, to install `make install` which accepts variable `DESTDIR` as usual.
|
|
|
|
### Binary packages
|
|
|
|
Official binary packages are provided by all major Linux distributions like Arch Linux, Debian (as of Debian stretch only), Fedora and openSUSE. Just use your package manager to search for string `lxqt-runner`.
|
|
|
|
## Configuration, Usage
|
|
|
|
Launching binary `lxqt-runner` as LXQt Module can be adjusted from section "Basic Settings" in configuration dialogue "LXQt Session Settings" (binary `lxqt-config-session`) of [lxqt-session](https://github.com/lxde/lxqt-session).
|
|
|
|
The keyboard shortcut to launch the GUI can be configured in "Global Actions Manager" (binary `lxqt-config-globalkeyshortcuts`) of [lxqt-globalkeys](https://github.com/lxde/lxqt-globalkeys).
|
|
|
|
The GUI comes with a configuration dialogue to customize settings like the position where it's displayed. It's accessible from a menu that's in turn opened by an icon left of the one to close the GUI, "arrow down" in screenshot above.
|
|
|
|
To launch an application corresponding strings need to be filed in the form, next a selection can be made from a list presenting matches. Items to shut down or restart the system and so on are provided by the menu featuring the configuration dialogue as well.
|