phosphor-placement

Window-zone tracking, floating state, auto-snap, and resnap.

Core business logic for zone-based window management. Tracks which windows are in which zones, handles floating and unfloating, auto-snaps new windows to their last-used zone, resnaps when layouts or screens change, rotates windows between zones, and answers empty-zone queries for snap-assist. The daemon owns a WindowTrackingService instance and exposes it over D-Bus, so any compositor plugin gets this logic without linking the library. The daemon decides, the plugin applies.

Full API →

Key types

WindowTrackingService
Zone assignments, floating state, auto-snap, resnap, rotation.
IGeometryResolver
Interface a consumer implements to resolve gaps and padding for the active screen.
PlacementConfig
Value struct for runtime config; replaces direct ISettings coupling.

Dependencies

See also

phosphor-engine
Implements IWindowTrackingService and related engine service contracts.
phosphor-snap-engine
Reads WindowTrackingService for manual-mode placement decisions.
phosphor-tile-engine
Reads WindowTrackingService for autotile placement decisions.

References