melreusthe rectangle field manual
134 answers

Questions, answered directly

Grouped by what you are actually dealing with. Where an answer needs more than a paragraph, it links to the guide that covers it properly.

Getting started

Is Rectangle free?

The standard build is free and open source, with no trial period and no account. A separate paid tier adds saved multi-window layouts and custom sizes. Everything documented on this site works in the free build.

Why does it need Accessibility permission?

macOS does not allow one application to read or set another application's window geometry without it. There is no narrower permission available, and every window manager on macOS requires the same grant.

Does it send anything over the network?

Window positioning is entirely local. The only network activity is checking for updates.

Where should the app live on disk?

In the Applications folder, before you grant permission. Granting while it is still in Downloads creates a permission record tied to a path that will later change.

Can I install it with Homebrew?

Yes. If settings later fail to persist, the documented remedy is to uninstall with the zap flag and reinstall, which clears preference files a plain uninstall leaves behind.

Permissions and failures

The toggle is on but nothing works.

The grant exists as a row but no longer satisfies the runtime check, usually after an update or a move. Disable the toggle, remove the row with the minus button, restart the Mac, then relaunch and accept the prompt.

Is tccutil safe to run?

The reset subcommand clears approval only for the bundle identifier you name. It does not disable System Integrity Protection and does not affect other applications.

Do I really have to restart the Mac?

In practice yes. The permission daemon caches state, and skipping the restart is the most common reason a correct reset appears to fail.

Why did several utilities break at once after an upgrade?

They share the same privacy database. The same reset works for each of them using their own bundle identifiers.

Menu items are greyed out for one app only.

That application is not answering the accessibility API. Restart it; Electron apps and Microsoft Office are the usual cases and usually recover.

The app will not quit and will not appear in Force Quit.

A stuck process. Use killall, then clear the quarantine attribute on the bundle and relaunch.

Shortcuts

Some shortcuts work and others do nothing.

A conflict. Another application registered the same global combination and the loser fails silently. Quit suspects one at a time with the log window open.

Which modifiers are least likely to collide?

Control-Option and Control-Option-Shift. Command-based combinations collide with application menus constantly.

Can two apps share a hotkey?

No. One wins, determined by registration order, which is why a conflict can appear to come and go between reboots.

How do I get the default shortcuts back?

Restore Default Shortcuts in the settings tab, or set alternateDefaultShortcuts from the terminal and restart the app.

I am migrating from Magnet or Spectacle.

Two default schemes ship with the app, one modelled on each. Switching to the matching set preserves your existing muscle memory.

Shortcuts are still swallowed after I uninstalled it.

A process is probably still running and holding the registrations. Reboot first, then search for surviving copies and launch agents.

Sizes and geometry

Why does maximise leave a margin?

The between-windows gap applies to maximise by default. Set applyGapsToMaximize to 2 to exclude it.

Why will one application not shrink to a quarter?

It declares a minimum window size. That constraint belongs to the application and cannot be overridden from outside.

Why does resizing move the wrong edge?

Curtain resize keeps edges that touch the screen fixed. Set curtainChangeSize to 2 for traditional floating resize.

Can I resize width without changing height?

Yes, with the largerWidth and smallerWidth commands, which have no interface entry and must be bound from the terminal.

Are there sizes beyond thirds and sixths?

Yes. Ninths, eighths, corner two-thirds, doubling and halving all exist as commands with no default bindings and no settings entry.

How do I get one exact pixel size repeatedly?

The specified centring command takes explicit width and height values, which is the right tool for a repeatable viewport.

Displays

Next-display goes up instead of right.

Ordering is line-by-line by default. Set screensOrderedByX to 1 for pure left-to-right ordering, which suits stacked and offset arrangements.

Windows scatter every time I undock.

macOS relocates the windows of a disappearing display and keeps no record of where they were. It cannot be prevented from outside; fast rebuilding is the practical answer.

A window changes size when moved between screens.

Correct behaviour. The same fraction of a display with different resolution or scaling is a different number of points.

Can the pointer follow the window across displays?

Yes. There is an interface option for display moves and a hidden moveCursor key that applies it to any shortcut.

Snap areas and dragging

Dragging to an edge does nothing at all.

Check snapModifiers. If a modifier requirement is configured, snapping only works while that key is held, and nothing indicates this in the interface.

Windows maximise when I did not mean them to.

Disable the top region with ignoredSnapAreas set to 1, or increase snapEdgeMarginTop so it is harder to enter accidentally.

Dragging upward opens Mission Control.

A macOS gesture. It can be suppressed for fast drags, but doing so is documented to interfere with drag-and-drop in some applications, Illustrator among them.

Can I get sixths by dragging?

Yes, once sixthsSnapArea is enabled. Drag to a corner, then slide along the edge toward the thirds region.

Can I restyle the drag preview?

Yes. Transparency, border width, colour, fade and animation duration are all configurable.

Configuration

Why does a terminal command do nothing?

Almost always one of three things: the app was not restarted, the bundle identifier is wrong for free versus Pro, or the value type does not match what the key expects.

Do hidden settings survive an update?

Yes. They live in the preference domain, which updates do not clear.

My config file disappeared.

It was applied at launch and renamed with a timestamp so it is not reapplied. It is an import mechanism, not a live configuration file.

Settings reset at every single launch.

Something is putting the import file back, so it is reapplied each time. A synced folder or a provisioning script is the usual cause.

Can I sync my configuration between Macs?

Yes. Export the preference domain for hidden keys and the JSON for shortcuts. The Accessibility grant is deliberately not portable.

How do I return to factory defaults?

Quit the app, delete the preference domain, and relaunch.

macOS features

Maximise does not reach the left edge.

