Skip to content
a simple desktop shell based on Qt5 and KF5
C++ Shell CSS CMake
Branch: master
Clone or download
ffwff Merge pull request #9 from insanitywholesale/master
Improve ubuntu build dependencies
Latest commit e02720d May 24, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Use dex to open desktop files Mar 3, 2019
themes Add StretchMask option to mask out stretch Feb 13, 2019
.gitignore Add licensing Jul 23, 2017
.gitmodules Use libpulse directly instead of pamixer Feb 5, 2019
CMakeLists.txt Remove Qt5::Concurrent from dependency list (#4) Feb 13, 2019
LICENSE Create LICENSE Jan 29, 2019 Improve ubuntu build dependencies May 24, 2019
org.kde.plasmashell.desktop Hijack user's Plasma shell desktop file to launch Q::Shell Feb 6, 2019
qshell-init Update init scripts, stop pulseaudio thread on destructor Feb 6, 2019
qshell-session Update init scripts, stop pulseaudio thread on destructor Feb 6, 2019
qshell.desktop add xsession Jul 26, 2017
qshellctl update some Feb 2, 2019



a simple desktop shell based on KF5 and QT5, inspired by plasmashell and BE::Shell.

Build dependencies

You will need your distro's equivalent to:

  • extra-cmake-modules
  • Qt5 (Core, DBus, Widgets, X11Extras components)
  • KF5 (Config, KIO, WindowSystem components)
  • KF5Solid
  • Xlib
  • Pulseaudio

It is recommended to install KDE Plasma along side this as Q::Shell utilizes many of Plasma's features.

For Ubuntu/Debian-based systems, this command should be sufficient:

sudo apt install extra-cmake-modules qtbase5-dev libx11-dev libkf5crash-dev libkf5kio-dev libkf5solid-dev libkf5jobwidgets-dev libkf5textwidgets-dev libkf5bookmarks-dev libkf5xmlgui-dev libkf5itemviews-dev libkf5attica-dev libkf5sonnet-dev libkf5globalaccel-dev libkf5guiaddons-dev libkf5codecs-dev libkf5auth-dev libkf5dbusaddons-dev libkf5coreaddons-dev libkf5iconthemes-dev libkf5configwidgets-dev libkf5widgetsaddons-dev libkf5service-dev libkf5config-dev libkf5windowsystem-dev libqt5concurrent5 libpulse-dev libqt5x11extras5 libqt5x11extras5-dev

You'll also need dex installed if you want to open applications in the dash.

For Arch, use this:

sudo pacman -S extra-cmake-modules plasma-meta


mkdir build
cd build
cmake ..


You will need a config file for qshell to work, simply copy-paste one (and its corresponding stylesheet) to your ~/.config directory. To replace plasmashell with qshell, run the command:

kquitapp plasmashell; sleep 2; qshell


sudo make install

A Q::Shell session will appear on your display manager's session selection.

NOTE: it is currently required that KDE Plasma be installed as the session requires several Plasma-specific utilities.


You can’t perform that action at this time.