Troubleshooting

Grid Screen cannot arrange windows

Check the Session Type, EWMH Support, and XRandR values in Settings or the system status panel. Arrangement requires the X11 moving-window path and eligible windows. A Wayland session intentionally reports an arrangement-disabled error.

No windows appear

The catalog excludes windows without an app name, windows that are not movable or resizable, fullscreen windows, and platform-specific non-user windows. On X11, docks, menus, toolbars, notifications, utility windows, and splash windows are filtered as well.

Use the refresh action after changing workspace or application state. Workspace changes clear assignments because the catalog may no longer represent the same set of windows.

A window disappeared before Arrange

The Rust orchestrator validates every assignment immediately before movement. If a window was closed or became ineligible, the request fails rather than moving a partial set.

An arrangement is offset or clipped

The X11 adapter reads frame extents and the arrange pipeline adjusts the requested rectangle for the window frame. Window-manager behavior can still affect the result. Check the selected work area, gap, margin, and EWMH status.

Need a diagnostic report

Use the diagnostics action exposed by the application or inspect ~/.config/grid-screen/logs/grid-screen.log. The report is local text; it contains environment capability values, not a remote upload.