Skip to content
A library to create panels and other desktop components for Wayland using the Layer Shell protocol
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo Add more command line arguments Apr 15, 2019
src Resize window even if we don't get a configure event Apr 17, 2019
COPYING Add files required by autotools Mar 25, 2019

GTK Layer Shell

GTK Layer Shell demo screenshot

A library to write GTK applications that use Layer Shell. Layer Shell is a Wayland protocol for desktop shell components, such as panels, notifications and wallpapers. You can use it to anchor your windows to a a corner or edge of the output, or stretch them across the entire output. This library only makes sense on Wayland compositors that support Layer Shell, and will not work on X11. Please open issues for any bugs you come across.

To install

  1. Clone this repo
  2. Make sure gtk3 development packages and autotools are installed
  3. Run ./
  4. Run make
  5. Run sudo make install

To use

  • gtk-layer-demo is installed with this library. Its UI exposes all features of the library, and it's useful for testing layer shell support in compositors
  • gtk-layer-shell.h has everything you need to use Layer Shell in a GTK app
  • example/example.c is a minimal working app
  • demo/ contains a more complex app
  • The easiest way to build is to use the gtk-layer-shell-0 pkg-config package. Refer to your build system or the pkg-config docs for further instructions
You can’t perform that action at this time.