Skip to content

TESTING.md

Latest commit

 

History

History
74 lines (68 loc) · 5.64 KB

TESTING.md

File metadata and controls

74 lines (68 loc) · 5.64 KB
Raw

Untangler manual test matrix

Run in a nested shell (dbus-run-session -- gnome-shell --nested --wayland) or a real session. Host verified: GNOME Shell 46 / Ubuntu 24.04.

Keyboard actions

  • Every action in the table snaps the focused window correctly
  • Repeated press cycles ½ → ⅔ → ⅓ (halves) and ¼ → ⅙ (quarters), wrapping
  • Pressing a different action resets the cycle
  • Manually moving/resizing a window resets its cycle and invalidates Restore
  • Restore returns the window to pre-snap geometry
  • Gaps: set outer=10, inner=8 — Left+Right half tile with an 8 px seam
  • Gaps at 128 px on a small monitor: snaps stay usable, nothing invalid applied
  • Min-size app (GNOME Calculator): snap to a small third — window re-centers within the zone
  • CSD app (Text Editor), XWayland app (GDK_BACKEND=x11 gedit): frame-rect snapping correct
  • Fixed-size window: resize actions do nothing; Center and Next Display still work
  • Maximized window: any snap unmaximizes first, no race/flicker
  • Maximize shortcut on a can't-maximize window: no-op
  • Two monitors: Next/Previous Display preserves relative size and wraps; work areas respected at different scales
  • Rapid Maximize→Restore (and Maximize→snap) on Wayland: Restore still returns the pre-maximize frame (validates the synchronous maximize-flag assumption)

Drag snapping

  • Replace mode: gsettings get org.gnome.mutter edge-tiling is false while enabled, restored on disable
  • Left/right edge: top band → quarter, middle → half, bottom band → quarter — preview appears, glides between zones
  • Bottom edge thirds; top-center → maximize; 24 px corners → quarters
  • Ctrl (default) held: halves become two-thirds, quarters become sixths
  • Modifier-only mode: zones appear only with modifier held; native tiling still works without it
  • Modifier-only mode: hold the modifier and drop in a zone that overlaps native tiling (left edge, middle band) — check for double-snap/flicker races with GNOME's native tiling and that Restore returns to the true pre-drag frame
  • Esc during drag: preview hides, no snap
  • Drop outside any zone: plain move, no snap
  • Drag across monitor boundary: preview jumps to the other monitor's work area
  • Fixed-size window: dragging shows no zone/pair previews at all
  • Restore after a drag-snap returns pre-drag size
  • Switch drag snapping to Off DURING a drag: preview vanishes, drop is a plain move (native edge tiling may claim edge drops again immediately)
  • Change gaps during a drag: the preview reflects the new gaps within a tick
  • Toggle "show zone preview" off during a drag: preview hides immediately
  • While Replace mode is active, run gsettings set org.gnome.mutter edge-tiling true externally: Untangler logs "adopting" and stops claiming the setting; disable no longer overwrites it
  • Slow/heavy client (e.g. LibreOffice): snap lands correctly even when the first read-back sees stale geometry (bounded retry)
  • Pair drop while closing the target window: no half-applied layout (either full pair or plain move)
  • Drop a window at exactly its pre-drag position inside an edge zone: reads as cancel (known Esc-heuristic limitation), no snap

Lifecycle

  • enable → use → disable → re-enable ×10, then check journalctl /usr/bin/gnome-shell -b | grep -i untangler — no leaked source/actor warnings
  • After disable: all shortcuts inert, no preview widget, edge-tiling restored

Pair tiling

  • Drop A onto the middle of B: both become left/right halves; A on the side of B where dropped; preview showed both rects (B's dimmer)
  • Same drop with Ctrl held: A two-thirds, B one-third
  • Drop near B's edge (outside its central 50%): plain move, no pair
  • Pointer in an edge band while over B: edge zone wins, single preview
  • B maximized: pair-tile unmaximizes and tiles it
  • B non-resizable: plain move (no pair preview)
  • Restore is session-original: it returns each window to its geometry from before Untangler's current placement chain (a manual move re-baselines); previously-maximized windows re-maximize
  • pair-tile-mode = With modifier: pair only while Ctrl held (halves only, no ⅔ variant)
  • drag-snap-mode = Modifier-only: Ctrl gates zones AND pair; releasing Ctrl mid-drag clears the pair preview
  • Esc during drag while the pair preview is visible: no snap, both windows unchanged
  • Two monitors: dropping on a window on the other monitor tiles within that monitor's work area
  • Footprint split: with left/right halves in place, drop a third window onto the middle of one half — that half splits into stacked quarters; the other half untouched
  • Drop position picks the end: drop high in the half → new window on top; drop low → bottom
  • Ctrl during a footprint drop (Always mode): new window gets ⅔ of the footprint
  • Drop onto a snapped quarter: splits it side-by-side into eighths (recursion)
  • After a shell restart, drop onto a keyboard-snapped half: still splits (stateless geometric match)
  • Free-floating target: still pairs as whole-screen halves

Top-bar indicator

  • Icon appears on enable, disappears on disable (and on show-tray-icon off, live)
  • Menu lists all 17 actions in 5 groups plus Preferences…
  • Clicking an action snaps the window that was focused before the menu opened
  • Shortcut hints match the Shortcuts page, including after a rebind (reopen the menu)
  • Menu click with no open windows: no-op, no log spam
  • Preferences… opens the prefs window
  • Closing the target window while the menu is open, then clicking an action: no-op, no crash