README

Spectacle



Easily organize windows without using a mouse.

 Important Note

This project is not being actively maintained. Unfortunately, after almost a decade of on-and-off development I can no longer dedicate the time needed to be a responsible maintainer of this project. Spectacle will remain available for download but please use at your own risk. The source code will continue to be free and open to anyone, so feel free to make Spectacle your own.

Thanks to all the folks that have made Spectacle the first app they install a new Mac!

_Spectacle users have recommended Rectangle as an open source alternative._

 System requirements

Spectacle [0.8.6][1] is the last version to support Mac OS X 10.7; future releases will only support 10.9 or greater. Folks wishing to stay on 10.7 should download [0.8.6][1]. Those looking for a version of Spectacle that supports 10.6 can still download [0.7][2].

 Keyboard Shortcuts

Spectacle makes use of several [keyboard shortcuts][3] that trigger specific _window actions_. A window action is nothing more than a command that tells Spectacle how to change the size and/or position of a particular window.

A keyboard shortcut consists of one or more modifier keys paired with a character key. The common modifier keys Spectacle takes advantage of are:

| Symbol    | Key         |
|:---------:|:-----------:|
|  &8984;  | Command Key |
|  &8963;  | Control Key |
|  &8997;  | Option Key  |
|  &8679;  | Shift Key   |

The default keyboard shortcuts can be changed at any time. Use new key combinations to trigger window actions, or clear particular keyboard shortcuts to disable window actions entirely.

 Basic window actions

To move a window to the center of the screen use the &8997;&8984;C keyboard shortcut. Centered windows will __not__ have their size altered. Maximize a window using the &8997;&8984;F shortcut.

Windows can be moved to a number of predefined regions of the screen:

- _Move to the left half_ &8212; &8997;&8984;&8592;
- _Move to the right half_ &8212; &8997;&8984;&8594;
- _Move to the top half_ &8212; &8997;&8984;&8593;
- _Move to the bottom half_ &8212; &8997;&8984;&8595;

- _Move to the upper left_ &8212; &8963;&8984;&8592;
- _Move to the lower left_ &8212; &8963;&8679;&8984;&8592;
- _Move to the upper right_ &8212; &8963;&8984;&8594;
- _Move to the lower right_ &8212; &8963;&8679;&8984;&8594;

Windows may also be resized between thirds using any of the shortcuts above. For example, to have a window resized between 1/3 and 2/3 of the left region of the screen simply activate the left half &8997;&8984;&8592; keyboard shortcut more than once. Each time the shortcut is activated Spectacle will move the window between 1/3, 2/3, and back to 1/2 of the left side of the screen. This feature also applies to the upper left, lower left, upper right, and lower right shortcuts.

Spectacle can also move windows between horizontal and vertical thirds of the screen. The &8963;&8997;&8594; keyboard shortcut will mo