Get 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® from packages (recommended)

Installing Lumina® from source code


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 OpenSUSE

To install Lumina® packages on the OpenSUSE operating system, just install the “lumina-desktop” package available in the OpenSUSE package repository.

 


Installing Lumina® packages on PC-BSD

The Lumina® desktop is available as a package in the software repositories. To install Lumina® on PC-BSD, run the following command:

sudo pkg install lumina

 


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 Slackware

Lumina® is available to users of Slackware through the SlackBuilds repository of build scripts. The following steps will install the Lumina® package on an installation of Slackware that has been set up with the Full collection of official Slackware packages. Please note the comments in parenthesis should not be typed, they suggestions rather than literal commands.

wget http://slackbuilds.org/slackbuilds/14.1/libraries/qt5.tar.gz
tar xzf qt5.tar.gz
cd qt5
wget http://download.qt-project.org/official_releases/qt/5.4/5.4.2/single/qt-everywhere-opensource-src-5.4.2.tar.xz
(check qt5.info text file for exact DOWNLOAD path)
su
(enter root password)
source /etc/profile
./qt5.SlackBuild
(wait a few hours)
installpkg /tmp/qt5-5.4.2-i486-1_SBo.tgz
exit
cd ..
wget http://slackbuilds.org/slackbuilds/14.1/desktop/lumina.tar.gz
tar xzf lumina.tar.gz
cd lumina
wget https://github.com/trueos/lumina/archive/v0.8.4-Release-P1.tar.gz
(check lumina.info text file for exact DOWNLOAD path)
su
(enter root password)
source /etc/profile
./lumina.SlackBuild
installpkg /tmp/lumina-0.8.4-i486-1_SBo.tgz
exit

With the above steps completed, Lumina will be made a session option from Slackware’s graphical login screen.

 


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 on Debian/Ubuntu/Linux Mint

To build the Lumina® desktop from source code on any members of the Debian, Ubuntu or Linux Mint distribution (or their derivative distributions) please perform the following steps.

Please note that older versions of Ubuntu (14.04 and earlier) do not ship with modern versions of the Qt 5 libraries. The following instructions should work for Debian 8 and Ubuntu 14.10 and earlier.

1. First, install the required software and build tools. Please note the “sudo apt-get install build-essential.. command is all one long command. There should be no line breaks between “build-essential” and “pavucontrol”.

sudo apt-get update
sudo apt-get install build-essential git qt5-default qttools5-dev-tools libqt5gui5 qtmultimedia5-dev libqt5multimediawidgets5 libqt5network5 libqt5svg5-dev libqt5x11extras5-dev libxcb-icccm4-dev libxcb-ewmh-dev libxcb-composite0-dev libxcb-damage0-dev libxcb-util0-dev libphonon-dev libxcomposite-dev libxdamage-dev libxrender-dev libxcb-image0-dev libxcb-screensaver0-dev qtdeclarative5-dev fluxbox kde-style-oxygen xscreensaver xbacklight alsa-utils acpi numlockx pavucontrol xterm sysstat

Next we need to download the Lumina source code.

git clone https://github.com/trueos/lumina.git

Our next step is to configure and build Lumina’s source code.

cd lumina
qmake

Note that after running qmake, there should be a message about detecting Debian for the OS-compatibility – otherwise you may need to run “qmake LINUX_DISTRO=Debian”

Finally, we build and install the desktop. These steps will likely take several minutes to complete.

make
sudo make install

At this point we can log out of our current desktop session and we should find the Lumina® session has been added as an option to our login screen.

 


Building Lumina from source on Fedora/CentOS

To install the Lumina® desktop on Fedora or CentOS, please perform the following steps.

1. First we need to make sure all the necessary dependencies are in place. On recent versions of Fedora we run the “dnf” package manager, but on older versions of Fedora or CentOS we can substitute “dnf” for “yum” in the following command. Please note the command shown here is all one long command.

sudo dnf -y install gcc gcc-c++ git qt-devel qt-config qt5-qttools qt5-qttools-devel qt5-qtbase-gui qt5-qtmultimedia-devel qt5-qtsvg-devel qt5-qtx11extras-devel xcb-util-image xcb-util-image-devel xcb-util-wm-devel libxcb-devel xcb-util-devel phonon-devel phonon-qt5-devel libXcomposite-devel libXdamage-devel libXrender-devel qt5-qtdeclarative-devel fluxbox qt5-style-oxygen plasma-oxygen xscreensaver xbacklight alsa-utils acpi numlockx pavucontrol xterm

2. Our next step is to download the Lumina® source code:

git clone http://github.com/trueos/lumina.git

3. Now we move into the Lumina® source directory and build the desktop. These commands may take several minutes to complete.

cd lumina
qmake-qt5 LIBPREFIX=/lib64
make

4. Finally, we install the Lumina® desktop on our system.

sudo make install

Logging out now should show the Lumina® desktop has been added to the list of available sessions we can access from the login screen.

 


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.