cage

Run an application in kiosk mode

$ cage application

$ cage -- application arguments

$ cage -d application

$ cage -s application

$ cage -h

cage [options] [--] application [arguments]

cage is a Wayland kiosk compositor that runs a single application in fullscreen mode. It is designed for kiosk deployments, digital signage, or any situation where you want to run a single application without a full desktop environment.

-d

Disable window decorations (can lock you out of terminal)

Allow switching virtual terminals with Ctrl+Alt+F2, etc.

Rotate the output (0, 90, 180, 270 degrees)

Display help information

Display version information

Separator for application arguments

Without the -s option, you cannot switch to other virtual terminals. Using -d without a way to exit the application can lock you out. Cage requires a working Wayland environment.

cage was developed as a lightweight kiosk compositor for Wayland, named after the caged display concept in kiosk mode deployments.

weston(1), sway(1), gamescope(1)