8edaa54faf
Some apps like RetroArch will quit and fork itself to switch modes (like from the menu to a loaded core). This means that for a very short period of time we have no view available for Wayland. Right now, Cage doesn’t actually exit when it does this terminate, so you get this kind of zombie child process that is running but not showing anything on the screen because there is no compositor. The solution I have here is to just keep Cage’s Wayland server running to avoid this issue. I’m open to other idea, but this seems sane to me. Perhaps an alternative is to check if the process is still alive when this happens, if not then we can do the quitting behavior. In addition, we could make this an option if some users don’t want this behavior. |
||
|---|---|---|
| .builds | ||
| docs | ||
| cage.c | ||
| config.h.in | ||
| idle_inhibit_v1.c | ||
| idle_inhibit_v1.h | ||
| LICENSE | ||
| meson.build | ||
| meson_options.txt | ||
| output.c | ||
| output.h | ||
| README.md | ||
| render.c | ||
| render.h | ||
| seat.c | ||
| seat.h | ||
| server.h | ||
| util.c | ||
| util.h | ||
| view.c | ||
| view.h | ||
| xdg_shell.c | ||
| xdg_shell.h | ||
| xwayland.c | ||
| xwayland.h | ||
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.
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. 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
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. To build a release
build, use meson build --buildtype=release.
For more information, see the docs/ folder.
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 dev@hjdskes.nl