Skip to content

About

A free, open-source window manager for macOS. Snap windows to halves, thirds, quarters and corners with a keyboard shortcut, or by dragging them to a screen edge.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Rectangle Ultra app icon: a white window on a dark teal square with a mint accent

Rectangle Ultra

A free, open-source window manager for macOS.
Snap windows to halves, thirds, quarters and corners with a keyboard shortcut, or by dragging them to a screen edge.

Tests macOS 14 or later Swift 6 Latest release MIT license

Rectangle Ultra in action: one window snaps to the left half, the right half, the top-right corner, then fills the screen and goes back, each time from one Control-Option keyboard shortcut shown on screen.

Try it in your browser


Try it first

No Mac needed. The try-it page has a small desktop you can play with. Press the shortcuts below and watch the windows snap into place.

What it does

Rectangle Ultra features: keyboard shortcuts for halves, thirds, quarters, sixths, eighths and corners; drag a window to a screen edge to snap it with a preview; Todo mode; repeated-press cycling; a URL scheme; JSON config import and export.

  • Keyboard shortcuts for halves, thirds, two-thirds, quarters, sixths, eighths, corners, maximize, almost maximize, center, restore, and next or previous display.
  • Drag to an edge and a preview shows where the window will land.
  • Repeated presses cycle sizes, so one shortcut can step through half, two-thirds and one-third.
  • Todo mode keeps one app in a side column and tiles everything else beside it.
  • URL scheme so scripts, Shortcuts and launchers can trigger any action.
  • JSON config import and export, to move your setup between Macs.
  • No auto-updater, no telemetry, no account. It runs entirely on your Mac.

Install

Download. Get RectangleUltra.zip from the latest release, unzip it, and drag Rectangle Ultra into Applications.

The app is ad-hoc signed, not notarized by Apple, so macOS will stop it on first launch. Either right-click the app and choose Open, or run:

xattr -dr com.apple.quarantine "/Applications/Rectangle Ultra.app"

Then allow it under System Settings → Privacy & Security → Accessibility. Rectangle Ultra needs that permission to move other apps' windows, and asks for it on first launch.

Note

Quit any other window manager that uses the same shortcuts (Rectangle, for example) before running Rectangle Ultra, or the two will fight over the keys. Because the build is ad-hoc signed, macOS may ask for the Accessibility permission again after an update. Remove the old entry in the Accessibility list, then allow the new one.

Build from source. You do not need Xcode. The Command Line Tools are enough (xcode-select --install).

git clone https://github.com/esoteric-frog/RectangleUltra.git
cd RectangleUltra
make install      # builds "Rectangle Ultra.app" and copies it to /Applications

make app builds build/Rectangle Ultra.app without installing it, and make test runs the test suite. Requires macOS 14 or later.

Default shortcuts

Action Shortcut Action Shortcut
Left half ⌃ ⌥ ← Top left ⌃ ⌥ U
Right half ⌃ ⌥ → Top right ⌃ ⌥ I
Top half ⌃ ⌥ ↑ Bottom left ⌃ ⌥ J
Bottom half ⌃ ⌥ ↓ Bottom right ⌃ ⌥ K
Maximize ⌃ ⌥ ↩ First third ⌃ ⌥ D
Center ⌃ ⌥ C Center third ⌃ ⌥ F
Restore ⌃ ⌥ ⌫ Last third ⌃ ⌥ G
Previous display ⌃ ⌥ ⌘ ← First two-thirds ⌃ ⌥ E
Next display ⌃ ⌥ ⌘ → Last two-thirds ⌃ ⌥ T

Every shortcut can be changed in Settings.

Snap by dragging

Drag a window to the edge of the screen. When the pointer reaches the edge, a footprint shows where the window will land when you let go.

Snap area Result
Left or right edge Left or right half
Top Maximize
Corners Quarter in that corner
Left or right edge, just above or below a corner Top or bottom half
Bottom left, center or right third That third
Bottom left or right third, then drag to bottom center First or last two-thirds

