Home

Awesome

darwintiler

Super simple tiling helper for MacOS (and now x11/Linux), inspired by quicktile.

Build Status

Screenshot1

Building

darwintiler is written in nim and c. There are no external dependencies.

All you need is the nim compiler and a c compiler.

The binary will be placed in the "build" folder.

cd darwintiler
make release

Configuration and Usage

Create a configuration file in ~/.darwintiler.json

A complete example of the configuration file is below.

{
  "gap": 12,
  "displayEdgeGap": 6,

  "bindings": {
    "cmd+shift+u": "TopLeft",
    "cmd+shift+i": "Top",
    "cmd+shift+o": "TopRight",
    "cmd+shift+j": "Left",
    "cmd+shift+k": "Middle",
    "cmd+shift+l": "Right",
    "cmd+shift+m": "BottomLeft",
    "cmd+shift+,": "Bottom",
    "cmd+shift+.": "BottomRight"
  }
}

Note: Under X11, , and . are comma and period respectively.

The focused window can be tiled using the specified hotkeys: Screenshot2

MacOS Permissions

On MacOS, this program requires you to allow explicit access to the Apple Accessibility Services API (Preferences -> Security and Privacy).

On MacOS Sierra, you can no longer add CLI apps to this dialog, so you should either use macappshell or similar program to create a proper .app (alternatively, you can add your entire terminal to this list and always invoke darwintiler from your terminal (not recommended for security reasons)).

Background Image: Kuvshinov Ilya