File: README.md

package info (click to toggle)
lxqt-admin 2.1.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 1,448 kB
  • sloc: cpp: 1,787; sh: 158; makefile: 10
file content (83 lines) | stat: -rw-r--r-- 3,314 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# lxqt-admin

## Overview

This repository provides two GUI tools to adjust settings of the operating system LXQt
is running on.

Both are using [polkit](https://www.freedesktop.org/wiki/Software/polkit/) to handle
permissions. In contrast to the specific backends described below, earlier versions of
lxqt-admin were relying on
[system-tools-backends](http://system-tools-backends.freedesktop.org) and their wrapper
[liboobs](https://developer.gnome.org/liboobs/). These were replaced, as both have gone
unmaintained for years and were hence dropped from many distributions - heavily
restricting the usage of lxqt-admin. As long as they can be built, it should still be
possible to compile lxqt-admin release ≤ 0.10 against them in order to make use of it on
platforms lacking systemd (like BSD).

### Time and date configuration

Adjusts the time and date. Binary is `lxqt-admin-time`.

![lxqt-admin-time](lxqt-admin-time.png)

It is using `systemd-timedated` as its backend, which is accessed by its D-Bus interface.
As such, this means the option to sync the system time by NTP is relying on
`systemd-timesyncd` as a backend.

### User and Group Settings

Management of users and groups. Binary is `lxqt-admin-user`.

![lxqt-admin-user](lxqt-admin-user.png)

The backend is a script, `lxqt-admin-user-helper`. As such, it is using the shadow tools
to do the actual work. However, the script can still be modified to use different tools.

## Installing

### Compiling sources

Runtime dependencies consist of polkit and [liblxqt](https://github.com/lxqt/liblxqt).
A polkit agent should be available with
[lxqt-policykit](https://github.com/lxqt/lxqt-policykit/), representing the first choice
in LXQt. Additional build dependencies are CMake and optionally Git, to pull the latest
VCS checkouts.

Code configuration is handled by CMake. CMake variable `CMAKE_INSTALL_PREFIX` will
normally have to be set to `/usr`.

To build, run `make`. To install, run `make install` which accepts variable `DESTDIR`
as usual.

### Binary packages

Package `lxqt-admin` is available in the official repositories of all major
distributions.

#### openSUSE

openSUSE does not ship with lxqt-admin in it's standard repositories since the
functionality is covered by openSUSE's [YaST](http://yast.github.io/). It is still
possible to install & use it on openSUSE.

## Usage

Much like similar tools provided by [lxqt-config](https://github.com/lxqt/lxqt-config),
the tools of lxqt-admin can be launched from the
[Configuration Center](https://github.com/lxqt/lxqt-config#configuration-center), as
well as from the panel's main menu - Preferences - LXQt settings.

The actual usage should be self-explanatory. To apply settings the GUI of the polkit
authentication agent that's in use is launched to acquire the root password.


### Translations

Translations can be done in 
[LXQt-Weblate/admin-user](https://translate.lxqt-project.org/projects/lxqt-configuration/lxqt-admin-user/)
and in [LXQt-weblate/admin-time](https://translate.lxqt-project.org/projects/lxqt-configuration/lxqt-admin-time/).

<a href="https://translate.lxqt-project.org/projects/lxqt-configuration/lxqt-admin-user/">
<img src="https://translate.lxqt-project.org/widgets/lxqt-configuration/-/lxqt-admin-user/multi-auto.svg" alt="Translation status" />
</a>