tile

tile is a command-line window manipulation tool for macOS.

• Horizontal and vertical dimensions are treated differently
  • Horizontal: (possibly non-integer) multiples of fixed unit_width
    • Defaults to Terminal.app's width at 80 columns, with scrollbar hidden
  • Vertical: integer multiples of halves or thirds of display height
• Snap
  • Snap to the display center or edge
  • Snap last n focused windows together side-by-side
• Manipulate windows within one display, or send them to other displays
• Address apps by case insensitive substrings of their names (e.g., s for Safari, i for iTunes, etc.)
  • If no name is provided, act on the currently focused window
• Integrate with hotkey managers that issue shell commands such as skhd
  • Sample config file for skhd is provided in readme/.skhdrc, which results in the following keybinds (prefix right ⌥⌘):

How to use

• Clone, then make
• Copy just-built tile to /usr/local/bin for access from anywhere (optional)
• See tile --help for detailed command syntax
• Some examples:
  • tile: list open windows
  • tile 0: current window, position 0, width 1 (unit_width), height unchanged
  • tile 1-: current window, position 1, width extended to right end, height unchanged
  • tile 1-3f sa: position 1, width 2, full height, 0-th window of the app whose name starts with sa (e.g., Safari)
  • tile -2.5t fi 1: position same, width extended to position 2.5, top half, 1-th window of app fi (e.g., Finder)
  • tile snap: snap current window to the left display edge
  • tile snap 3: snap last 3 focused windows together side-by-side
  • tile undo: undo last action
  • tile [ or tile ]: send current window to previous or next display (direction is meaningful only if there are 3 or more displays)
• unit_width and screen margins can be configured in $HOME/.tilerc