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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
# lxqt-config
## Overview
This repository is providing several tools involved in the configuration of both
LXQt and the underlying operating system.
On the one hand it is featuring several GUI tools to configure topics like
general appearance, pointer devices or screen resolutions. On the other hand
there's a GUI "Configuration Center" which summarizes all those configuration
tools as well as counterparts of other LXQt components or third-party
applications.
### Configuration GUI tools
#### LXQt Appearance Configuration
Appearance of LXQt, that is topics like icon and LXQt theme or fonts.
Binary `lxqt-config-appearance`.
#### Brightness
Brightness settings of output devices.
Technically colors are adjusted to simulate varying brightness if the system
LXQt is running on doesn't allow for adjusting the brightness itself.
Binary `lxqt-config-brightness`.
#### File Associations
Assigns MIME types to applications used to handle them. Not too user-friendly so
far, see e. g. discussion in https://github.com/lxqt/lxqt/issues/433.
Binary `lxqt-config-file-associations`.
#### Keyboard and Mouse
Configures hardware of pointer devices. Settings like repeat delay and interval
of keyboards or acceleration of pointer devices.
Binary `lxqt-config-input`.
**Note**: Not supported currently under wayland.
#### Locale
Locale used within LXQt sessions. Basically this GUI sets the well-known
environment variables like `LANG` or `LC_*`. The settings apply to the session
as a whole, that is to applications running within LXQt sessions but not
belonging to LXQt, too.
Binary `lxqt-config-locale`.
**Note**: The SVG ISO flags from `$XDG_DATA_DIRS/iso-flags-svg/country-4x3/` will be shown if `iso-flags-svg` is installed (whether as root or inside `~/.local/share/`).
#### Monitor Settings
Adjusts screen resolutions, positioning of screens and the likes.
Binary `lxqt-config-monitor`.
**Note**: Not supported currently under wlroots based compositors.
### Configuration Center
The "Configuration Center" (binary `lxqt-config`) is summarizing and providing
various configuration GUIs.
First of all these are the ones belonging to repository lxqt-config described
[above](https://github.com/lxqt/lxqt-config#configuration-gui-tools). Next, it
is hosting counterparts of several other LXQt components like "Desktop
Notifications" of [lxqt-notificationd](https://github.com/lxqt/lxqt-notificationd),
"Shortcut Keys" of [lxqt-globalkeys](https://github.com/lxqt/lxqt-globalkeys)
or the tools provided by [lxqt-admin](https://github.com/lxqt/lxqt-admin).
Third-party applications can include their configuration tools in
"Configuration Center", too. This applies e. g. to "Connman UI Setup" of
[cmst](https://github.com/andrew-bibb/cmst) or "SDDM Configuration" of
[sddm-config-editor](https://github.com/hagabaka/sddm-config-editor).
Other kinds of settings are shown under "Other Settings".
## Installation
### Compiling source code
Runtime dependencies are Xcursor, qtsvg, KScreen, [lxqt-menu-data](https://github.com/lxqt/lxqt-menu-data/) 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, depending on the way library
paths are dealt with on 64bit systems variables like `CMAKE_INSTALL_LIBDIR` may
have to be set as well.
To build run `make`, to install `make install` which accepts variable `DESTDIR`
as usual.
### Binary packages
The library is provided by all major Linux and BSD distributions.
Just use your package manager to search for string `lxqt-config`.
## Usage
Both the various configuration tools and the Configuration Center can be launched
from the panel's main menu - Preferences - LXQt settings. Obviously the former
can be launched from the latter, too.
### Translations
Translations can be done in [LXQt-Weblate](https://translate.lxqt-project.org/projects/lxqt-configuration/lxqt-config/)
<a href="https://translate.lxqt-project.org/projects/lxqt-configuration/lxqt-config/">
<img src="https://translate.lxqt-project.org/widgets/lxqt-configuration/-/lxqt-config/multi-auto.svg" alt="Translation status" />
</a>
|
