Layouts
A layout remembers where every window is, on every display. Bring it back by shortcut, menu, throw or automatically. You can keep five.
Point at an app in the menu to see its spot. Point at Restore to put everything back.
Save a layout
Arrange your windows, then save them in one of these ways.
| From | Do this |
|---|---|
| Tray menu | Layouts → Save Current Layout…. A notification confirms it with the number of windows. |
| Shortcut | Give Save Current Layout (save_layout) a key on the Keyboard Shortcuts page. |
| Settings | Settings → Layouts → Save current layout, then Save. |
- Each window's app, title, position, size, display and maximized state are saved.
- A new layout takes the first empty slot and its name (Layout 1, Layout 2 …). If all five are full, Settings opens so you can clear one.
- To capture a layout again, point at its row in Settings and click ⟳. Its name and options stay.
- While Settings is open, save with its Save current layout button rather than the tray menu or shortcut.
- Save snapped windows as their size
layout_save_presets - Default: on. A window still where an action such as Left Half put it is saved as that size, so it still fits after a resolution or taskbar change.
Restore a layout
Open the layout's apps, then use any of these.
| Way | How |
|---|---|
| Shortcut | Record one in the layout's ••• options, or give Layout 1 … Layout 5 (layout_1 … layout_5) a key on the Keyboard Shortcuts page. |
| Tray menu | Layouts → the layout → Restore name. |
| Settings | Click ▶ at the start of the layout's row on the Layouts page. |
| Throw | Pick the layout as a throw target. |
| Command line | tesserasnap.exe --action layout_1 (see Command line). |
| Automatically | When displays change, the PC wakes or an app opens. See Apply when…. |
Matching windows move to their saved places. Other apps' windows stay put unless the layout minimizes or closes them.
Place just one app
In the tray menu, each layout under Layouts lists its apps below Restore name.
- Point at an app to see where its window goes.
- Click it. Only that window moves.
Layout options
On Settings → Layouts, point at a layout, click •••, make your changes and click Save.
- Name
name - Default: empty (Layout N once it has windows). The label in the tray menu and action lists.
- Shortcut
layout_1 … layout_5 - Default: none. The same shortcut as Layout N on the Keyboard Shortcuts page.
Apply when…
- Display is connected
apply_when_displays - Default: off. Applies the layout when the number of connected displays changes to the one you pick, such as 2 displays.
- Display is disconnected
apply_on_display_removed - Default: off. Applies the layout whenever a display is unplugged.
- Waking from sleep
apply_on_wake - Default: off. Applies the layout about 4 seconds after the PC wakes, undoing any shuffling by Windows.
- Window opens
apply_on_open - Default: off. Sends a new main window of one of the layout's apps straight to its spot; dialogs are left alone.
Apply to…
- Front window only
frontmost_only - Default: off. Places only the front window, so one shortcut sends each app to its own spot.
- All windows beyond the first match
all_matches - Default: off. Each entry places every window it matches, such as every browser window to the right half.
Behavior
- Bring windows to the front
bring_to_front - Default: off. Brings each placed window to the front and focuses the first one.
- Launch closed or minimized apps
launch_missing - Default: off. Restores minimized windows and starts apps that aren't running (except Microsoft Store apps), then places their windows.
- Leave / Minimize / Close apps not in this layout
others - Default: Leave (
"leave"). When the whole layout applies, other apps' windows can instead Minimize ("minimize") or Close ("close"), as if you clicked their X.
Close never forces an app shut: unsaved work still prompts you. Pinned and stashed windows are never touched.
Windows in a layout
On Settings → Layouts, click ▸ on a layout to see a map of where its windows go.
- Click a window in the list to edit it, or click × to remove it.
- Change the fields below.
- Click Save.
To add a window, point at the layout, click + and fill in App.
- App
process - The program file, such as
code.exe, or*for any app. - Title: Loosely matches
title_match = "loose" - Default. Prefers the exact saved title, then one that starts the same, then any window of the app.
- Title: Any title
"any" - Any window of the app matches.
- Title: Contains the text
"contains" - The title contains your text, ignoring case, such as Inbox.
- Title: Matches the pattern
"glob" - The title matches your pattern, ignoring case (
*any text,?one character), such as* - Visual Studio Code. - Goes to
action - A size such as Left Half of the window's display, or Exact position below to use the frame.
- Maximized
maximized - Maximizes the window after moving it.
- Frame: X, Y, W, H
lefttoprightbottom - Position and size in pixels; with a size in Goes to, it only picks the display.
- Windows are matched by app, then title, so two browser windows each go to their own place.
- Each open window is used once. Extra windows of an app stay where they are.
- Snap ⊙ beside a window means one of your snap targets gives the same size.
Delete a layout
- On Settings → Layouts, point at the layout and click the bin icon twice.
- Click Save. Its shortcut goes with it; until then, Cancel brings it back.
Tips
- Save one layout per desk setup and set each to apply when its number of displays is connected.
- After rearranging your displays, save your layouts again.
- Export and import carries layouts to another PC. Check them there if its screens differ.