A library for using the Layer Shell Wayland protocol with GTK4. With this library you can build desktop shell components such as panels, notifications and wallpapers. You can use it to anchor your windows to a corner or edge of the output, or stretch them across the entire output. This Library is compatible with C, C++ and any language that supports GObject introspection files (Python, Vala, etc).
To report a crash or other problem using this library open a new issue on Github. Try to include a minimum reproducer if possible (ideally in C). DO NOT REPORT GTK4 LAYER SHELL BUGS TO UPSTREAM GTK. If you can reproduce the problem without including or linking to the gtk4-layer-shell library at all then and only then report it to GTK instead of here.
This library only works on Wayland, and only on Wayland compositors that support the Layer Shell protocol. Layer shell is supported on:
--add-wayland-extension zwlr_layer_shell_v1
)Layer shell is not supported on:
gtk4-layer-demo
is built if examples are enabled. It's useful for testing layer shell support in compositors. Its code can be found in examples/demo/.
The easiest way to build against GTK Layer Shell is to use the gtk-layer-shell-0
pkg-config package. Refer to your build system or the pkg-config docs for further instructions. examples/simple-example.c is a minimal complete app written in C. If you link against libwayland, you must link libwayland after gtk4-layer-shell. See linking.md for details.
examples/simple-example.py contains sample Python code.
examples/simple-example.lua contains sample Lua code. It uses FFI which requires LuaJIT.
examples/simple-example.vala contains a minimal working Vala app.
@pentamassiv maintains safe Rust bindings and the crates.io crate. Rust examples can be found here.
mswiger maintains Ruby bindings which are published to RubyGems.
$ meson setup -Dexamples=true -Ddocs=true -Dtests=true build
$ ninja -C build
$ sudo ninja -C build install
$ sudo ldconfig
introspection
enabled: GObject introspectiondocs
enabled: GTK Doctests
enabled: Python3vapi
enabled: Valasmoke-tests
enabled: LuaJITsmoke-tests
enabled: LGITo install these dependencies on Ubuntu 18.04 and later:
sudo apt install meson ninja-build libwayland-dev libgtk-4-dev gobject-introspection libgirepository1.0-dev gtk-doc-tools python3 valac
To install on Arch Linux:
pacman -S --needed meson ninja gtk4 wayland gobject-introspection libgirepository gtk-doc python vala
-Dexamples
(default false
): If to build the example C apps; gtk4-layer-demo is installed if examples are built; The Vala example is never built with the rest of the project-Ddocs
(default false
): If to generate the docs-Dtests
(default false
): If to build the tests-Dsmoke-tests
(default: true
): If to test that all examples can run (disable if you don't want to install the various languages and dependencies required)-Dintrospection
(default: true
): If to build GObject Introspection data (used for bindings to languages other than C/C++)-Dvapi
(default: true
): If to build VAPI data and Vala example. The VAPI file allows this library to be used in Vala. Requires -Dintrospection=true
ninja -C build test
100% MIT (unlike the GTK3 version of this library which contained GPL code copied from GTK)