mirror of https://github.com/cage-kiosk/cage.git synced 2025-10-29 05:40:19 -04:00

A Wayland kiosk

Find a file

Jente Hidskes ddead86366 output: set pointer to cg_output in wlr_output->data This will be used later in the layer shell implementation.		2021-12-23 18:53:11 +01:00
.github/workflows	Upgrade to wlroots 0.15	2021-12-21 21:53:28 +01:00
contrib	Include release scripts	2021-04-16 14:34:57 +02:00
protocols	Add wlr-layer-shell-unstable-v1 protocol	2021-12-23 18:51:04 +01:00
.clang-format	Add clang-format file	2020-02-18 21:20:23 +01:00
.clang-format-ignore	Move to GitHub actions	2021-12-19 11:12:19 +01:00
cage.1.scd	man: indent with tabs	2020-07-16 16:25:19 +02:00
cage.c	Add initial layer shell skeleton	2021-12-23 18:51:39 +01:00
config.h.in	cage: add -v argument to print version	2020-01-26 18:18:49 +01:00
idle_inhibit_v1.c	Apply clang-format	2020-02-18 21:20:23 +01:00
idle_inhibit_v1.h	Replace all wayland-server.h includes with wayland-server-core.h	2019-12-20 17:16:53 +01:00
layer_shell_v1.c	Add initial layer shell skeleton	2021-12-23 18:51:39 +01:00
layer_shell_v1.h	Add initial layer shell skeleton	2021-12-23 18:51:39 +01:00
LICENSE	Refactor surface damaging and rendering code	2020-01-11 17:07:33 +01:00
meson.build	Add initial layer shell skeleton	2021-12-23 18:51:39 +01:00
meson_options.txt	Add man page. (#141 )	2020-05-31 15:14:18 +02:00
output.c	output: set pointer to cg_output in wlr_output->data	2021-12-23 18:53:11 +01:00
output.h	output: add usable area	2021-12-23 18:52:34 +01:00
README.md	Add man page. (#141 )	2020-05-31 15:14:18 +02:00
seat.c	fixed typo	2021-12-21 21:56:56 +01:00
seat.h	Use scene-graph helpers for sub-surfaces	2021-12-21 21:53:28 +01:00
server.h	Add initial layer shell skeleton	2021-12-23 18:51:39 +01:00
util.c	restore direct libm dependency (fixes #222 )	2021-12-22 07:09:09 +01:00
util.h	Upgrade to wlroots 0.15	2021-12-21 21:53:28 +01:00
view.c	view: position using the output's usable area	2021-12-23 18:53:11 +01:00
view.h	view: position using the output's usable area	2021-12-23 18:53:11 +01:00
xdg_shell.c	Use wlr_scene_xdg_surface_create for popups	2021-12-21 21:53:28 +01:00
xdg_shell.h	Use wlr_scene_xdg_surface_create for popups	2021-12-21 21:53:28 +01:00
xwayland.c	Use scene-graph for damage tracking	2021-12-21 21:53:28 +01:00
xwayland.h	Use scene-graph for damage tracking	2021-12-21 21:53:28 +01:00

README.md

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

Please see LICENSE on GitHub.