2018-11-22 19:59:06 +01:00
|
|
|
# Cage: a Wayland kiosk
|
|
|
|
|
|
|
|
|
|
This is Cage, a Wayland kiosk. A kiosk runs a single, maximized
|
|
|
|
|
application.
|
|
|
|
|
|
2019-01-02 21:06:56 +01:00
|
|
|
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](https://hjdskes.nl/projects/cage).
|
2018-11-22 19:59:06 +01:00
|
|
|
|
|
|
|
|
## Building and running Cage
|
|
|
|
|
|
2018-11-25 22:11:08 +01:00
|
|
|
You can build Cage with the [meson](https://mesonbuild.com/) build
|
|
|
|
|
system. It requires wayland, wlroots and xkbcommon to be
|
|
|
|
|
installed. Simply execute the following steps to build Cage:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ meson build
|
|
|
|
|
$ ninja -C build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
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`.
|
2018-11-22 19:59:06 +01:00
|
|
|
|
|
|
|
|
Cage is based on the annotated source of
|
|
|
|
|
[TinyWL](https://gist.github.com/ddevault/ae4d1cdcca97ffeb2c35f0878d75dc17).
|
|
|
|
|
|
|
|
|
|
## Bugs
|
|
|
|
|
|
|
|
|
|
For any bug, please [create an
|
|
|
|
|
issue](https://github.com/Hjdskes/cage/issues/new) on
|
|
|
|
|
[GitHub](https://github.com/Hjdskes/cage).
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
Please see
|
|
|
|
|
[LICENSE](https://github.com/Hjdskes/cage/blob/master/LICENSE) on
|
|
|
|
|
[GitHub](https://github.com/Hjdskes/cage).
|
|
|
|
|
|
2019-01-02 20:58:39 +01:00
|
|
|
Copyright © 2018-2019 Jente Hidskes <hjdskes@gmail.com>
|
