Expand description
Headless Wayland compositor and cursor rendering. Wayland backend: a headless Smithay compositor that stands in for a real display server.
frontend owns the compositor state machine, protocol handlers, and input routing.
cursor resolves Wayland cursor shapes to PNG images for the Python callback.
Modules§
- cursor
- Wayland cursor shape to PNG resolution and the cursor delivery worker.
Wayland cursor shape resolution: converts a
CursorImageStatusinto a PNG image buffer suitable for the Python cursor callback. Usesxcursorto load the system cursor theme and render the appropriate frame at the current scale. - dcclient
- Data-control clipboard client bridging a nested app compositor’s selection. Data-control CLIENT: the native clipboard bridge to a NESTED app compositor (labwc/kwin running under pixelflux).
- frontend
- Headless Smithay compositor, protocol handlers, and input routing. Headless Smithay compositor that stands in for a real display server so ordinary Wayland clients have somewhere to render — their composited output is exactly what the capture pipeline reads back and H.264-encodes. There is no monitor, KMS, or libinput in this process, so everything a desktop session normally receives from hardware — an output to map windows onto, a seat to deliver input to, a clipboard to share — this frontend has to synthesize itself.
- host
- Host-capture mode: capture/inject as a client of an external compositor.
Host-capture mode: pixelflux as a CLIENT of an external Wayland compositor
(e.g. labwc running
WLR_BACKENDS=headless), inverting the nested topology. - keymap
- Seat keymap ownership: base layout plus batched overlay keysym binding. Compositor-side keymap policy: one owner for the seat keymap.
- outclient
- Output-management client scaling a nested app compositor’s screens.
zwlr_output_management_v1client: sets the output scale of a nested session compositor, in-process rather than through awlr-randrfork. - vkclient
- Virtual-keyboard client for typing into a nested app compositor’s socket.
zwp_virtual_keyboard_v1client for typing Unicode text into a nested compositor’s socket. - wlclient
- Shared plumbing for outbound Wayland client connections. Shared plumbing for pixelflux’s outbound Wayland CLIENT connections (the virtual-keyboard typer and the data-control clipboard bridge, both talking to a nested app compositor): socket resolution, deadline-bounded round-trips so a wedged compositor turns into an error instead of a hang, and fd read/write helpers for clipboard pipes.