Home

Wiki for Phoenix

Getting Started

Below you will find a basic configuration example. Copy and paste it to ~/.phoenix.js. When you press the key combination Ctrl + Shift + Z on your keyboard, the focused window will be moved to the centre of your main screen.

Key.on('z', [ 'ctrl', 'shift' ], function () {

  var screen = Screen.main().flippedVisibleFrame();
  var window = Window.focused();

  if (window) {
    window.setTopLeft({
      x: screen.x + (screen.width / 2) - (window.frame().width / 2),
      y: screen.y + (screen.height / 2) - (window.frame().height / 2)
    });
  }
});

For more, see the API documentation or some screenshots.

Upgrading

• Upgrade from 2.x to 2.2

Examples

Feel free to add your own configuration to show other people the nice things you can do. You can also use GitHub search to find more examples.

Stable (2.2–)

• @kasper’s configuration — chaining window management in CoffeeScript inspired by @metakirby5’s configuration
• @alswl’s configuration — work without Alt-Tab, introduction in Chinese: Windows Management for Hacker
• @mafredri’s configuration — in TypeScript using typed phoenix-typings
• @jasonm23’s configuration — literate CoffeeScript
• @garrow’s reimplementation of a subset of SizeUp with phizeup.js — very vanilla JS
• @purag’s configuration — with window hints (easy focus switching)
• @kgrossjo’s configuration — Prefix keys inspired by Divvy
• @jakemcc’s configuration — in ClojureScript
• @metakirby5’s configuration — in CoffeeScript with window chaining, modal (as in modes) keybindings, hinting windows and screens, and readline-like modals to evaluate JavaScript and execute shell commands
• @kemar’s configuration — Prefix keys inspired by MercuryMover

Archive (2.0–)

• @shayne’s configuration — Xmonad/Amethyst inspired implementation (FlowType, Babel)
• @jasonm23’s configuration — literate CoffeeScript
• @watsoncj’s configuration — grid layout and focus key bindings
• @jiexi’s configuration — Windows-like window management bindings

Archive (1.5)

• @sennah911’s configuration
• Anonymous configuration from Gist
• @alswl’s configuration
• @nb’s configuration — maximise, move between screens and left/right half
• @nylen’s configuration — move windows around in grid layouts
• @NsLib’s configuration — Vim-like modal (also global shortcuts), custom layouts and quick switch windows