User guideWayseer 0.28.3Contents

Windows

Wayseer can show the same world in more than one window: Topology on one screen and Grid on another, or a city in Geo beside the incident in Stream.

A new window opens showing what the window you opened it from shows: the same lens, place, focus and filter. From then on each window keeps its own:

• lens and camera, so panning or zooming one leaves the others where they are
• focus, history (Backspace goes back in that window only) and filter
• open panels: sources, license, Compare's settings

Every window shares:

• the world and its modules, fetched once however many windows show them
• the time window: scrubbing in one moves every window's time bar
• the selection, the palette's history, the language model's conversation and the actions
• the license and the theme

A question to the language model works in the window it was asked in: its moves happen there, and its answer shows in that window's narration panel, even if you click another window while it answers. Closing that window cancels the question. The actions and confirm panels show in the window with the keyboard, and move with it. A control client names a window by number.

Keys go to the window with the keyboard. Each window draws at its own display's scale, so a window dragged from a 1× monitor to a 2× one stays sharp. A window with nothing moving in it draws nothing, while another flies.

Linked selection and following

The selection belongs to every window: Shift-click a host in Geo and Topology rings it too.

>window.follow has the window you are in follow the focus of the window you used before it. Focus a host in Geo, and a Topology window following it flies there; clear the focus there, and the follower clears its focus too, leaving the selection and filter alone. The strip says "following window 2" while it lasts. Run >window.follow again to stop; the window stays where it is.

Windows are numbered in the order they opened. A window cannot follow itself, nor one that already follows it, however many windows apart. Closing the window followed stops the following. Only the focus is followed: each window keeps its own lens, camera and filter.

Closing a window with its title bar's close button, or Ctrl+Shift+W, closes only that window. Closing the last one quits, as Ctrl+Q does at any time.

On macOS the keys are ⇧⌘N to open a window, and ⌘W or ⇧⌘W to close one. Closing the last window quits there too, rather than leaving the app running with no window, and ⌘Q quits at any time. On Windows, Alt+F4 closes the window it is pressed in. Each window is its own window to the desktop, not a tab.

Windows come back

The windows open when you quit come back at the next start, each on the lens it showed, at its size and following the window it followed. Where a window sits on screen is left to your desktop. A window that was on Detail or Compare comes back on Topology, as its focus is not kept. wayseer --one-window starts with only the first, keeping the others for the next start unless you open another window before quitting.

They are kept in windows.yaml beside your other state (where files are kept): each window's lens name, size and the number of the window it follows, and nothing about what it showed. If the file cannot be read, Wayseer starts with one window and writes a new file at quit.

The license

One window is always free. More need a license key (License and keys). Without one, >window.new opens nothing: the status line says "a license key unlocks more than one window" and the license panel opens. Only the first window open at quit comes back, and the strip says how many did not. The others stay in windows.yaml for when a key is added.

A key added applies at once. Removing the key closes no window that is open; it stops new ones opening until a key is added again.