Skip to content

Latest commit

 

History

History
73 lines (47 loc) · 2.15 KB

README.md

File metadata and controls

73 lines (47 loc) · 2.15 KB
Raw

🌄 🚀 SkyRocket.spoon

This Hammerspoon tool lets you resize and move windows by clicking + dragging them while holding down modifier keys.

This attempts to emulate such things as:

  • BetterTouchTool resize/move functions
  • Coderage Software's abandoned Zooom/2 software
  • Linux desktop move/resize hot keys

I created this to fill the void after Zooom/2 was abandoned by the original developer.

SkyRocket move and resize demo

Installation

This tool requires Hammerspoon to be installed and running.

The easiest thing to do is paste this in:

mkdir -p ~/.hammerspoon/Spoons
git clone https://github.com/dbalatero/SkyRocket.spoon.git ~/.hammerspoon/Spoons/SkyRocket.spoon

Usage

Once you've installed it, add this to your ~/.hammerspoon/init.lua file:

local SkyRocket = hs.loadSpoon("SkyRocket")

sky = SkyRocket:new({
  -- Opacity of resize canvas
  opacity = 0.3,

  -- Which modifiers to hold to move a window?
  moveModifiers = {'cmd', 'shift'},

  -- Which mouse button to hold to move a window?
  moveMouseButton = 'left',

  -- Which modifiers to hold to resize a window?
  resizeModifiers = {'ctrl', 'shift'},

  -- Which mouse button to hold to resize a window?
  resizeMouseButton = 'left',
})

Moving

To move a window, hold your moveModifiers down, then click moveMouseButton and drag a window.

Resizing

To resize a window, hold your resizeModifiers down, then click resizeMouseButton and drag a window.

Disabling move/resize for apps

You can disable move/resize for any app by adding it to the disabledApps option:

sky = SkyRocket:new({
  -- For example, if you run your terminal in full-screen mode you might not
  -- to accidentally resize it:
  disabledApps = {"Alacritty"},
})

Thanks

I took initial inspiration from this gist by @kizzx2, and heavily modified it to be packaged up in this Spoon. I also came up with a different technique for resizing to address the low frame-rate when attempting to resize in real time.