Back to home

Manual

Azimuth is a menu-bar window manager for macOS. It places, transforms, and moves the focused standard window predictably — using the keyboard, without scenes or automation.

Predictability over clever inference.

Requirements

Five things to know before using Azimuth.

Accessibility permission

Azimuth controls windows via the Accessibility API. Enable it in System Settings → Privacy & Security → Accessibility → toggle Azimuth on (macOS 10.13–12: System Preferences → Security & Privacy → Privacy → Accessibility). On first launch a brief guide appears from the menu bar item, linking straight to the right Settings pane when permission is missing.

Running Azimuth

Download the DMG from the releases page and drag Azimuth to Applications — no build tools required. The release is Developer ID–signed and notarized, so it opens without Gatekeeper warnings.

Target window

Azimuth operates on the focused window of the target app. Standard windows and dialogs are always accepted; any other window — including one whose type macOS does not report, as with some Java and Electron apps — is accepted when macOS says its position and size can both be changed. Full-screen spaces, minimized windows and windows that refuse to be moved or resized — sheets and panels, typically — are skipped with a clear failure message. A standard window or dialog that can be moved but not resized keeps its size: placement commands only move it, to the edge the target area touches or to the target's center, and only Relative shrink reports a failure.

Target app policy

Commands act on the most recently active non-Azimuth app's focused window. Opening Azimuth's own Settings window does not change the target — your previous working app remains the target.

macOS version

Azimuth 2.x runs on macOS 14 (Sonoma) or later. On macOS 13, use version 1.7.7, the last version for macOS 13 (no further updates). On macOS 10.13–12, use the legacy build (1.7.2 Legacy): the same core features, no new ones. After you upgrade macOS, either one moves to the newest version that macOS can run on its next update check. Use the newest macOS your Mac supports.

Download 1.7.7 for macOS 13 →

Download the legacy build (1.7.2 Legacy) →

All versions and release notes →

Feature summary

All implemented and planned capabilities, grouped by area.

Area Feature Status
App shell Menu-bar app + Dock hidden (release) + Settings window (General · Shortcuts · Advanced · About) ✅
App shell Menu-bar popover: the 34 commands as tiles, permission status, last failure (right-click for the menu) ✅
Input Command palette (⌃⌥P): search every command, preview where the window goes ✅
Input Shortcut cheat sheet: hold a shortcut's modifier keys to see a keyboard map ✅
Onboarding First-run guide + practice window for the main shortcuts ✅
Install Offers to eject and trash the installer disk image after installing ✅
Permissions Accessibility status display, request, and Settings navigation ✅
Window identification Resolve the focused window (standard, dialog, or any window that reports itself movable and resizable); skip full-screen, minimized and unfocused ✅
Command Maximize to work area (or with uniform gaps) ✅
Command Absolute thirds (1/3): horizontal left/center/right · vertical top/middle/bottom ✅
Command Absolute two-thirds (2/3): horizontal left/right · vertical top/bottom ✅
Command Snap + throw to adjacent display (snapThrow, left/right/up/down) ✅
Command Move keep-size (left/right/up/down) · center ✅
Command Relative shrink 1/2 & 2/3 (left/right/up/down edge pinned) ✅
Command Move to next display (keep shape; moveToDisplay) ✅
Command Undo (up to 20 steps per window) ✅
Coordinates Multi-monitor support + position-aware adjacent display selection ✅
Input Global hotkeys (Carbon) · Standard / Vim presets ✅
Settings Preset selection / failure beep + notification toggles / undo steps and windows / launch at login ✅
Settings Per-command shortcut customization + conflict warnings ✅
Settings Command group on/off · per-command unbind · hide menu-bar icon ✅
Settings Updates: current version + Check for Updates… ✅
Settings Advanced tab: how long to wait for an unresponsive app (Quick 0.25s / Balanced 0.5s / Patient 1s) ✅
Updates Automatic updates (Sparkle): checks the appcast, verifies EdDSA + notarization, updates in place ✅
Stability AX messaging timeout · transient failure skip · permission cache hardening ✅
Planned Anchor: position current window relative to another window 🟡
Planned Scene save/restore, per-app default positions 🟡
Planned URL scheme / Shortcuts / per-app rules 🟡

Beyond shortcuts

Other ways to run commands and learn the keys.

Menu-bar popover

