| Newsgroups |
gmane.linux.lfs.beyond.book |
| Message-ID |
<178243945228.2268876.12415548730147394294@rivendell.linuxfromscratch.org> |
This is an automated email from the git hooks/post-receive script.
git pushed a commit to branch trunk
in repository blfs.
The following commit(s) were added to refs/heads/trunk by this push:
new 3e5147f31a Update lxqt-wayland-session for wayfire.
3e5147f31a is described below
commit 3e5147f31a72eeb74beb769dba32af396d0ad841
Author: zeckma-tech <[email protected]>
AuthorDate: Thu Jun 25 20:01:58 2026 -0600
Update lxqt-wayland-session for wayfire.
lxqt-wayland-session now points to wayfire. Some stuff was corrected and
explained a bit better. Some slight configuration is needed for every
user, but isn't too bad. The swaybg thing that I talked about some time
ago is only for the splash screen. pcmanfm-qt handles wallpapers and
does the job just fine, no matter the session. This closes #22927.
---
introduction/welcome/changelog.xml | 3 ++
lxqt/desktop/lxqt-wayland-session.xml | 56 ++++++++++++++++++-----------------
lxqt/desktop/post-install.xml | 38 +++++++++++++++++-------
3 files changed, 60 insertions(+), 37 deletions(-)
diff --git a/introduction/welcome/changelog.xml b/introduction/welcome/changelog.xml
index 7791a51c6a..04d0a86c3b 100644
--- a/introduction/welcome/changelog.xml
+++ b/introduction/welcome/changelog.xml
@@ -42,6 +42,9 @@
<listitem>
<para>June 25th, 2026</para>
<itemizedlist>
+ <listitem>
+ <para>[zeckma] - Update lxqt-wayland-session for wayfire.</para>
+ </listitem>
<listitem>
<para>[jlocash] - Update to libass-0.17.5 (Security Update). Fixes
<ulink url="&blfs-ticket-root;23496">#23496</ulink>.</para>
diff --git a/lxqt/desktop/lxqt-wayland-session.xml b/lxqt/desktop/lxqt-wayland-session.xml
index 1b8f839a30..b2c29d8b2a 100644
--- a/lxqt/desktop/lxqt-wayland-session.xml
+++ b/lxqt/desktop/lxqt-wayland-session.xml
@@ -15,7 +15,6 @@
<sect1 id="lxqt-wayland-session" xreflabel="lxqt-wayland-session-&lxqt-session-version;">
<?dbhtml filename="lxqt-wayland-session.html"?>
-
<title>lxqt-wayland-session-&lxqt-wayland-session-version;</title>
<indexterm zone="lxqt-wayland-session">
@@ -26,8 +25,12 @@
<title>Introduction to lxqt-wayland-session</title>
<para>
- The <application>lxqt-wayland-session</application> package contains the
- wayland based session manager for <application>LXQt</application>.
+ The <application>lxqt-wayland-session</application> package contains a
+ helper script for <application>LXQt</application> that starts a Wayland
+ compositor from a given list, then the main
+ <application>LXQt</application> Wayland session. This package also
+ provides compositor-specific configuration files to help with a smooth
+ <application>LXQt</application> experience.
</para>
&lfs130_checked;
@@ -75,14 +78,19 @@
<xref linkend="qtxdg-tools"/>
</para>
+ <bridgehead renderas="sect4">Recommended</bridgehead>
+ <para role="recommended">
+ <xref role="runtime" linkend="wayfire"/> (runtime)
+ </para>
+
</sect2>
<sect2 role="installation">
<title>Installation of lxqt-wayland-session</title>
<para>
- Install <application>lxqt-wayland-session</application> by running the following
- commands:
+ Install <application>lxqt-wayland-session</application> by running the
+ following commands:
</para>
<screen><userinput>mkdir build &&
@@ -116,33 +124,27 @@ make</userinput></screen>
</para>
</sect2>
-->
- <sect2 role="configuration">
+ <sect2 id="lxqt-wls-conf" role="configuration">
<title>Configuring lxqt-wayland-session</title>
<para>
- Window Managers other than <xref linkend="openbox"/> may be used, e.g.
- <xref linkend="xfwm4"/>. Please note that <xref linkend="icewm"/> is not a
- good substitute. <application>Fluxbox</application> does work, although
- in this context (with <xref linkend="lxqt-config"/>), <xref
- linkend="openbox"/> is better. The configuration file
- <filename>/usr/share/lxqt/windowmanagers.conf</filename> comes with many
- examples of Window Managers and the ones which are installed will appear
- in a drop down list of <command>lxqt-config-session</command>. For the
- ones not included in
- <filename>/usr/share/lxqt/windowmanagers.conf</filename>, you can use
- <command>lxqt-config-session</command>'s "search" button, e.g. for <xref
- linkend="fluxbox"/>, navigating through the file system until you can
- choose <command>fluxbox</command>. <!--Alternatively, if you wish the Window
- Manager of your choice to appear in the drop down list, include it in
- <filename>/etc/xdg/lxqt/windowmanagers.conf</filename>. For <xref
- linkend="fluxbox"/>, include the line
+ The session chooses from a pre-existing list of Wayland compositors to
+ use. While compositors like Hyprland and Niri can be used, the following
+ uses the recommended compositor <xref linkend="wayfire"/>. Trying to
+ just start the session without configuration fails if labwc, another
+ Wayland compositor, is not installed. Each user will need to have a
+ configuration. Copy and edit a pre-existing configuration as a regular
+ user to use the recommended compositor for the session:
</para>
-<screen role="nodump"><userinput><literal>fluxbox/Name=Fluxbox</literal></userinput></screen>
+<screen role="nodump"><userinput>mkdir -pv ~/.config/lxqt &&
+cp -v /usr/share/lxqt/session.conf ~/.config/lxqt &&
+sed -i '/\[Environment\]/a compositor=wayfire' \
+ ~/.config/lxqt/session.conf</userinput></screen>
+
<para>
- and it will appear as an option in the drop down list. To change the WM,
- after selecting it, you need to restart the session.
--->
+ Now continue until <xref linkend="lxqt-post-install"/> for completing the
+ setup.
</para>
</sect2>
@@ -179,7 +181,7 @@ make</userinput></screen>
<term><command>lxqt-qdbus</command></term>
<listitem>
<para>
- is a dbus wrapper for keybinds on wayland compositors.
+ is a dbus wrapper for keybinds on wayland compositors
</para>
<indexterm zone="lxqt-wayland-session lxqt-qdbus">
<primary sortas="b-lxqt-qdbus">lxqt-qdbus</primary>
diff --git a/lxqt/desktop/post-install.xml b/lxqt/desktop/post-install.xml
index 6bf3a6e865..389a43a46e 100644
--- a/lxqt/desktop/post-install.xml
+++ b/lxqt/desktop/post-install.xml
@@ -26,10 +26,24 @@
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
- <xref linkend="openbox"/>, or another window manager, such as
- <xref role="nodep" linkend="xfwm4"/>, or
- kwin from <xref role="nodep" linkend="plasma-build"/>.
- Note that <xref role="nodep" linkend="icewm"/> is not suitable for LXQt.
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ For Xorg:
+ <xref linkend="openbox"/>, or another window manager, such as
+ <xref role="nodep" linkend="xfwm4"/>, or
+ kwin from <xref role="nodep" linkend="plasma-build"/>;
+ note that <xref role="nodep" linkend="icewm"/> is not suitable for
+ LXQt
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ For Wayland:
+ <xref linkend="wayfire"/> and <xref linkend="lxqt-wls-conf"/>
+ </para>
+ </listitem>
+ </itemizedlist>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
@@ -117,7 +131,9 @@ startx</userinput></screen>
<title>Starting LXQt Wayland</title>
<para>
- To start the wayland version of LXQt, run:
+ Before starting the session, ensure <xref linkend="lxqt-wls-conf"/>
+ was followed. Afterwards, the Wayland LXQt session can be started
+ by running the following command:
</para>
<screen role="nodump"><userinput>startlxqtwayland</userinput></screen>
@@ -129,11 +145,13 @@ startx</userinput></screen>
<title>Initial Configuration</title>
<para>
- When LXQt first starts, it will ask you for the window manager to use.
- To start, the BLFS editors recommend using <application>openbox</application>.
- At this point both the background and the panel will be black. Right clicking
- on the background will bring up a menu and selecting "Desktop Preferences"
- will allow you to change the background color or set a background image.
+ If LXQt is being started for the first time and it's the Xorg session, it
+ will ask you what window manager to use. To start, the BLFS editors
+ recommend using <application>openbox</application> for the Xorg session.
+ In both the Xorg and Wayland sessions, starting LXQt for the first time
+ results in a black-colored background by default. Right clicking on the
+ background will bring up a menu. You can select the "Desktop Preferences"
+ option to change the background color or set a background image.
</para>
<para>
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
--
http://lists.linuxfromscratch.org/sympa/info/blfs-book
Unsubscribe: See the above information page