kaolti / phantomat

# Phantomat
A zoomable, infinite-canvas window manager for Hyprland. Every window lives
on one endless plane instead of in workspaces. Press a key and the view pulls
back through a curved lens so you can see everything at once, then type a few
letters and fly straight to the window you want.
The name comes from Stanisław Lem's *Summa Technologiae*, where a phantomat
is a machine that builds a whole world around the person inside it.
Made on Omarchy with Hyprland 0.56. Built on
hyprland-scroll-overview
by yayuuu (see Credits).
## What it does
- **One canvas for everything.** Windows float freely on a single 2D plane
 instead of in workspaces. Pan, zoom and place windows anywhere.
- **Your screens are one desk.** Side by side on the canvas as they stand on
 your desk, moving together: a window can sit across the seam, and dragging
 it from one screen to the other is one continuous move.
- **Type to find.** `SUPER + CTRL + G` zooms out with a search bar already
 listening. Type part of a title or app name and the camera glides to the
 best match; `Enter` lands on it at full size, `Esc` takes you back.
- **Keyboard first.** Jump to the nearest window in any direction, nudge
 windows around, bring a window to where you are, frame one or fit them all,
 tidy everything up by app, undo and redo.
- **Recent windows.** `ALT + TAB` flips between windows most recently used
 first; hold `ALT` to see the list.
- **Fill or go fullscreen.** `SUPER + T` makes a window fill its screen and puts
 it back. Fullscreen (`SUPER + F`, a video, a game) takes over just the screen
 the window is on; the other screens keep the canvas.
- **All your apps.** Wayland and X11 apps alike, games under Wine and Proton
 included: menus, drags, fullscreen and full frame rate work as on a normal
 desktop.
- **It remembers.** Windows return to their spots after a restart.
- **Tune it live.** `CTRL + ,` in the zoomed-out view opens a tuner for the
 lens, blur, grid, parallax, HUD size, type, colors and more, and you see
 each change as you make it.
- **Looks the part.** A barrel lens with optional edge blur, vignette and
 color fringe, a parallax wallpaper, a dotted grid, a minimap and a
 monospace HUD in the accent color of your choice.
## Install
You need Hyprland 0.56 or newer with its Lua config (`~/.config/hypr/hyprland.lua`,
which Omarchy uses), GCC 15 or newer, and Hyprland's development files. On
Arch or Omarchy:
 [code] 
The installer builds the plugin, puts it in `~/.local/share/spatial-overview/`,
copies the default settings to `~/.config/hypr/spatialoverview.lua` (it never
overwrites yours), adds two marked lines to your `hyprland.lua` (after making a
backup), and loads it right away. Then press `SUPER + CTRL + G`.
Phantomat used to be called Spatial Overview, and inside it still is: the
settings file, the `hl.plugin.spatialoverview` actions and the
`hyprctl spatialoverview` command keep that name, so configs from before the
rename keep working.
**After a Hyprland update**, t