https://github.com/lxqt/lxqt-policykit

The LXQt PolicyKit agent
https://github.com/lxqt/lxqt-policykit

Last synced: 4 days ago
JSON representation

The LXQt PolicyKit agent

• Host: GitHub
• URL: https://github.com/lxqt/lxqt-policykit
• Owner: lxqt
• License: lgpl-2.1
• Created: 2013-08-06T10:47:36.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-10-14T23:21:58.000Z (2 months ago)
• Last Synced: 2024-10-29T10:08:01.506Z (2 months ago)
• Language: C++
• Homepage: https://lxqt.github.io
• Size: 265 KB
• Stars: 31
• Watchers: 22
• Forks: 21
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

README

        
# lxqt-policykit

## Overview

lxqt-policykit is the polkit authentification agent of LXQt.

[polkit](https://www.freedesktop.org/wiki/Software/polkit/) is a software framework

to handle privileges of processes.

In LXQt it is e. g. used to extend the privileges of the GUI tools of

[lxqt-admin](https://github.com/lxqt/lxqt-admin/). These are launched by a regular

user. But in order to apply the settings they deal with root privileges are needed

and acquired via polkit.

Among the various components of polkit the authentication agent is the one to

query the user for credentials by dialogue windows like this one of lxqt-policykit.

![lxqt-policykit: GUI](lxqt-policykit_gui.png)

While there's only a single implementation of all other polkit components various

different authentication agents are provided by the various desktop environments.

Basically these can be used interchangeably, that is lxqt-policykit can be used

in an LXDE session or lxpolkit, the authentication agent of LXDE, can be used in

an Xfce session. Most of the time it's better to use the implementation provided

by a distinct desktop environment as it integrates better, though.

Technically, lxqt-policykit is just a single binary `lxqt-policykit-agent` which

is running as [LXQt Module](https://github.com/lxqt/lxqt-session#lxqt-modules)

and launching the GUI on demand.

Note that the naming lxqt-policykit is strictly speaking an anachronism. It refers

to Policykit which was the predecessor of polkit. The name wasn't changed when

Policykit was replaced by polkit as both provide roughly the same features albeit

they are technically different.

## Installing

### Compiling sources

Runtime dependencies are polkit-qt5 and [liblxqt](https://github.com/lxqt/liblxqt).

Additional build dependencies are CMake and optionally Git to pull latest VCS

checkouts.

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

#### Arch Linux

The latest release is provided by package `lxqt-policykit` in repository community,

the actual master checkout can be compiled by packages `lxqt-policykit-git` from

the [AUR](https://aur.archlinux.org).

#### Debian

Package `lxqt-policykit` is available in the official repositories as of Debian

buster.

#### Fedora

Package `lxqt-policykit` is available as of Fedora 22.

#### openSUSE

Package `lxqt-policykit` is providing the binary, `lxqt-policykit-lang` the

translations. Both are available as of openSUSE Leap 42.1.

## Configuration, Usage

Like all LXQt Modules `lxqt-policykit-agent` can be adjusted from section

"Basic Settings" in configuration dialogue

[LXQt Session Settings](https://github.com/lxqt/lxqt-session#lxqt-session-settings)

of [lxqt-session](https://github.com/lxqt/lxqt-session).

From a user's point of view the usage is limited to interacting with the GUI as

seen above.

### Translations

Translations can be done in [LXQt-Weblate](https://translate.lxqt-project.org/projects/lxqt-configuration/lxqt-policykit/).