From 0237656b19a4dec0280b418b0183c95a0cab71e6 Mon Sep 17 00:00:00 2001 From: Teddy Wing Date: Mon, 17 Jun 2019 04:46:49 +0200 Subject: Add README --- README.rst | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 README.rst diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..39757bf --- /dev/null +++ b/README.rst @@ -0,0 +1,75 @@ +WindowMode.spoon +================ + +A Hammerspoon_ Spoon that provides a keyboard mode for manipulating windows. + +Upon activating the mode, the following shortcuts are available: + ++-------+----------------------------+ +| ``h`` | Move window left 20 units | ++-------+----------------------------+ +| ``j`` | Move window down 20 units | ++-------+----------------------------+ +| ``k`` | Move window up 20 units | ++-------+----------------------------+ +| ``l`` | Move window right 20 units | ++-------+----------------------------+ + ++-------------+----------------------------+ +| ``Shift-h`` | Move window left 5 units | ++-------------+----------------------------+ +| ``Shift-j`` | Move window down 5 units | ++-------------+----------------------------+ +| ``Shift-k`` | Move window up 5 units | ++-------------+----------------------------+ +| ``Shift-l`` | Move window right 5 units | ++-------------+----------------------------+ + ++-------+------------------------------+ +| ``[`` | Move window left one screen | ++-------+------------------------------+ +| ``]`` | Move window right one screen | ++-------+------------------------------+ + ++-------+---------------------------------+ +| ``e`` | Reduce window height 20 units | ++-------+---------------------------------+ +| ``s`` | Reduce window width 20 units | ++-------+---------------------------------+ +| ``d`` | Increase window height 20 units | ++-------+---------------------------------+ +| ``f`` | Increase window width 20 units | ++-------+---------------------------------+ + ++-------------+--------------------------------+ +| ``Shift-e`` | Reduce window height 5 units | ++-------------+--------------------------------+ +| ``Shift-s`` | Reduce window width 5 units | ++-------------+--------------------------------+ +| ``Shift-d`` | Increase window height 5 units | ++-------------+--------------------------------+ +| ``Shift-f`` | Increase window width 5 units | ++-------------+--------------------------------+ + + +Install +------- +:: + + $ cd ~/.hammerspoon/Spoons + $ git clone https://github.com/teddywing/WindowMode.spoon.git + +Add the following to your Hammerspoon config, using your preferred hotkey to +activate & deactivate the mode:: + + hs.loadSpoon('WindowMode') + spoon.WindowMode:bindHotkeys({ mode = {{'ctrl', 'option'}, 'w'} }) + + +License +------- +Copyright © 2019 Teddy Wing. Licensed under the GNU GPLv3+ (see the included +COPYING file). + + +.. _Hammerspoon: https://www.hammerspoon.org/ -- cgit v1.2.3