Click the menu bar icon to open a popover with all 34 commands as tiles, grouped as in Settings. Click a tile, or move with the arrow keys and press Return or Space, to apply it to the front window. The tile you used last is highlighted (as glass on macOS 26 and later). The popover also shows the permission status and the last failure reason, with Open Settings, Check for Updates and Quit at the bottom. Right-click or Control-click the icon for the menu.

Command palette (⌃⌥P)

Press ⌃⌥P to open a search panel for every command. Type part of a name or a word like “max”, “third” or “monitor”, move with ↑↓ and press Return to apply it to the window that was in front; Esc closes. A dashed amber outline shows where the selected command will put the window. With an empty search, your recent commands come first. Names are searched in English. Change or turn off the shortcut in Settings → Shortcuts → Command Palette.

Shortcut cheat sheet

Hold the modifier keys of a shortcut, such as ⌃⌥, for a moment (0.8 seconds by default) and a keyboard map shows what each key does with those modifiers. It closes when you let go or press a key. Turn it off or change the delay in Settings → General → Cheat Sheet. For this, Azimuth watches which modifier keys are held and whether a key was pressed; it does not read which key.

Practice window

On first launch a short guide appears under the menu bar icon. With permission granted, Try the Shortcuts opens a practice window where you move a sample window with Left 1/2, Maximize and Undo. Open it again from the icon's right-click menu (Practice Shortcuts…) or Settings → General → Practice.

Installer cleanup

If the Azimuth disk image is still mounted when Azimuth first runs from Applications, it asks once per version whether to eject it and move the .dmg to the Trash. macOS may ask for access to your Downloads folder; if you decline, the disk image is still ejected and the file stays.

Shortcuts — all 34 commands

Four modifier layers, each governing a distinct class of behavior. The layers never overlap.

⌃⌥
Halves (snap/throw) · Maximize · Center · Undo · Thirds & two-thirds (number keys)
⌃⌥⌘
Move (keep current size)
⌃⌥⇧
Relative shrink (1/2 against a pinned edge; 2/3 on ⌃⌥⇧ M , . /)
⌃⌥⌘⇧
Move to next display
Group Command Shortcut (Standard)
Halves (snap + throw) Left
⌃⌥←
Right
⌃⌥→
Top
⌃⌥↑
Bottom
⌃⌥↓
Maximize · Undo · Center Maximize
⌃⌥↩
Maximize with gaps
⌃⌥⇧↩
Undo
⌃⌥⌫
Center
⌃⌥C
Thirds (1/3) Horizontal: left · center · right
⌃⌥123
Vertical: top · middle · bottom
⌃⌥456
Two-thirds (2/3) Horizontal: left · right
⌃⌥78
Vertical: top · bottom
⌃⌥90
Move (keep size) Left · Right · Up · Down
⌃⌥⌘←→↑↓
Relative shrink (1/2) Left · Right · Up · Down
⌃⌥⇧←→↑↓
Relative shrink (2/3) Left · Down · Up · Right
⌃⌥⇧M,./
Move to next display Left · Right · Up · Down
⌃⌥⌘⇧←→↑↓
Vim preset: Only directional keys and Undo change. Directions become H (left) · L (right) · K (up) · J (down), Undo → U. Maximize, Center, and number shortcuts are identical.

Example: ⌃⌥H (snap left) · ⌃⌥⌘K (move up) · ⌃⌥⇧J (shrink down) · ⌃⌥⌘⇧L (move to right display) · ⌃⌥U (undo).
Running commands without shortcuts: Click the menu bar icon and pick a command in the popover, or press ⌃⌥P and search in the command palette (see Beyond shortcuts below). Settings (⌘,) has four panes: General (permission status, launch at login, hiding the menu-bar icon, failure sound and notification, cheat sheet, practice), Shortcuts (preset, the command palette shortcut, per-command recording and Reset, group and per-command on/off), Advanced (undo steps per window and how many windows to remember, how long to wait for an unresponsive app) and About (version and updates). In the Shortcuts pane every group starts collapsed — open one with its disclosure triangle, or type in the search field and matching groups expand on their own.

All 34 key combinations are registered at launch. If a registration fails — because another app or macOS already holds that combination, or because the hotkey system could not start — Settings marks the row "In use by system" in Settings. Some combinations macOS reserves appear to register successfully and are swallowed before they reach Azimuth; Azimuth cannot tell those apart, so they show no badge and the shortcut simply does nothing. Either way, every shortcut can be remapped with the Settings recorder.

