Download Lumina

The recommended way of trying out the Lumina® desktop is by installing TrueOS®. Lumina® is also available on many other operating system with varying levels of support, and we list some of them below for convenience. Please note that the packages we list are just the ones that we know about – Lumina® can easily be installed on almost any Unix-like OS, so please search your current package system to see if a package exists if you don’t see one listed here.

NOTE: The Lumina project does not provide pre-compiled binaries of any kind. Any issues with a pre-built package (such as getting it updated to the latest version) should be submitted to the associated package maintainer.

OS Feature Support: Lumina® 1.0.0-Release
Operating System Control Panel App Store OS RSS Feed List Mounted Devices Screen Brightness Audio Volume Graphical Mixer Shutdown Options Suspend Support Battery Monitor Checksums Disk Space CPU/Memory Stats Disk R/W Stats
TrueOS SysAdm AppCafe Yes Yes Hardware & Software mixer pc-mixer Detect/Allow Detect/Allow Full (apm) md5 Yes Yes (sysctl) Yes (iostat)
FreeBSD (SysAdm) (AppCafe) Yes Yes Hardware & Software mixer pc-mixer Detect/Allow Detect/Allow (pc-sysconfig) Full (apm) md5 Yes Yes (sysctl) Yes (iostat)
OpenBSD none none No Yes Hardware (xbacklight) mixerctl none Detect/Allow none Full (apm) md5 Yes No No
NetBSD none none Yes No none none none Detect/Allow none none md5 Yes No No
DragonflyBSD none none Yes Yes Software (xbrightness) mixer none Allow none Full (sysctl) md5 Yes Yes (sysctl) No
GNU/kFreeBSD none none No Yes Hardware (xbacklight) none pavucontrol Allow none none none No No No
Gentoo Linux none Porthole No Yes Hardware (xbacklight) amixer pavucontrol Detect/Allow Detect/Allow acpi (no estimates) md5sum Yes Yes (top) Yes (iostat)
Debian Linux none Synaptic No Yes Hardware (xbacklight) amixer pavucontrol Detect/Allow Detect/Allow acpi (no estimates) md5sum Yes Yes (top) Yes (iostat)
Generic Linux none none No Yes Hardware (xbacklight) amixer pavucontrol Allow none acpi (no estimates) md5sum Yes No No
Installing Lumina packages on Arch Linux

The Lumina desktop is available in Arch Linux’s AUR repository as the lumina-desktop package. You can download and install the lumina-desktop file by running the following commands on Arch Linux:

mkdir ~/builds
cd ~/builds
curl -L -O https://aur.archlinux.org/cgit/aur.git/snapshot/lumina-desktop.tar.gz
cd lumina-desktop
makepkg -si

Installing Lumina packages on Fedora

The Lumina desktop and it’s utilities are available on the official Fedora package repositories.
The desktop may be installed by running:

sudo dnf install lumina-desktop

Similarly, there are stand-alone packages available for various Lumina® desktop utilities, such as the file manager:

sudo dnf install lumina-fm

The package manager should take care of the details of installing Lumina® and also install the desktop’s dependencies. Afterward Lumina® will be available as a session option from Fedora’s login screen. Please note, some people have reported they had to reboot their computer before Lumina would appear as a session option on the login screen.

Installing Lumina packages on FreeBSD

Lumina can be installed on FreeBSD either from the project’s package repositories or from FreeBSD’s ports collection. To install Lumina as a package, run:

su
(Enter the root user’s password.)
pkg install lumina

Alternatively, Lumina may be installed from the ports collection by running the following commands:

su
(Enter the root user’s password.)
portsnap fetch
portsnap install
cd /usr/ports/x11/lumina
make install
(Wait while the port is compiled.)
make clean

Installing Lumina packages on Gentoo Linux

Lumina can be installed on Gentoo Linux through the “emerge” system. To install Lumina as a package, run:

sudo emerge -a x11-wm/lumina

Installing Lumina packages on Manjaro Linux

The Manjaro Linux distribution includes Lumina desktop packages in the project’s Community repositories. To install the Lumina desktop environment on a Manjaro system either install the lumina-desktop package from the graphical package manager or run the following command:

sudo pacman -S lumina-desktop

Lumina should then be available as a session option from the graphical login screen.

Installing Lumina packages on OpenBSD

To install Lumina packages on the OpenBSD operating system, first make sure your PKG_PATH variable is set and points to a valid OpenBSD package mirror.

Then run the following command

sudo pkg_add lumina

Note: On OpenBSD 5.8+, the sudo utility was replaced with doas

Installing Lumina packages on PCLinuxOS

The Lumina desktop is available as a package in the PCLinuxOS testing software repositories. To install Lumina on PCLinuxOS, run the following commands as the root user:

apt-get update
apt-get install lumina-desktop

Installing Lumina packages on Void Linux

The Lumina desktop is available as a pre-built package from the default repository on Void Linux.

xbps-install lumina

Building Lumina from source code (generic)

Lumina can be built from source code on most Linux distributions and flavours of BSD. To compile Lumina® from source, perform the following steps:

1) Make sure the dependencies for your platform have been installed. A full list of Lumina’s dependencies is listed in the DEPENDENCIES file.

2) Follow the build instructions listed on the Lumina git repository for compiling from sources.

NOTE FOR DEVELOPERS: The Lumina desktop environment is not an application development toolkit/framework – it is only a system interface. If you want to create applications for users of the Lumina® desktop, simply create/install the registration file(s) for your application according to the XDG/FreeDesktop standards (the desktop entry, menu, and autostart specifications in particular – depending on the needs of your application). If you wish to reduce the number of additional dependencies for your application on a Lumina® system, simply write it using the Qt5 graphical toolkit and not the KDE-based variant/offshoot of Qt.