Cage
| Project Name | Stars | Downloads | Repos Using This | Packages Using This | Most Recent Commit | Total Releases | Latest Release | Open Issues | License | Language |
|---|---|---|---|---|---|---|---|---|---|---|
| Sway | 12,092 | 3 days ago | 814 | mit | C | |||||
| i3-compatible Wayland compositor | ||||||||||
| Hyprland | 6,823 | 14 hours ago | 205 | bsd-3-clause | C++ | |||||
| Hyprland is a highly customizable dynamic tiling Wayland compositor that doesn't sacrifice on its looks. | ||||||||||
| Waybar | 3,341 | 3 days ago | 406 | mit | C++ | |||||
| Highly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada: | ||||||||||
| Wayfire | 1,729 | 10 days ago | 316 | mit | C++ | |||||
| A modular and extensible wayland compositor | ||||||||||
| Dwl | 1,478 | 6 days ago | 32 | other | C | |||||
| dwm for Wayland | ||||||||||
| Awesome Wayland | 1,143 | 5 months ago | 5 | cc0-1.0 | ||||||
| A curated list of Wayland code and resources. | ||||||||||
| Smithay | 1,099 | 21 hours ago | 4 | July 25, 2021 | 110 | mit | Rust | |||
| A smithy for rusty wayland compositors | ||||||||||
| Papyros Shell | 975 | 7 years ago | 77 | gpl-3.0 | C++ | |||||
| :shell: The desktop shell for Papyros, built using QtQuick and QtCompositor as a compositor for Wayland. | ||||||||||
| Grim | 757 | a year ago | 10 | mit | C | |||||
| Grab images from a Wayland compositor | ||||||||||
| Cage | 700 | 2 months ago | n,ull | mit | C | |||||
| A Wayland kiosk | ||||||||||
Cage: a Wayland kiosk
This is Cage, a Wayland kiosk. A kiosk runs a single, maximized application.
This README is only relevant for development resources and instructions. For a description of Cage and installation instructions for end-users, please see its project page and the Wiki.
Release signatures
Releases are signed with 6EBC43B1 and published on GitHub.
Building and running Cage
You can build Cage with the meson build system. It requires wayland, wlroots, and xkbcommon to be installed. Optionally, install scdoc for manual pages. Note that Cage is developed against the latest tag of wlroots, in order to not constantly chase breaking changes as soon as they occur.
Simply execute the following steps to build Cage:
$ meson build
$ ninja -C build
By default, this builds a debug build. To build a release build, use meson build --buildtype=release.
Cage comes with compile-time support for XWayland. To enable this,
first make sure that your version of wlroots is compiled with this
option. Then, add -Dxwayland=true to the meson command above. Note
that you'll need to have the XWayland binary installed on your system
for this to work.
You can run Cage by running ./build/cage APPLICATION. If you run it from
within an existing X11 or Wayland session, it will open in a virtual output as
a window in your existing session. If you run it at a TTY, it'll run with the
KMS+DRM backend. In debug mode (default build type with Meson), press
Alt+Esc to quit. For more configuration options, see
Configuration.
Cage is based on the annotated source of tinywl and rootston.
Bugs
For any bug, please create an issue on GitHub.
License
Copyright 2018-2020 Jente Hidskes [email protected]