🐚 The desktop shell for Papyros, built using QtQuick and QtCompositor as a compositor for Wayland.
Branch: develop
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
3rdparty Initial progress on a D-Bus session manager interface Jun 22, 2015
cmake fix: Update dependencies on Qt5WaylandClient and GreenIsland Jan 29, 2016
data Create a proper session launcher for the compositor Jun 21, 2015
decorations fix(decorations): Use Roboto for the window decorations Jan 1, 2016
headers Create a proper session launcher for the compositor Jun 21, 2015
modules feat: Use papyros-terminal as a default app instead of Konsole Jan 31, 2016
sddm chore: Update Material imports to Material 0.2 Jan 17, 2016
session fix(panel): Fix some issues with the process launcher and desktop files Jan 31, 2016
.gitignore Replace qmake files with cmake in .gitignore Jul 29, 2015
CHANGELOG.md [Desktop] Improve the hot corners Feb 23, 2015
README.md chore: Fix a mistake in the README Dec 28, 2015


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.