Skip to main content

​
Connection

var conn: otter_wayland.Connection = .{};
conn.callbacks = .{
    .on_output_added = onOutput,
    .on_seat_added = onSeat,
    .context = &app,
};
try conn.init();
Register globals before init completes. Dispatch until running is false.

​
Layer shell

Bar panels and overlays use zwlr_layer_shell_v1. Anchor presets live on Anchor:
  • top_bar, bottom_bar, left_panel, right_panel, fullscreen
Set Layer (background, bottom, top, overlay) per surface role.

​
XDG toplevel

var toplevel = otter_wayland.XdgToplevel.init(&conn, .{
    .on_configure = onConfigure,
    .on_close = onClose,
    .context = &state,
});
toplevel.bindListeners();
toplevel.setTitle("My window");
toplevel.setAppId("com.example.app");
on_configure receives logical size; 0 means client picks dimensions.

​
LayerPopup

Transient menus and tooltips: 
var popup = otter_wayland.LayerPopup.init(.{ .wl_shm = wl_shm, ... });
try popup.showWithScale(.menu, x, y, w, h, scale, drawCb, ctx);
popup.hide();
popup.processPendingHide();

​
Workspaces and toplevels

TypeRole
ExtWorkspaceManagerext_workspace_manager_v1 state
ForeignToplevelManagerActive window title and app_id
WorkspaceProviderUnified snapshot across compositor backends
HyprlandManagerHyprland IPC fallback
Subscribe with .subscribe(callback, context) and read snapshots after protocol events.