window

Handy tools for Windows Management in macOS.

Inspired by WinWin for Hammerspoon.

API Overview

API Documentation

Variables

​gridparts​

Signature

plugins.finder.window.gridparts

Type

Variable

Description

An integer specifying how many gridparts the screen should be divided into. Defaults to 30.

Functions

​centerCursor​

Signature

plugins.finder.window.centerCursor() -> nil

Type

Function

Description

Center the cursor on the focused window.

Parameters

​

Returns

​

​grid​

Signature

plugins.finder.window.grid() -> nil

Type

Function

Description

Shows a modal keyboard driven interface for interactive window resizing.

Parameters

​

Returns

​

​hints​

Signature

plugins.finder.window.hints() -> nil

Type

Function

Description

Displays a keyboard hint for switching focus to each window.

Parameters

​

Returns

​

​moveAndResize​

Signature

plugins.finder.window.moveAndResize(option)

Type

Function

Description

Move and resize the focused window.

Parameters

​

Returns

​

​moveToScreen​

Signature

plugins.finder.window.moveToScreen(direction)

Type

Function

Description

Move the focused window between all of the screens in the direction.

Parameters

​

Returns

​

​stepMove​

Signature

plugins.finder.window.stepMove(direction)

Type

Function

Description

Move the focused window in the direction by one step. The step scale equals to the width/height of one gridpart.

Parameters

​

Returns

​

​stepResize​

Signature

plugins.finder.window.stepResize(direction)

Type

Function

Description

Resize the focused window in the direction by on step.

Parameters

​

Returns

​

​undo​

Signature

plugins.finder.window.undo()

Type

Function

Description

Undo the last window manipulation. Only those "moveAndResize" manipulations can be undone.

Parameters

​

Returns

​