Miro's windows manager

With this script you will be able to move the window in halves and in corners using your keyboard and mainly using arrows. You would also be able to resize them by thirds, quarters, or halves.

Other projects (e.g. Spectacle) move windows in halves using arrows, and in corners using other counterintuitive shortcuts, like letters, which makes things confusing.

This script needs Hammerspoon in order to work.

Fork Info cmaahs

I added a "middle" feature, hyper + m that I wasn't sure would be accepted into the main repository. While I was at it, I archived the previous version (v1.1) as a branch, and pulled the original author's v1.2 branch into the master branch to make things less confusing for installation.

How to install from the fork

This will create a ~/tmp temp file in your home directory and clone the repository into it, then move the Spoon to the ~/.hammerspoon/Spoons install directory. Then add the base loading lines into your ~/.hammerspoon/init.lua file. Once complete you can clean up the ~/tmp/miro-windows-manager directory as you see fit.

mkdir ~/tmp

cd ~/tmp && git clone https://github.com/cmaahs/miro-windows-manager.git
cd ~/tmp/miro-windows-manager
mv MiroWindowsManager.spoon ~/.hammerspoon/Spoons


if grep -Fxq 'local hyper = {"ctrl", "alt", "cmd"}' ~/.hammerspoon/init.lua
then
    echo "line already exists."
else
    echo 'local hyper = {"ctrl", "alt", "cmd"}' >> ~/.hammerspoon/init.lua
fi

if grep -Fxq 'hs.loadSpoon("MiroWindowsManager")' ~/.hammerspoon/init.lua
then
    echo "line already exists."
else
    echo 'hs.loadSpoon("MiroWindowsManager")' >> ~/.hammerspoon/init.lua
fi

if grep -Fxq 'hs.window.animationDuration = 0.3' ~/.hammerspoon/init.lua
then
    echo "line already exists."
else
    echo 'hs.window.animationDuration = 0.3' >> ~/.hammerspoon/init.lua
fi
if grep -Fxq 'spoon.MiroWindowsManager:bindHotkeys({ up = {hyper, "up"}, right = {hyper, "right"}, down = {hyper, "down"}, left = {hyper, "left"}, fullscreen = {hyper, "f"}, center = {hyper, "c"}, move = {hyper, "v"}, middle = {hyper, "m"} })' ~/.hammerspoon/init.lua
then
    echo "line already exists."
else
    echo 'spoon.MiroWindowsManager:bindHotkeys({ up = {hyper, "up"}, right = {hyper, "right"}, down = {hyper, "down"}, left = {hyper, "left"}, fullscreen = {hyper, "f"}, center = {hyper, "c"}, move = {hyper, "v"}, middle = {hyper, "m"} })' >> ~/.hammerspoon/init.lua
fi

How to install

• Extract the zip file, containing MiroWindowsManager.spoon in ~/.hammerspoon/Spoons
• Now you need to configure Hammerspoon in order to load this spoon in ~/.hammerspoon/Spoons/MiroWindowsManager.spoon adding the following snippet of code in your init.lua file:

local hyper = {"ctrl", "alt", "cmd"}

hs.loadSpoon("MiroWindowsManager")

hs.window.animationDuration = 0.3
spoon.MiroWindowsManager:bindHotkeys({
  up = {hyper, "up"},
  right = {hyper, "right"},
  down = {hyper, "down"},
  left = {hyper, "left"},
  fullscreen = {hyper, "f"},
  center = {hyper, "c"},
  move = {hyper, "v"},  
  middle = {hyper, "m"}
})

Shortcuts

In the snippet above configure Miro'w Windows Manager in the following way:

Hyper key

The hyper key is defined as ctrl + alt + cmd. This means that each shortcut will start by pressing these three keys. If you consider this too verbose for your personal keyboard interactions, you can also change it, for example replacing it with an unused key (e.g. caps lock key) with Karabiner and Seil to act as hyper key.

Move in halves

• hyper + up: move to the top half of the screen
• hyper + right: move to the right half of the screen
• hyper + down: move to the bottom half of the screen
• hyper + left: move to the left half of the screen

By repeating these shortcuts the window is resized to be one third or two thirds and again in one half.

Move to corners

• hyper + up + right: move the window to the top-right corner
• hyper + down + right: move the window to the bottom-right corner
• hyper + up + left: move the window to the top-left corner
• hyper + down + left: move the window to the bottom-left corner

When the window is in the corner, it will have one half of screen height and one half of screen width. The arrows can be used to expand the height/width to be one third, two thirds or again one half. For example if the window is in the top-right corner, pressing hyper + up the window height will be resized to be one third, while pressing hyper + right the window width will be resized to be one third; in this case hyper + left and hyper + down will move the window to the top-left and bottom-right corners, respectively.

Expand to fit the entire height or width

These are useful in case the window is in one of the corners.

• hyper + up + down: expand the height to fit the entire screen height
• hyper + right + left: expand the width to fit the entire screen width

Expand to fullscreen

• hyper + f: expand to be full screen

Note that in case the window is resized to be a half of the screen, you can also use hyper + up + down (or hyper + right + left) to resize the window full screen.

As the other shortcuts, hyper + f can be pressed multiple times to obtain a centered window of three fourth and one half of height and width. This behaviour can be customized.

Move to the middle, expanding to full height.

• hyper + m: move to the middle

This will move the window to the center and initially use half the screen width and full height; additional calls to hyper + m will use two thirds and three quarters of the screen width.

Animations

The snippet above configures the animation to last 0.3s with hs.window.animationDuration = 0.3. To remove the animations completely change this value to 0.

Reviews

Here comments from the users, just as reviews.

it's something I have been looking for all my life! It is really intuitive and ingenious once you see the magic it can do.

— rxng

Really loving the arrow based positioning, thanks for making this ! I can now uninstall “spectacle” which I was using for the same purpose but the key bindings were unintuitive.

— Gaurav

the only issue I have with miro-windows-manager is the fact that I didn't discover it sooner. just getting into HammerSpoon and love this 🥄 ... so handy, nice work @miromannino !

— zanuka

Articles

A suggested tutorial on Mic Sumner: https://www.micsumner.com/how-to-organise-window-viewing-areas-in-mac-os/

License (MIT)

Copyright (c) 2018 Miro Mannino

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.