Catacomb - A Wayland Mobile Compositor

February 26, 2026 ยท View on GitHub

About

Catacomb is a Wayland compositor for Linux smartphones. It aims to provide responsive window management without cutting down on useful features.

Screenshots

Configuration

Catacomb is configured through IPC using catacomb msg.

Documentation for available configuration options is available under catacomb msg -h.

For persistent configuration or to launch applications on startup, Catacomb automatically executes ${XDG_CONFIG_HOME:-~/.config}/catacomb/initrc.

You can find an example configuration here.

Permissions

To allow Catacomb to listen for orientation changes using iio-sensor-proxy, it is necessary to grant a Polkit permission.

The rules to grant this permissions to users in the catacomb group can be found in the rules directory.

Controls

Open application overviewMinimize everythingClose applications
open overviewminimizeclose
Double-tap to cycleTiling