Skip to content
Hammerspoon plugin to use the keyboard as a mouse by selecting successively smaller grids on the screen
Lua HTML Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Griddle.spoon
html
markdown
Griddle.spoon.zip
LICENSE
README.md
docs.json
docs_index.json
generateDocs.sh

README.md

docs » Griddle


Use the keyboard as a mouse by selecting successively smaller grids on the screen

Download: https://github.com/msolomon/griddle/raw/master/Griddle.spoon.zip

Griddle is used by entering Griddle mode using a hotkey. An overlay will then appear over the screen, dividing it into a 3x3 grid with a key shortcut corresponding to each. Pressing the key shortcut moves the mouse to that grid location and the grid is replaced with a new smaller grid. This process is repeated until the mouse is in the desired location, then another key (usually f) is pressed to click the mouse and the grid disappears.

This allows the user to click arbitrary screen locations without using the physical mouse. With a bit of practice, this can be quite efficient. Double/triple click, right click, click-and-drag, and multiple monitors are all supported.

API Overview

API Documentation

Variables

absoluteShortcuts
Signature Griddle.absoluteShortcuts
Type Variable
Description A table mapping keys to locations on the on-screen grid.
exitAfterLeftClick
Signature Griddle.exitAfterLeftClick
Type Variable
Description A boolean determining whether to exit Griddle mode after pressing leftClick. Defaults to true.
exitAfterRightClick
Signature Griddle.exitAfterRightClick
Type Variable
Description A boolean determining whether to exit Griddle mode after pressing rightClick. Defaults to false.
fineMoveDistance
Signature Griddle.fineMoveDistance
Type Variable
Description The number of pixels to move when using relativeShortcuts. Defaults to 8.
otherShortcuts
Signature Griddle.otherShortcuts
Type Variable
Description A table mapping keys to other actions in Griddle mode:
relativeShortcuts
Signature Griddle.relativeShortcuts
Type Variable
Description A table mapping keys to directions relative to the present mouse location.

Methods

bindHotkeys
Signature Griddle:bindHotkeys()
Type Method
Description Bind a hotkey to enter Griddle mode.
enter
Signature Griddle:enter()
Type Method
Description Enter Griddle mode on the sceen with a focused window.
exit
Signature Griddle:exit()
Type Method
Description Exit Griddle mode.
start
Signature Griddle:start()
Type Method
Description Enable Griddle and bind any configured hotkeys.
You can’t perform that action at this time.