Execute an action by URL

Open rectangle-ultra://execute-action?name=[name]. From a shell:

open -g "rectangle-ultra://execute-action?name=left-half"

Available values for [name]: left-half, right-half, center-half, top-half, bottom-half, top-left, top-right, bottom-left, bottom-right, first-third, center-third, last-third, first-two-thirds, last-two-thirds, maximize, almost-maximize, maximize-height, smaller, larger, center, center-prominently, restore, next-display, previous-display, move-left, move-right, move-up, move-down, first-fourth, second-fourth, third-fourth, last-fourth, first-three-fourths, last-three-fourths, top-left-sixth, top-center-sixth, top-right-sixth, bottom-left-sixth, bottom-center-sixth, bottom-right-sixth, specified, reverse-all, top-left-ninth, top-center-ninth, top-right-ninth, middle-left-ninth, middle-center-ninth, middle-right-ninth, bottom-left-ninth, bottom-center-ninth, bottom-right-ninth, top-left-third, top-right-third, bottom-left-third, bottom-right-third, top-left-eighth, top-center-left-eighth, top-center-right-eighth, top-right-eighth, bottom-left-eighth, bottom-center-left-eighth, bottom-center-right-eighth, bottom-right-eighth, tile-all, tile-rows, tile-columns, cascade-all, cascade-active-app, cycle-stacked-windows, cycle-stacked-windows-backward

URLs can also ignore or un-ignore an app. Ignoring an app means that while it is in front, Rectangle Ultra's shortcuts are released back to macOS. That is useful for apps that already use the same keys.

rectangle-ultra://execute-task?name=ignore-app
rectangle-ultra://execute-task?name=unignore-app

Add a bundle identifier to target a specific app:

rectangle-ultra://execute-task?name=ignore-app&app-bundle-id=com.apple.Safari

You can also ignore the front app from the Rectangle Ultra menu: choose Ignore app, and choose it again to undo.

Terminal settings

Many hidden preferences can be set with defaults write. See TerminalCommands.md.

Import and export

The App Settings tab in Settings has buttons to import and export your shortcuts and preferences as a JSON file.

Troubleshooting

  • Shortcuts do nothing. Check that Rectangle Ultra is enabled under System Settings → Privacy & Security → Accessibility. If it is listed and still does nothing, switch it off, remove it with the minus button, then add it again.
  • Two apps react to the same shortcut. Quit the other window manager, or change the shortcuts in one of them.
  • A window will not resize exactly. Some apps, terminals especially, snap to a character grid and land a few pixels short. That is the app, not the window manager.
  • Logs. Hold ⌥ while the Rectangle Ultra menu is open and choose View Logging….

Uninstall

Quit the app and delete it from Applications.

Roadmap

Planned, not built yet:

  • Stash windows at a screen edge
  • Window throw: a keyboard picker to send a window to a spot
  • A snap-area panel
  • Saved layouts and per-app rules

Contributing

Bug reports and small, focused fixes are welcome. See CONTRIBUTING.md. Report security issues as described in SECURITY.md. Version history is in CHANGELOG.md.

Credits

Rectangle Ultra is a fork of Rectangle by Ryan Hanson, released under the MIT license. Nearly everything that makes it work comes from that project and its contributors. If you want the original, polished and widely used app, go and use it. Rectangle is itself based on Spectacle.

MASShortcut is vendored for recording keyboard shortcuts, with a small fix so it finds its resources outside an Xcode build.

License

MIT. See LICENSE.

Rectangle Ultra: free, open source, MIT licensed.

Not affiliated with Rectangle, Rectangle Pro or their developer.

About

A free, open-source window manager for macOS. Snap windows to halves, thirds, quarters and corners with a keyboard shortcut, or by dragging them to a screen edge.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages