Difference between revisions of "LXQt"

From ArchWiki
Jump to: navigation, search
(Installation: add bug report with references)
 
(128 intermediate revisions by 37 users not shown)
Line 1: Line 1:
 
[[Category:Desktop environments]]
 
[[Category:Desktop environments]]
 +
[[ja:LXQt]]
 
[[ru:Razor-qt]]
 
[[ru:Razor-qt]]
[[zh-CN:Razor-qt]]
+
[[zh-CN:LXQt]]
'''[http://razor-qt.org/ Razor-qt]''' is an advanced, easy-to-use, and fast toolbox-like [[Desktop Environment|desktop environment]], which is, like KDE, based on [[Qt]] technologies. It has been tailored for users who value simplicity, speed, an intuitive interface and high customizability, therefore it features only few basic components, while most applications, like a File-Manager, have to be added by the user. Due to this, Razor-QT runs fine on weak machines, too.
+
{{Related articles start}}
 +
{{Related|LXDE}}
 +
{{Related|Desktop environment}}
 +
{{Related|Window manager}}
 +
{{Related articles end}}
 +
In early 2013, Hong Jen Yee "PCMan" started porting [[LXDE]] components to [[Qt]]. The first [http://blog.lxde.org/?p=1013 preview of LXDE-Qt] was released on July 3rd, 2013. On July 21st, it was announced that Razor-qt (a desktop similar in design to LXDE) and LXDE were merging.  
  
== Merge with LXDE-Qt ==
+
The result is [http://lxqt.org LXQt], a desktop built on Qt which partly uses Razor-qt and LXDE components. While development is mainly focused on LXQt, the GTK+ 2 version of LXDE will see continued development.
Razor-qt and [[LXDE]] share the same philosophy. Both strive for small footprint, limited dependencies and modularity. So they decided the best course of action for both projects is to focus on a single desktop environment, instead of two. The plan is to cherry-pick the best parts of Razor and LXDE and include or port those to LXDE-Qt. Other components will be ported straight from GTK code or rewritten from scratch.
+
  
As for Razor-qt, 0.6.0 will be the final package for those who are happy with the desktop as it is. After the release, there are no further plans to maintain the Razor-qt tree on its own. All developer will all be working on the LXDE-Qt repositories.
+
== Installation ==
  
==Installation==
+
[[Install]] the {{Grp|lxqt}} group.
  
There are packages {{aur|razor-qt}} and {{aur|razor-qt-git}} in the [[AUR]] that allows you to install it.
+
You also need an icon theme to be installed. The default one is ''Oxygen'', which can be installed with the {{Pkg|oxygen-icons}} package.
On a fresh ArchLinux, you'd probably want to add a Login-Manager, too, for example [[SLiM]].
+
  
When starting Razor-QT by {{ic|.xinitrc}} (including use of SLiM as login manager), the appropriate command is
+
For additional functionality, you may wish to install the following:
exec razor-session
+
  
You may want to copy the default configuration file to your home folder for additional customization.
+
* {{App|[[Connman]]|Network manager like [[NetworkManager]].| http://git.kernel.org/cgit/network/connman | {{Pkg|connman}}}}
mkdir -p ~/.config/razor
+
* {{App|LXQt Connman applet|LXQt system-tray applet for [[Connman]].| https://github.com/surlykke/lxqt-connman-applet | {{AUR|lxqt-connman-applet-git}}}}
cp /etc/xdg/razor/session.conf ~/.config/razor
+
* {{App|LXImage-Qt|Image viewer and screenshot tool for LXQt.| https://github.com/lxde/lximage-qt | {{AUR|lximage-qt}}}}
 +
* {{App|ObConf-Qt| The Qt port of ObConf, the [[Openbox]] configuration tool. | https://github.com/lxde/obconf-qt | {{AUR|obconf-qt}}}}
 +
* {{App|QTerminal|Lightweight Qt-based terminal emulator.| https://github.com/qterminal/qterminal | {{AUR|qterminal}}}}
 +
* {{App|[[SDDM]]|The recommended display manager for LXQt.| https://github.com/sddm/sddm | {{Pkg|sddm}}}}
 +
* {{App|[[XScreenSaver]]| A screen saver required for screen locking in LXQt.{{Bug|49444}}| https://www.jwz.org/xscreensaver/ | {{Pkg|xscreensaver}}}}
  
==Window Manager==
+
Some LXQt panel plugins require extra packages to function, check the [[PKGBUILD#optdepends|optional dependencies]] for {{Pkg|lxqt-panel}}.
  
Razor-QT has no Window Managers of it's own, but it will run with most [[Window Manager|Window Managers]]. [[Openbox]] is "the Official WM of razor-qt" but you can choose your own either through Razor's Session Management tool, or by editing  {{ic|~/.config/razor/session.conf}}.
+
== Starting the desktop ==
  
More information about razor-qt and Window Manager integration can be found on the [https://github.com/Razor-qt/razor-qt/wiki/Window-Managers Razor-qt wiki].
+
=== Using xinit ===
  
===Compiz===
+
Append the following line to [[Xinitrc]]:
  
In order to use [[Compiz]] as Razor's Window Manager, you have to edit your {{ic|session.conf}} like this:
+
exec startlxqt
  
[General]
+
=== Graphical login ===
windowmanager=compiz ccp
+
  
Methods like fusion-icon, adding compiz to the .xinitrc or {{ic|compiz --replace ccp &}} will usually result in crashing X.
+
Choose ''LXQt Desktop'' from the menu in a [[display manager]] of choice.
  
==Suggested Applications==
+
== Configuration ==
  
A fresh Razor-QT won't provide much of the tools you need, as it leaves to the user, what to add.
+
LXQt in general tries to provide GUI applications to change its settings. Configuration files are in {{ic|~/.config/lxqt}}. This directory is initialized automatically. The default configuration for new users is found in {{ic|/etc/xdg/lxqt}}.
A collection on useful apps (which use QT) are found on the projects homepage at [https://github.com/Razor-qt/razor-qt/wiki/3rd-party-applications 3rd Party applications].
+
  
==Troubleshooting==
+
=== Replace Openbox ===
  
When Razor's applications don't stick with your QT-theme (especially when using KDE's system settings to set your theme), then as of KDE 4.6.1 you'll probably need to tell Qt how to find KDE's styles (Oxygen, QtCurve etc.)
+
While [[Openbox]] is the default [[window manager]] for LXQt, you can specify a different window manager to use with LXQt via ''Session Settings'', {{ic|lxqt-config-session}}; or by editing {{ic|~/.config/lxqt/session.conf}}. Change the following line:
  
You just need to set the environment variable QT_PLUGIN_PATH. E.g. put
+
window_manager=openbox
  
export QT_PLUGIN_PATH=$HOME/.kde4/lib/kde4/plugins/:/usr/lib/kde4/plugins/
+
to a [[window manager]] of choice:
  
into your {{ic|/etc/profile}} (or {{ic|~/.profile}} if you do not have root access). qtconfig should then be able to find your kde styles and everything should look nice again!
+
window_manager=''your_window_manager''
  
Alternatively, you can symlink the Qt styles directory to the KDE styles one:
+
=== Autostarting applications ===
# ln -s /usr/lib/kde4/plugins/styles/ /usr/lib/qt/plugins/styles
+
 
 +
To have X applications start on login, click the main menu from the LXQt -> Preferences -> LXQt Settings -> Session Settings. Alternatively, this can be launched with:
 +
lxqt-config-session
 +
From this window, click on "AutoStart" on the left side. Here you can add a new application to either the global autostart (launched in all sessions implementing the said specification) or your local autostart (labled LXQt Autostart) (See [https://github.com/lxde/lxqt/issues/746 issue 746] for a bug related to this option).
 +
 
 +
=== Editing the Application Menu ===
 +
 
 +
It is possible to edit menu entries by editing their .desktop files stored in {{ic|/usr/share/applications/lxqt-*.desktop}} files. See [[Desktop entries]].
 +
 
 +
== Suggested applications ==
 +
 
 +
As LXQt is a lightweight desktop, a plain install will not provide many desktop applications. It is left to the user to choose what applications they wish to install. The [https://github.com/Razor-qt/razor-qt/wiki/3rd-party-applications Razor-qt wiki] has a page which lists of number of useful Qt applications that you may wish to install. Also see the [[List of applications]] page for a comprehensive list of applications available in Arch.
 +
 
 +
== See also ==
 +
 
 +
* [http://lxqt.org LXQt homepage]
 +
* [https://github.com/lxde/lxqt LXQt development]
 +
* [http://lxqt-de.deviantart.com/ LXQt on deviantART]
 +
* [https://github.com/lxde/lxqt/wiki LXQt wiki on GitHUb]

Latest revision as of 10:56, 23 May 2016

In early 2013, Hong Jen Yee "PCMan" started porting LXDE components to Qt. The first preview of LXDE-Qt was released on July 3rd, 2013. On July 21st, it was announced that Razor-qt (a desktop similar in design to LXDE) and LXDE were merging.

The result is LXQt, a desktop built on Qt which partly uses Razor-qt and LXDE components. While development is mainly focused on LXQt, the GTK+ 2 version of LXDE will see continued development.

Installation

Install the lxqt group.

You also need an icon theme to be installed. The default one is Oxygen, which can be installed with the oxygen-icons package.

For additional functionality, you may wish to install the following:

http://git.kernel.org/cgit/network/connman || connman
  • LXQt Connman applet — LXQt system-tray applet for Connman.
https://github.com/surlykke/lxqt-connman-applet || lxqt-connman-applet-gitAUR
  • LXImage-Qt — Image viewer and screenshot tool for LXQt.
https://github.com/lxde/lximage-qt || lximage-qtAUR
  • ObConf-Qt — The Qt port of ObConf, the Openbox configuration tool.
https://github.com/lxde/obconf-qt || obconf-qtAUR
  • QTerminal — Lightweight Qt-based terminal emulator.
https://github.com/qterminal/qterminal || qterminalAUR
  • SDDM — The recommended display manager for LXQt.
https://github.com/sddm/sddm || sddm
https://www.jwz.org/xscreensaver/ || xscreensaver

Some LXQt panel plugins require extra packages to function, check the optional dependencies for lxqt-panel.

Starting the desktop

Using xinit

Append the following line to Xinitrc:

exec startlxqt

Graphical login

Choose LXQt Desktop from the menu in a display manager of choice.

Configuration

LXQt in general tries to provide GUI applications to change its settings. Configuration files are in ~/.config/lxqt. This directory is initialized automatically. The default configuration for new users is found in /etc/xdg/lxqt.

Replace Openbox

While Openbox is the default window manager for LXQt, you can specify a different window manager to use with LXQt via Session Settings, lxqt-config-session; or by editing ~/.config/lxqt/session.conf. Change the following line:

window_manager=openbox

to a window manager of choice:

window_manager=your_window_manager

Autostarting applications

To have X applications start on login, click the main menu from the LXQt -> Preferences -> LXQt Settings -> Session Settings. Alternatively, this can be launched with:

lxqt-config-session

From this window, click on "AutoStart" on the left side. Here you can add a new application to either the global autostart (launched in all sessions implementing the said specification) or your local autostart (labled LXQt Autostart) (See issue 746 for a bug related to this option).

Editing the Application Menu

It is possible to edit menu entries by editing their .desktop files stored in /usr/share/applications/lxqt-*.desktop files. See Desktop entries.

Suggested applications

As LXQt is a lightweight desktop, a plain install will not provide many desktop applications. It is left to the user to choose what applications they wish to install. The Razor-qt wiki has a page which lists of number of useful Qt applications that you may wish to install. Also see the List of applications page for a comprehensive list of applications available in Arch.

See also