Stage Manager reserves a strip. Set stageSize explicitly in pixels or as a fraction, or turn Stage Manager off.

Do I have to disable the built-in macOS tiling?

No. Give the system the drag gestures and keep the keyboard shortcuts for the third-party tool. They do not conflict at all.

Can a full-screen app be positioned?

No. Native full screen moves the application into its own Space, so it is no longer an ordinary window. Use maximise instead if you want it snappable.

What does the built-in tiling not do?

Thirds, two-thirds, sixths, eighths, ninths, size cycling, precise gaps, keycode-level customisation and bulk tile or cascade commands.

Performance and privacy

Chrome got slower after I installed a window manager.

Granting Accessibility causes Chromium to enable its full accessibility subsystem, which is expensive on very large pages. It is a Chromium design decision, affects every window manager equally, and cannot be narrowed from outside.

Does the app itself use much CPU?

No. It is idle until a shortcut is pressed or a window is dragged into a snap region.

What can it see with Accessibility permission?

The permission is broad by design. This particular app uses it to read and set window geometry, which is verifiable because the source is public.

Is it suitable for a managed corporate Mac?

Often yes. The permission can usually be pre-approved by a management profile, and preference domains can be enforced centrally.

Per guide

Questions answered inside each guide

Every guide ends with its own set of specific questions.

Default Keyboard Shortcuts: The Complete Reference →

Can I print this page?; Do these work on a non-Apple keyboard?; How do I get the defaults back after customising?; Why does my second press change the width?…

Every Hidden Rectangle Preference: The Complete Terminal Reference →

Why do I have to restart the app every time?; Do these survive an app update?; What if a command has no effect?; Is there any risk?…

Rectangle Is Not Working: The Complete Diagnostic Order →

Why did it break immediately after a macOS update?; Do I have to restart the Mac after removing the permission?; Is it safe to run tccutil?; The icon vanished but the app says it i…

What Happens on the Second Press: Cycling Modes Explained →

Why did my window jump to another monitor?; Can I have both size and display cycling?; How do I stop repetition doing anything?; Why does a two-thirds window become a third?…

Menu Items Greyed Out and "Unable to Obtain Accessibility Element" →

Why does it only happen with Slack?; Is greyed out the same as the app being broken?; Can I force a window to move anyway?; Does restarting the Mac help?…

Ninths, Eighths, Corner Thirds and Halving: The Sizes With No Interface →

Why are these not in the settings window?; Do I need to know keycodes?; Can I bind these to mouse buttons?; Are ninths worth it on a laptop?…

Rectangle Stopped Working After a macOS Update: Why, and the Fix →

Will reinstalling fix it?; Do I really need to restart the Mac?; Why did other utilities break at the same time?; Is there a way to prevent this?…

Todo Mode: A Permanent Sidebar That Every Other Window Respects →

Do I need a specific to-do application?; Can I have sidebars on two displays?; Why is it hidden?; Does it survive updates?…

Finding the App That Is Stealing Your Shortcut →

Why does a shortcut work some days and not others?; Can two apps share a hotkey?; Which modifiers are safest?; How do I see everything registered globally?…

Gaps, Screen Edges, Notches and Dock Replacements →

Why does maximise not reach the screen edge?; What is the difference between the two gap types?; Do gaps cost performance?; Can gaps differ per display?…

Drag-to-Snap Is Not Working, or Working Far Too Eagerly →

Why does dragging to the top open Mission Control instead of maximising?; Can I keep keyboard shortcuts but turn off all dragging?; Do these terminal settings survive an app update…

Customising Snap Areas: Regions, Modifiers and the Drag Footprint →

How do I stop windows maximising when I drag near the top?; Why does dragging to an edge do nothing at all?; Can I have different snap areas per display?; What does the footprint c…

Settings and Shortcuts Reset on Every Launch →

Why do terminal settings need an app restart?; Where are my custom shortcuts stored?; What does brew zap actually remove?; Can I keep one configuration across several Macs?…

Backing Up and Syncing Your Configuration Across Machines →

Does the JSON export include gaps and hidden settings?; Why did my config file disappear?; Can I sync settings via iCloud automatically?; Is the Accessibility permission portable?…

Windows Land on the Wrong Display →

Why does next-display go up instead of right?; Can window positions be preserved across undocking?; Why does a window change size when it moves screens?; How many external displays…

Tile All and Cascade All: The Bulk Window Commands Nobody Knows About →

Can I undo a tile-all?; Can I choose the grid shape?; Does it work across displays?; Why are these hidden?…

Chrome Got Slower After Installing a Window Manager. Here Is Why →

Is this a bug in the window manager?; Would another window manager avoid it?; Does it affect Safari?; Does it affect Electron apps?…

Stage Manager and Built-In macOS Tiling: Making Them Coexist →

Why does maximise not reach the left edge?; Do I have to disable native tiling?; Which offers more?; Can I position a full-screen app?…

Uninstalling Completely, Including the Shortcuts That Keep Working Afterwards →

Is dragging to the Trash enough?; Why do the hotkeys still not work in other apps?; Does uninstalling remove my custom shortcuts?; What does the zap flag do?…

Rebinding the Double-Click on a Window Title Bar →

Where is the list of action numbers?; Why is the value the action index plus one?; Can I exclude several apps?; Does this override the macOS setting?…

Windows Come Out the Wrong Size: Gaps, Minimums and Curtain Resize →

Why does maximise leave a margin?; Why will one app not shrink to a quarter?; Why does resizing move the wrong edge?; Can I resize width without changing height?…

Keycodes and Modifier Values for Binding Hidden Commands →

Are keycodes layout-dependent?; Can I use function keys?; Why did my binding fail silently?; How do I remove a custom binding?…