Getting started

Settings

The Settings window holds every TesseraSnap option. This page covers the window and its Behavior and App Settings pages.

Open the Settings window

Use any of these; all but the first work with the tray icon hidden.

Click the tray icon and choose Settings.
In the Start menu, choose TesseraSnap Settings.
Start TesseraSnap again while it is running.
Run tesserasnap.exe --settings (see Command line).

How the window works

Save applies changes at once, with no restart, and writes config.toml.
Cancel or Esc closes without changes.
Shortcuts pause while it is open, so you can record one TesseraSnap already uses.
A number outside its range is pulled back in when you save.

Pick a page from the list on the left:

Page	Guide
Cursor Movement	Cursor movement
Keyboard Shortcuts	Keyboard shortcuts
Snap Areas	Snap areas
Custom Sizes	Custom sizes
Layouts	Layouts
Quick Throw	Cursor movement
Stash	Stash
Pin Mode	Pin Mode
Menu	Menu & icon
Behavior	below
App Settings	below

Behavior

Each group on this page has an (i) button that explains it.

Repeated shortcuts

Pressing a half, quarter or third shortcut again repeat_mode: Default: Cycles sizes. What a repeat press on the same window does (options below).
After the last size, continue on the next display cycle_displays: Default: off. With Cycles sizes, the press after the last size moves on to the next display.

Option	A repeat press
Cycles sizes	Halves step through ½, ⅔ and ⅓; thirds walk across the screen (Repeat a shortcut).
Does nothing new	Same size every time; custom sizes skip their “Then” action.
Moves it to the next display	Same spot on the next display.

Maximize

Maximize uses the real Windows maximize state native_maximize: Default: on. Off, Maximize fills the screen with a normal window you can still drag and resize.

Gaps

Gap between windows (px) gap: Default: 0. Range 0 to 200. Space between windows placed side by side.
Gap at screen edges (px) edge_gap: Default: same as between windows. Range 0 to 200. Untick Same as between windows to set it separately (in the file, -1 means the same as gap).

Sizes

Larger / smaller / nudge step (px) resize_step: Default: 40. Range 1 to 500. Step for Larger, Smaller, the width and height actions, and nudges.
Almost maximize size (%) almost_maximize_fraction: Default: 90. Range 30 to 100. Almost Maximize's width and height, as a share of the screen.

Mouse pointer

Move the cursor to the window after it moves move_cursor_with_window: Default: off. After a shortcut or tray menu command moves a window, the pointer jumps to its middle.

Ignored programs

Ignored programs ignored_processes: Default: empty. Programs TesseraSnap never moves: type a file name from Task Manager → Details, such as game.exe, and press Enter.

App Settings

Startup

Launch TesseraSnap when I sign in launch_at_login: Default: on. Starts TesseraSnap when you sign in to Windows; it applies without Save.

Windows Snap

Pause Windows Snap while TesseraSnap is running snap.disable_windows_snap: Default: on. Turns Windows' own Snap off while TesseraSnap runs and back on when it quits (see Getting started).

Accent color

Pick a color you can see well: the footprint uses it to show where a window will land.

Accent (Pro) accent: Default: Blue. Eight colors (blue, green, red, orange, purple, teal, pink, graphite), or any color from the rainbow circle.

It colors the footprint, snap targets, the throw's target cursor, tray menu pictures, the tray icon and Settings.
Apply or Save makes a new color live outside Settings.
Without Pro, TesseraSnap uses blue and brings your color back when Pro is active.

Appearance and tray icon

Theme theme: Default: Match Windows. Light or dark for Settings and the tray menu; Light and Dark override Windows.
Tray icon tray_icon: Default: In the accent color. Other choices are White or black, to match the taskbar, White and Black; all work without Pro.
Hide the tray icon hide_tray_icon: Default: off. TesseraSnap keeps running but shows no notices; open Settings from the Start menu.

Updates

Check for updates… asks tesserasnap.com for a newer version; click the notice to open the download page.

Check for updates automatically check_updates: Default: off. Checks at most once a day and shows one notice per new version.

Checks run only when you ask and download one small file naming the newest version (privacy policy).
In the Microsoft Store version, the Store handles updates and this section shows your version.

TesseraSnap Pro

Your status (Pro, the trial and its days left, or the free version) shows at the bottom of the Settings sidebar, with a Buy Pro button until you have a license. To activate a key, paste it on App Settings and click Activate. See Purchase & activation.

Back up or move your settings

Export writes every setting, layouts included, to one file.

Click Export settings… and save the file to a USB stick or a synced folder such as OneDrive.
On the other PC, click Import settings… and pick the file. It applies at once.

Note Import replaces all your settings. Check saved layouts on a PC with different screens.

Keyboard shortcuts

Allow any shortcut in the recorder allow_any_shortcut: Default: off. Accepts keys without Ctrl, Alt or Win, such as F5; they then stop working in other apps.

Restore all defaults… resets every setting except Launch TesseraSnap when I sign in. Confirm with Restore defaults, then click Save.

About

Shows your version and your config file's path.

Open config file opens config.toml in your default editor (see Config file).
Open log folder opens the folder with tesserasnap.log.
Remove activation frees your license key from this PC before you move to a new one. It shows once a key is active.