# Liri

Related articles

- Wayland
- Desktop environment
- Display manager
- Window manager
- Qt

Liri is a desktop environment with modern design and features. Liri is the merge between Hawaii, Papyros and the Liri Project.

Warning: Liri is currently in alpha stage and there might be issues.

## Installation

Install liri-shell-gitAUR from the Arch User Repository.

Otherwise you can follow these instructions:

Add the following lines to your `/etc/pacman.conf` file:

    /etc/pacman.conf

    [liri-unstable]
    SigLevel = Optional TrustAll
    Server = https://repo.liri.io/archlinux/unstable/$arch/

Then run:

    sudo pacman -Syu
    sudo pacman -S liri-shell-git

### Other applications

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

- liri-browser — Material design web browser for Liri.

  https://github.com/lirios/browser || liri-browser-gitAUR

- liri-files — Material design file manager for Liri.

  https://github.com/lirios/files || liri-files-gitAUR

- liri-player — Material design media player for Liri.

  https://github.com/lirios/player || liri-player-gitAUR

- liri-settings — Settings application and modules for Liri.

  https://github.com/lirios/settings || liri-settings-gitAUR

- liri-terminal — Terminal for Liri.

  https://github.com/lirios/terminal || liri-terminal-gitAUR

## Starting the desktop

### Run with a graphical login manager

Login managers that support Wayland such as SDDM and GDM can run a Liri session.

### Run from a tty

Log in to a tty and type:

    $ liri-session

The session manager automatically detects the hardware and will run the compositor accordingly.

However the mode can be forced, for example to force nested mode and run inside Weston:

    $ liri-session -platform wayland

Note: Do not use ~/.xinitrc to start Liri. Xinit is commonly used to start Xorg, but Liri uses Wayland, which is a newer graphical protocol.

### Run with systemd user session

First you need to setup D-Bus with systemd user session as examplained on Systemd/User#D-Bus[broken link: invalid section]. Then enable the liri.service unit with:

    $ systemctl --user enable liri.service

Every time you want to start a Liri session:

    $ systemctl --user isolate liri.target

logind integration is know not to work with systemd user session at the moment, hence some features might not be working. systemd user session is pretty new and the developers are testing Liri with it.

## See also

- Official web site
- Liri's GitHub page

Category:

- Desktop environments

Hidden category:

- Pages with broken section links