User guide
Getting the most out of LanesMac
Everything from your first launch to scripting your layout, in about ten minutes of reading.
01
Getting started
When LanesMac starts, it gathers the windows you already have open and lines them up side by side. A small indicator in the menu bar, such as “3 of 8”, tells you which window has focus and how many are on the strip.
Before you begin
- Switch LanesMac on in System Settings › Privacy & Security › Accessibility.
- Quit other window tools such as Rectangle, Magnet or Amethyst so shortcuts don't clash.
- Press ⌃⌥→ to move focus to the next window.
02
How the strip works
Normally, Mac windows pile up like sheets of paper, and grid tilers squeeze every window into the same screen. LanesMac does neither. Every window is a full-height column, and all the columns sit in a single row that is wider than your display.
A new window opens right after the one you're using. Nothing else changes size. To reach a window that's off-screen, move focus to it and the strip slides across.
Choose a width
Pin a column
03
Stacks and tabs
Some windows belong together, like two terminals or a simulator above its debug log. A stack puts two or three windows in the same column, one above the other.
- Make a stack. Press ⌃⌥S to join the column on the left, then again to add the next window, up to three. ⌃⌥[/] stacks into the left or right column directly.
- Move around inside it. ⌃⌥↑/↓ moves focus up and down. ⌃⌥⇧↑/↓ moves the window itself.
- Take a window out. ⌃⌥D pops it back into a column of its own. A stack needs at least two windows, so popping one out of a pair leaves two plain columns.
- Switch to tabs. ⌃⌥⇧T turns the stack into a tabbed column where each window gets the full height, and back again.
When an app won't shrink
04
Trackpad and mouse
Swipe sideways on the trackpad and the strip moves with your fingers, then settles on the nearest window.
Two-finger swipe
Scroll inside an app
Three- or four-finger swipe
Drag with the mouse
05
Multiple displays
Each display has its own strip, with its own focus and scroll position. Swiping on your MacBook moves only the MacBook's strip, and your external display stays exactly where it was.
Press ⌃⌥N to send the focused window to the next display, where it joins that display's strip.
06
Keyboard shortcuts
These are LanesMac’s default shortcuts. Every one starts with ⌃⌥ (Control + Option), and you can change any of them in Settings > Shortcuts.
Move focus
| Action | Shortcut |
|---|---|
| Focus left / right | ⌃⌥←/→or H / L |
| Focus up / down in a stack | ⌃⌥↑/↓or K / J |
| Focus the first / last window | ⌃⌥⌘←/→ |
| Jump to window 1 to 9 | ⌃⌥1…9 |
| Search windows | ⌃⌥Space |
| Overview of all windows | ⌃⌥O |
Move windows
| Action | Shortcut |
|---|---|
| Move the window left / right | ⌃⌥⇧←/→or H / L |
| Move the window up / down in its stack | ⌃⌥⇧↑/↓or K / J |
| Send to the next display | ⌃⌥N |
| Pin to the left edge (press again to unpin) | ⌃⌥P |
| Pin to the right edge (press again to unpin) | ⌃⌥⇧P |
| Float / tile again | ⌃⌥T |
Size
| Action | Shortcut |
|---|---|
| Cycle width (25 / 33 / 50 / 66 / 75%) | ⌃⌥R |
| Wider / narrower | ⌃⌥=/- |
| Taller / shorter (in a stack) | ⌃⌥⇧=/- |
| Even heights in a stack | ⌃⌥E |
| Centre the window | ⌃⌥C |
| macOS full screen / back | ⌃⌥F |
Stacks and tabs
| Action | Shortcut |
|---|---|
| Stack: join the column on the left, then add the next window (up to three) | ⌃⌥S |
| Pop out of the stack | ⌃⌥D |
| Stack into the left / right column | ⌃⌥[/] |
| Pop out to the left / right | ⌃⌥⇧[/] |
| Tabbed column / back | ⌃⌥⇧T |
LanesMac
| Action | Shortcut |
|---|---|
| Pause / resume LanesMac | ⌃⌥Q |
No key set yet
These actions have no default shortcut. You can add one in Settings › Shortcuts.
| Action | Also in |
|---|---|
| Fill the screen inside the strip / back | command full-width |
| Focus border on / off | menu bar menu, command focus-border |
| Dim inactive windows on / off | menu bar menu, command dim-inactive |
Trackpad and mouse
| Gesture | What it does |
|---|---|
| Two-finger swipe sideways | Scroll the strip. Hold ⌥ to scroll inside the app instead. |
| Three- or four-finger swipe | Also scrolls the strip, once you turn it on in Settings > Motion. |
| Drag a title bar | Move the window to another place in the strip, or drag it sideways out of its stack. |
| Drag a window's edge | Resize it. The column keeps the new width. |
07
Activating a license
LanesMac is a one-time payment for a lifetime license that works on one Mac. Includes all future updates, free. After the first launch you get 24 hours of free access with every feature included. After that, LanesMac needs a license.
After you buy, your license key arrives by email from Dodo Payments. To activate it:
- Click the LanesMac icon in the menu bar and choose Settings, or press ⌘, while LanesMac is active.
- Open Settings → License.
- Paste your key and click Activate.
Activation happens once online. After that, LanesMac works offline.
Moving to a new Mac
08
Command line and URLs
The lanesmac command-line tool lets you drive LanesMac from scripts and the terminal.
# Install the command (one time)
lanesmac install-cli
# Focus column 4
lanesmac focus --column 4
# Flag the focused column when tests finish
npm test && lanesmac notify --status success || lanesmac notify --status failure
# Save the current layout, then load it later
lanesmac workspace export ~/my-dev-session.json
lanesmac workspace load ~/my-dev-session.jsonYou can also trigger actions with lanesmac:// links, which is handy in scripts, Raycast or Alfred:
lanesmac://focus?app=Visual%20Studio%20Code