https://github.com/veryjos/darwintiler

No frills, super easy tiling "window manager" for MacOS and x11/Linux.
https://github.com/veryjos/darwintiler

Last synced: 3 months ago
JSON representation

No frills, super easy tiling "window manager" for MacOS and x11/Linux.

• Host: GitHub
• URL: https://github.com/veryjos/darwintiler
• Owner: veryjos
• Created: 2017-07-24T22:55:01.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-12-30T23:07:42.000Z (almost 4 years ago)
• Last Synced: 2024-05-11T06:34:34.585Z (6 months ago)
• Language: C
• Homepage:
• Size: 43 KB
• Stars: 84
• Watchers: 3
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-ricing - darwintiler - No frills, super easy tiling "window manager" for MacOS and x11/Linux. (C, Nim) (Packages / window-managers)

README

        
# darwintiler

Super simple tiling helper for MacOS (and now x11/Linux), inspired by [quicktile](https://github.com/ssokolow/quicktile).

[![Build Status](https://travis-ci.org/simply-jos/darwintiler.svg?branch=master)](https://travis-ci.org/simply-jos/darwintiler)

![Screenshot1](https://user-images.githubusercontent.com/11465187/28549014-743e56d4-70a5-11e7-8285-bdc460dd984a.png "Screenshot 1")

## Building

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

All you need is the [nim compiler](http://nim-lang.org/) and a c compiler.

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

```bash

cd darwintiler

make release

```

## Configuration and Usage

Create a configuration file in ~/.darwintiler.json

A complete example of the configuration file is below.

```json

{

  "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](https://user-images.githubusercontent.com/11465187/28549696-ddc6740c-70a9-11e7-82db-1307a2bfb8df.gif "Screenshot 2")

#### 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](https://github.com/Xeoncross/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](http://kuvshinov-ilya.deviantart.com/)