The macOS window manager for hackers
Objective-C Mathematica Go Python Racket Ruby Other
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead of petterik:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
AutoUpdating Update change-log links. Aug 30, 2013
Builds
Docs wrapped require statement in quotes Oct 14, 2013
Graphics Usage comparison. Aug 29, 2013
Licenses Start using Mike Ash's super useful utilities. Aug 30, 2013
ThirdParty Start using Mike Ash's super useful utilities. Aug 30, 2013
Zephyros.xcodeproj
Zephyros Apparently Apple made it impossible to support both 10.8 and 10.9 to … Nov 13, 2013
libs
zephjs
.gitignore
README.md
appcast.xml
change-log.txt
release.sh
tag.sh Add tag.sh back. Sep 10, 2013

README.md

Zephyros

As Odysseus climbed onto the shore, he opened up his MBP and began to write an email to a mailing list about how terrible his adventure had been, and how he'd almost been drowned by the sea, and how beautiful yet deadly was the sound of the Sirens.

But, noticing how his windows were all in disarray, overlapping one another and terribly sized, he opened Zephyros. Using a little black-Ruby-magic, he tweaked his configs. Then he swiftly began arranging his windows using only his keyboard.

The subjects of the local kingdom, noticing the elegant gracefulness with which he resized and repositioned his Mac windows, set out to make him their king. Even the mighty king of that land, two hundred years old yet stronger than any other, had decided to abdicate his throne for the sake of Odysseus. For he had learned of this foreigner's magnificent configs.

But before the people could approach him, he sensed in himself their plan, so he set out for his home country to reclaim his dear wife Penelope. Yet even so, not without first pushing his config changes to his github repo for all to benefit from. And, being of such noble blood, he even contributed some of his ideas and configs to the Zephyros wiki for the sake of all.

  • The Odyssey

About Zephyros

The OS X window manager for hackers

  • Current version: 5.2
  • Requires: OS X 10.9 and up
  • Download: get .zip file, unzip, right-click app, choose "Open"

Basics

At it's core, Zephyros just runs quietly in your menu bar, and listens for your script.

You typically write a script that binds global hot keys to do stuff, like moving or resizing windows.

Stuff you can do

  • register for callbacks on global hotkeys
  • find the focused window
  • determine window sizes and positions
  • move and resize windows
  • change focus to a given window
  • listen to global events (window created, app launched/killed, etc)
  • transfer focus to the closest window in a given direction
  • run shell scripts
  • open apps, links, or files
  • get free pizza (okay not really)
  • and more!

Some languages you can use

Note: all the languages use the same simple underlying protocol.

  • The wiki home page has other people's configs, configs that emulate apps, and useful tricks

Frequently Asked Questions

  1. How does Zephyros compare to Slate?

    Zephyros was originally a fork of Slate, but was rewritten for performance and stability improvements, and flexibility. One benefit is that Zephyros can be scripted in many languages, whereas Slate can only be scripted in JavaScript. Zephyros has a few more API calls and listen-able events, but lacks a few of Slate's GUI-specific features.

  2. How does Zephyros compare to Spectacle / Divvy / SizeUp / Moom / AppGrid / etc?

    Zephyros just gives you an API which you can use to build up your own functionality for managing your windows however you'd like. Your script can be as minimal or as complex as you want, since it's really just a program written in your favorite language that controls Zephyros. Also, Zephyros is free, open source, and actively maintained. Some of the alternatives are neither.

  3. Isn't it inefficient to have two processes running all the time?

    Nope. Compare Chrome's usage after opening one window and Zephyros's usage after moving some windows around.

Change log

Moved here.

Special Thanks

License

Released under MIT license.

Copyright (c) 2013 Steven Degutis

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.