Skip to content
jollybullyPublic

About

Tiny native macOS window manager: press your hotkey, drag a grid rectangle, the window snaps there. Alpha.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Gridlet

A tiny macOS window manager. Press a shortcut, then drag the focused window onto part of the screen, or send it to another Space.

Alpha — works daily, but not notarised. Universal build, macOS 13+.

Gridlet panel with Space chips

Install

Apple Silicon or Intel, macOS 13 or newer.

  1. Download the latest Gridlet-<version>-macos.zip from Releases and unzip it.
  2. Move Gridlet.app to /Applications or ~/Applications.
  3. Right-click → Open. The build is not notarised, so a double-click is blocked as an unidentified developer.
  4. Enable Gridlet in System Settings → Privacy & Security → Accessibility, then quit and reopen it. Without this it launches but cannot move windows.

Use

Set your shortcut in Settings… (default ⌃⌥Space). Focus a window and press it. Esc cancels.

Send it to a Space. The panel lists that display’s Spaces. Click one to send the window there. Option-click also switches to it. The dashed chip is the Space you are already on.

That row appears when yabai is running. Gridlet does not install it. Moving a window also needs yabai’s scripting addition (sudo yabai --load-sa). Without yabai, the chips are simply absent and the grid is unchanged. Move windows between Spaces in Settings turns the row off.

Resize it. Drag a rectangle on the grid and release.

Gridlet dragging a selection

The grid is a proportional map of the display, so half the columns by half the rows is exactly half the screen. Settings covers rows and columns (default 8×8), an edge gap of 0–24pt, and a different grid size per display when you have more than one screen. Cells already covered by a window on screen are tinted faintly — the window you are about to move slightly stronger — so you can see the existing layout before you drag; turn it off with Show where windows already are.

Build

git clone https://github.com/jollybully/gridlet.git && cd gridlet
./scripts/build.sh      # tests, release build, sign → dist/

scripts/build.sh signs with a stable local identity (Gridlet Dev, created on first build by scripts/dev-signing-identity.sh in its own throwaway keychain). That matters: an ad-hoc signature changes on every build, and macOS silently drops the Accessibility grant when it does, so you would have to re-enable the app after each build. A certificate keeps the same designated requirement, so the grant survives rebuilds. The certificate is self-signed and is not added to any system trust settings — it exists only to give builds a consistent identity. If creating it fails, the script falls back to ad-hoc signing and prints a warning.

The script also adds that keychain to your login keychain search list so codesign can find the identity without prompting.

Notes

  • No networking, analytics or accounts. Settings live in UserDefaults.
  • Minimum-size windows are moved as close as possible rather than refused.
  • Full-screen windows, sheets and the desktop are ignored.
  • Apps that publish a non-standard window (After Effects reports its document window as an AXLayoutArea, Warp as an AXSystemDialog) are still snapped as long as Accessibility can move and resize them.
  • Sending a window to another Space needs yabai. The grid does not. Space sends match the window by its window id, so they also work for windows on a hidden Space, where yabai's reported frame can be stale.
  • Not notarised: signed with a self-signed development certificate, so Gatekeeper asks you to confirm the first launch.

Why it exists

I used Divvy for years and loved it — one grid, one drag, done. It no longer works on recent macOS, so this is a from-scratch reimplementation of that workflow. No Divvy code or assets; all credit for the idea to its author. Not affiliated with Mizage.

MIT — see LICENSE.

About

Tiny native macOS window manager: press your hotkey, drag a grid rectangle, the window snaps there. Alpha.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages