LXQt Desktop Final Instructions

#### Beyond Linux® From Scratch (System V Edition) - Version r13.1-84

### Chapter 37. LXQt Desktop

- Prev

  obconf-qt-0.16.6

- Next

  LXQt Applications

- Up
- Home

# LXQt Desktop Final Instructions

## Post-Install Instructions

Please follow these instructions before starting LXQt for the first time.

### Dependencies to Start LXQt

#### Required

- For Xorg: openbox-3.6.1, or another window manager, such as Xfwm4-4.20.0, or kwin from Plasma-6.7.4; note that IceWM-4.1.0 is not suitable for LXQt

- For Wayland: wayfire-0.11.0 and the section called “Configuring lxqt-wayland-session”

#### Recommended

breeze-icons-6.29.0 and desktop-file-utils-0.28

#### Optional

lightdm-1.33.1 or another Display Manager, e.g. sddm-0.21.0, or XScreenSaver-6.16

## Final Configuration

### LXQt Final Database Updates

The desktop databases need to be created or updated at this point. Run the following commands as the `root` user:

    ldconfig                             &&
    update-mime-database /usr/share/mime &&
    xdg-icon-resource forceupdate        &&
    update-desktop-database -q

## Starting LXQt

### Starting LXQt Xorg

You can start LXQt from runlevel 3, using xinit-1.4.4, or from runlevel 5, using a Display Manager, such as lightdm-1.33.1.

To start LXQt using xinit-1.4.4, run the following commands:

    cat > ~/.xinitrc << "EOF"
    exec startlxqt
    EOF

    startx

The X session starts on the first unused virtual terminal, normally vt1. You can switch to another vtn by simultaneously pressing the keys Ctrl-Alt-Fn (n=2, 3, ...). To switch back to the X session, normally started at vt1, use Ctrl-Alt-F1. The vt where the command startx was executed will display many messages, including X starting messages, applications automatically started with the session, and eventually, some warning and error messages, but these are hidden by the graphical interface. You may prefer to redirect those messages to a log file, which can be used for debugging purposes. This can be done starting X with:

    startx &> ~/.x-session-errors

### Starting LXQt Wayland

Before starting the session, ensure the section called “Configuring lxqt-wayland-session” was followed. Afterwards, the Wayland LXQt session can be started by running the following command:

    startlxqtwayland

## Initial Configuration

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 openbox 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.

The panel will be at the bottom of the screen. Right clicking on the panel will bring up a menu that will allow you to customize the panel including adding widgets and setting the background color. The BLFS editors recommend installing, at a minimum, the Application Manager and Task Manager widgets.

After LXQt has started for the first time, the BLFS editors recommend going through the settings presented in the LXQt Configuration Center, which can be found under LXQt Settings in the Preferences menu of the application launcher.

### Note

The user configuration files will be created in the directory $HOME/.config/lxqt/. To get widget icons to display properly, the lxqt.conf file may need to be manually edited to include the line "icon_theme=oxygen".

- Prev

  obconf-qt-0.16.6

- Next

  LXQt Applications

- Up
- Home