🐚 The desktop shell for Papyros, built using QtQuick and QtCompositor as a compositor for Wayland.
C++ QML CMake C


Papyros Shell

Join the chat at https://gitter.im/papyros/papyros

ZenHub.io GitHub release GitHub issues Bountysource

Papyros Shell is the desktop shell for Papyros, an operating system based upon Linux which conforms to Google’s Material Design guidelines. The focus will be on creating a stable and easy-to-use operating system with a heavy emphasis on well-thought-out design.

Brought to you by the Papyros development team.

Implementation Details

The shell is built as a compositor for Wayland using the Green Island compositor framework and QtQuick. The goal is to develop a convergent shell that adapts to the form factor of the device it is running on, and to also support HIDPI screens.

Green Island provides the C++ code necessary to interact with Wayland, and QML Desktop provides C++ plugins for QML for the desktop indicators, so the majority of the shell is implemented in QML and Javascript.

Special thanks to Hawaii shell and its author Pier Luigi Fiorini for some of the QML backend plugins, including the hardware plugin and the original code for the app launcher model.

Installing on Arch

Papyros has an Arch repository with binary packages of Papyros shell and necessary dependencies, along with some other Material Design apps. Instructions are available here.



Once the necessary dependencies are installed, you can build and install the Papyros shell as follows:

mkdir build; cd build
make && sudo make install

Running the shell

To run the shell from an existing desktop environment as a windowed shell or from a virtual terminal as a full Wayland compositor, run:


Using the SDDM theme

The SDDM theme for Papyros is installed along with the shell. To set it as the current theme, edit the /etc/sddm.conf file and edit the Current key under the [Theme] group to match:

# Current theme name

Now restart your computer and enjoy the new theme!


Papyros Shell is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.