===== dCore LXQt Guide =====
[[http://lxqt.org/|LXQt]] was briefly tested in dCore-xenial and observed to provide a stable environment. Note LXQt is relatively new and is undergoing active development. The following guide provides useful installation and configuration information as well as known issues.

==== LXQt Installation ====
Suggested import packages to load at boot, use ''sce-import -b'' or ''sce-import -bl'', see [[http://wiki.tinycorelinux.net/dcore:sce-import_command|dCore sce-import Command]]:
  *lxqt: Desktop Environment and utilities
  *lxde-icon-theme: proper icons in PCManFM
  *obconf-qt: easy GUI desktop configuration utility
  *obmenu: easy GUI menu utility
  *kscreen: easy GUI monitor settings

By default the LXQt import installs:
  *lxqt openbox environment
  *lxqt-panel
  *pcmanfm-qt
  *QTerminal
  *Xarchiver
  *LXImage
  *Screenshot

==== Configuration ====
Use the desktop boot code //lxqt-session// to launch the LXQt environment at boot:
  desktop=lxqt-session

Create an ~/.X.d/startups file containing the following to launch lxqt-panel and pcmanfm-qt at boot:
  dbus-run-session lxqt-panel &
  dbus-run-session pcmanfm-qt &
 
Right-click lxqt-panel to configure. Note the panel root menu -> System Tools auto-populates with important dCore specific menu items, including control panel, exit, FLTK-editor, mount tool, run program, sce-import, set time, top, xkill and aterm.

Launch pcmanfm-qt from lxqt-panel start -> Accessories -> PCManFM File Manager.

To launch pcmanfm-qt from a terminal or custom menu entry instead use:
  dbus-run-session pcmanfm-qt

Open pcmanfm-qt as above and select Edit -> Preferences -> Display -> Icon Theme -> select nuoveXT.2.2 -> click OK to activate.

Create a ~/Desktop directory or pcmanfm-qt -> Places -> Desktop causes crash.

Executables, icons, desktop files can be dragged from pcmanfm-qt or even the root menu and sub-menu to the panel quick launch area.

Modify /home/tc/.config/openbox/rc.xml to configure keyboard/mouse preferences.

Run ''obmenu'' to configure right-click menu, creates ~/.config/openbox/menu.xml file.

Use //obmenu// to change the //obconf// menu entry to //obconf-qt//.

Use //obmenu// to delete the //exit// entry and replace with //exittc//.

Use //obmenu// to modify the terminal and browser entries and create additional menu items as desired.

After making configuration changes, right-click desktop and select //restart// from menu to activate changes.

Run ''obconf-qt'' to change numerous environment preferences.

SCEs placed in OnDemand can be launched direct from menu provided the SCE name is the same as the executable. Launching an OnDemand application will automatically load then launch the extension without the need to use the sce-load command or rely on a built-in dCore OnDemand menu.

Numerous additional configuration options are available from the Preferences menu, including LXQt Configuration Center.

==== Issues ====
Minimal issues were noted during brief testing and LXQt appeared to run stable.

If solutions to these issues are found, please update this wiki page.

Not all built-in LXQt applicatons and helper utilities were tested, the following appeared functional: Appearance, Date and Time, Desktop, Desktop Notifications, File Associations, Keyboard and Mouse, LXQt Configuration Center, Locale, Power Management Settings, Session Settings, Shortcut Keys, Users and Groups.

Despite installing lxde-icon-theme and configuring pcmanfm-qt, proper icons did not appear when opening Preferences -> LXQt Configuration Center. Either an LXQt bug or additional configuration required.

Right-click lxqt-panel -> Configure Panel -> Widgets, no icons displayed for control buttons, rely on hover text for information.

Preferences -> Power Management not formally tested. Additional software like //pm-utils// (pm-hibernate, pm-suspend) may need importing to enable this functionality.

Selecting pcmanfm-qt -> Computer indicates operation not supported.

Selecting pcmanfm-qt -> Network indicates operation not supported. Likely a dbus or networking issue. Networking software, such as Samba, is not installed with the default LXQt import.