Phoenix

My Phoenix setup. Powerful, easy to customize, tuned for web development, adds a space switcher.

Installation

This configuration uses a remap of the Caps Lock key to something more useful: the Hyper key ⇪ (basically just Ctrl + Alt + Cmd combined into one key) if used in combination with other keys, otherwise it gets mapped to F18, which is used to trigger the space switcher. If you prefer you may skip these remap steps while you try the configuration, but if you usually have many spaces opened I highly recommend you not to miss out the awesome space switcher, for which this hack is a requirement.

1. Install Phoenix
2. Install Karabiner Elements via its dmg
3. Replace Caps Lock with Hyper/F18 using this Karabiner Elements configuration (if the link doesn't work copy and paste this in a browser: karabiner://karabiner/assets/complex_modifications/import?url=https%3A%2F%2Fraw.githubusercontent.com%2Ffabiospampinato%2Fphoenix%2Fmaster%2Fconfig%2Fkarabiner.json)
4. $ mkdir ~/.config
5. $ cd ~/.config
6. $ git clone [email protected]:fabiospampinato/phoenix.git
7. Restart Phoenix
8. Enjoy!

Customization

To disable specific features, just comment out their correspondent require call in phoenix.js.

To tweak some numbers, simply edit constants.js.

Changing the specific shortcut used to trigger an action is pretty trivial.

Don't forget to make a PR if you fixed something or implemented something cool :)

Shortcuts

Sides

Corners

Halves

Thirds

Sixths

Center

Grow

Expand

Focus or Open

Spaces

In order to make this work you have to open System Preferences -> Keyboard -> Shortcuts -> Mission Control and bind all Switch to Desktop [NUMBER] actions to Ctrl + Alt + Cmd + Shift + [NUMBER]. There are actions up to the 9th desktop, but they may not be shown to you if you have less then 9 desktops currently open.

Note: If you don't need wrapping support, you should just remap the Move left/right a space actions under System Preferences -> Keyboard -> Shortcuts -> Mission Control.

Applications Icons

Reload Phoenix

Pause/Resume Application

This can be used for saving battery, pausing single-player games etc.

Quit Application

Did you ever close 3+ Chrome windows instead of a single tab by mistake? Fear no more! Now in order to quit an app you have to trigger ⌘Q twice in a short timeframe. Stop wasting 10$ for something so basic.

Split View

//TODO: Unfortunately there's no API available for doing this at the moment, that's a shame given that I would have finally found a use for the § key, it looks like 2 S => Side-by-Side :D

Mouse

Snapping

Drag a window to an edge or corner to snap it into place.

Magic

Chrome

If it gets opened, positionate it to the left side.

Chrome Developer Tools

If it gets opened, positionate it to the bottom-right corner, and shrink Visual Studio Code's height a bit, so that the console will be visible.

If it gets closed, restore Visual Studio Code's height.

Terminal/iTerm2/Finder

If one of these apps' windows gets opened, positionate it to bottom-left corner.

Visual Studio Code

If it gets opened, positionate it to the right side.

Space Switcher

This is the truly great addition to what was already available on the internet.

It combines Phoenix, Alfred and alfred-spaces-workflow into the space switcher macOS deserves but never had, always just a double Hyper (⇪ ⇪) away.

This is how it works:

• It uses Phoenix to compile a list of your spaces
• It tries to guess a name for those spaces, by default that would be the name of the folder opened in the Visual Studio Code instance present in that space (get_space_name.js)
• Refreshes the list and those guessed names when necessary
• Listens for the double Hyper (⇪ ⇪) shortcut
• Opens Alfred and triggers alfred-spaces-workflow
• Which reads the list of spaces compiled with Phoenix and displays it to you
• Now just select a space to switch to

In order to make this work you have to open System Preferences -> Keyboard -> Shortcuts -> Mission Control and bind all Switch to Desktop [NUMBER] actions to Ctrl + Alt + Cmd + Shift + [NUMBER]. There are actions up to the 9th desktop, but they may not be shown to you if you have less then 9 desktops currently open.

Note: There's no API available for retrieving windows from other spaces, therefor other spaces' guessed names won't be refreshed until you visit them. The very first time you load Phoenix you might want to switch the focus to all of them, one by one, to have their names updated.

License

MIT © Fabio Spampinato