steppewm

steppewm [-c config.lua]

steppewm is a stacking (not tiling) wlroots compositor: overlapping windows, titlebars, a taskbar, Alt-Tab, workspaces, snapping, a system tray, layer-shell, session lock, and multi-monitor. It ships a set of classic IceWM pixmap themes and Lua configuration.Build with Meson against wlroots 0.18–0.20, wayland, xkbcommon, libinput, lua 5.4, pixman, and cairo. Optional: libpulse (volume OSD), sdbus-c++ (tray), librsvg. Arch: AUR steppewm-git.XWayland is optional via xwayland-satellite. Wallpaper, idle, and output tools are the usual wlr stack (swaybg, swayidle, wlr-randr, wlopm).

-c file

Config path. Default is `$XDGCONFIGHOME/steppewm/config.lua` (`~/.config/steppewm/config.lua`).

Copy the example config.lua from the source tree. Theming and the IceWM theme converter are documented in doc/steppewm.md. A `.desktop` session file is installed as steppewm.desktop.

Wayland only. Needs a working GPU/GBM stack like other wlroots compositors. Not a drop-in X11 IceWM replacement; X11 apps need xwayland-satellite. Pre-1.0; config keys can still change.

Written by uncognic to fill the gap of a small IceWM-like compositor on Wayland.

hyprland(1), sway(1), niri(1)

Source code