=====  Lumina Desktop =====

**Lumina** is a lightweight [[en:system:userspace:desktop_enviroment|desktop environment]] that is free of D-Bus (and all its [[en:philosophy:dbus_failure|failures]]) and *kit and is designed to have as few **system dependencies** and **requirements** as possible. Check out the Lumina [[https://en.wikipedia.org/wiki/Lumina_(desktop_environment)|Wikipedia article]] and their official [[https://www.lumina-desktop.org/handbook/|handbook]].

==== Installation ====

=== Prebuilt package ===
To **install** Lumina desktop, run the command:

<code bash>
pacman -S lumina lumina-extra
</code>

<note>
The [[https://www.hyperbola.info/packages/extra/x86_64/lumina-core/|lumina]] package includes both **lumina-core** and **lumina-core-utils**, and the [[https://www.hyperbola.info/groups/x86_64/lumina-extra/|lumina-extra]] package includes its own implementations of **archiver**, **fileinfo**, **fm**, **photo**, **screenshot** and **textedit**, respective to ''lumina'' package.
</note>

Do note that Lumina, just like any other window manager, needs a windowing server protocol to connect to in order to be a runnable solution.  On Hyperbola, the solution to this is not X11 but [[en:system:display_servers:xenocara|Xenocara]], and so if that was not already installed, let's do so now:

<code bash>
pacman -S xenocara
</code>

For the best performance with your graphics hardware, make sure you have also installed the package corresponding to your video card according to the table in the [[en:system:display_servers:xenocara#driver_installation|Driver Installation]] section of the above article.
==== Configuration ====

The installed **configuration file** is <color #620BB9/#EEDDFF>/etc/luminaDesktop.conf</color>. Lumina also has a bunch of its own configuration **tools**.

Most users will need to give themselves device access rights to get working sound output, video acceleration and more. Don't miss out on configuring the fixes listed in our [[en:system:init_systems:openrc#groups|OpenRC groups]] section.

For some more specific setup, such as to make devices like laptop trackpads more comfortable, the configuration files for Xenocara allow for a lot of low-level adaptability. One improvement over being reliant on D-Bus is that a lot of details of device initialization was, with D-Bus, hidden away from users and had less exposition of their configuration. To specifically control the setup of a laptop trackpad, a configuration section such as the below could be added to a new file created at

''/usr/share/X11/xorg.conf.d/50-synaptics.conf'':

<code>
Section "InputClass"
        Identifier "touchpad"
        Driver "synaptics"
        MatchIsTouchpad "on"
                Option "TapButton1" "1"
                Option "TapButton2" "2"
                Option "TapButton3" "3"
                Option "VertEdgeScroll" "on"
                Option "VertTwoFingerScroll" "on"
                Option "HorizEdgeScroll" "on"
                Option "HorizTwoFingerScroll" "on"
                Option "CircularScrolling" "on"
                Option "CircScrollTrigger" "2"
                Option "EmulateTwoFingerMinZ" "40"
                Option "EmulateTwoFingerMinW" "8"
                Option "CoastingSpeed" "0"
EndSection
</code>
==== Invocation ====

Lumina provides its own replacement command for [[https://wiki.gentoo.org/wiki/Xorg/Guide#Using_startx|startx]] to be started from the console.

<code bash>
start-lumina-desktop
</code>

Alternatively, it can be added to the ''<color #620BB9/#EEDDFF>~./xinitrc</color>'' file for being started via [[https://wiki.gentoo.org/wiki/Xorg/Guide#Using_startx|startx]] or a [[en:system:userspace:display_manager|display manager]].

Make sure to read this [[https://wiki.archlinux.org/index.php/X_resources#Adding_to_xinitrc|article]] for more information on managing ''startx'' on Arch GNU/Linux. (The information applies to Hyperbola as well.) But the relevant commands are below:

<code bash>
[[ -f ~/.Xresources ]] && xrdb -merge -I$HOME ~/.Xresources
exec start-lumina-desktop
</code>

==== External resources ====

  * [[https://lumina-desktop.org/|Official webpage]].
  * Moore, Ken (26 April 2014). [[https://lumina-desktop.org/faq/|"Quick Lumina Desktop FAQ"]].
  * [[https://github.com/lumina-desktop/lumina|Lumina]] source code.