Command behavior

Precise description of what each command does — what changes, what stays the same, and what the edge cases are.

Maximize
⌃⌥↩

Fills the work area — the visible region excluding the menu bar and Dock. The window expands to use every pixel available without overlapping system chrome.

Maximize with gaps
⌃⌥⇧↩

Like Maximize, but leaves a uniform 12pt inset on all four sides so the window doesn't touch the screen edges — visual breathing room, tiling-friendly. Falls back to a plain maximize if the work area is too small for the gap.

Absolute thirds & two-thirds
⌃⌥1–0

Positions the window at an exact fraction of the work area. Axes are independent: a horizontal command only changes x/width; a vertical command only changes y/height. Compose freely — apply a horizontal third then a vertical third to land in any corner or center cell.

Snap + throw (halves)
⌃⌥←→↑↓

Two-stage behavior: if the window is not already in that half, it snaps there. If it is already in that half, it is thrown to the adjacent display in the same direction, landing in the opposite half (throw right → lands in the left half of the right display). If there is no adjacent display in that direction, the window stays put.

Move (keep size)
⌃⌥⌘←→↑↓

Nudges the window by exactly its own width (horizontal) or height (vertical), with no resize and no display change. Clamped at the work-area boundary — repeat presses push the window to the edge and keep it flush. A window that already sits off-screen past an edge is recovered into the work area, so a directional Move can pull it back onto the screen rather than push it further out. A window larger than the work area has no room to move on that axis, so it stays flush against that edge.

Center
⌃⌥C

Moves the window to the center of the work area without changing its size.

Relative shrink (1/2 · 2/3)
⌃⌥⇧←→↑↓
⌃⌥⇧M,./

Shrinks the window to 1/2 (arrows) or 2/3 (M , . / → left/down/up/right, like Vim HJKL) of its current size relative to a pinned edge — not the screen. The edge in the given direction is fixed; the opposite edge moves inward. Exact, repeatable, and composable: 2/3 then 1/2 lands on 1/3.

Move to next display
⌃⌥⌘⇧←→↑↓

Sends the window to the adjacent display in the given direction, keeping its relative position on the new screen — a centered window stays centered even at a different resolution. It keeps its exact pixel size if it fits; if it doesn't, both axes shrink by the same factor, so the shape (aspect ratio) is preserved. If there is no adjacent display in that direction, the window stays put.

Fixed-size windows

A standard window or dialog that can be moved but not resized (its green zoom button is greyed out) keeps its size, and placement commands only move it. On each axis it hugs the work-area edge the target touches, or is centered within the target when the target touches both edges or neither — Left 1/2 puts it on the left edge, vertically centered; Maximize centers it on the screen. Pressing the same direction again still throws it to the adjacent display. Relative shrink still reports “This window can’t be resized”.

Undo
⌃⌥⌫

Restores the window's previous frame; press again to keep stepping back. Each window remembers its own recent frames — 5 by default, adjustable from 1 to 20 under Settings → Advanced → Undo, where you can also set how many recently used windows keep a history (64 by default, 1–256). Lowering either limit trims the oldest history on the next window command or Undo; a value that isn't a number reverts, and one out of range snaps to the nearest limit. Undo itself is not recorded, so there is no redo. History is discarded if the display configuration changes (e.g., a monitor is connected or disconnected), since absolute coordinates become invalid.

Failure feedback

When a command cannot complete, Azimuth plays a beep (configurable in Settings) and records the reason, which the menu-bar popover shows (and the menu you get by right-clicking the icon). You can also opt in to a notification on failure. Transient failures — such as those caused by a Space transition or a window animation in progress — are silently skipped without a beep, since they self-resolve immediately. Two cases behave differently. If the command failed because Accessibility permission is missing, Azimuth opens the Settings window for you — once per launch, so it never becomes a nuisance. And if the target app took too long to answer, the reason reads "The app is taking too long to respond"; Settings → Advanced decides how long Azimuth waits before giving up.

Note on size-increment apps (Terminal, etc.): Some apps constrain their window size to a character-grid increment. When Azimuth applies a half or maximize command, the result is rounded down to the nearest character cell, which may leave a sub-row gap at the edge. This is an app-level constraint and expected behavior. Similarly, the work area excludes the menu bar and Dock, so a gap at the screen edge is normal.