Totem is a Hammerspoon window manager script that allows you to easily manage window positions using hotkeys.
- Move windows to predefined positions on the screen
- Supports various window positions such as center, left, right, top, bottom, and more
- Easily configurable hotkeys
- Install Hammerspoon.
- Clone this repository or download the
init.lua
file. - Place the
init.lua
file in your Hammerspoon configuration directory (~/.hammerspoon/
).
-
Open Hammerspoon and ensure it is running.
-
Edit your
~/.hammerspoon/init.lua
file to include the following line to load Totem:local totem = require("init") totem:init()
-
Configure your hotkeys by calling the
bindHotKeys
function with your desired key mappings. For example:totem:bindHotKeys({ center = {{"cmd", "alt"}, "C"}, left = {{"cmd", "alt"}, "Left"}, right = {{"cmd", "alt"}, "Right"}, top = {{"cmd", "alt"}, "Up"}, bottom = {{"cmd", "alt"}, "Down"}, top_left = {{"cmd", "alt"}, "1"}, top_right = {{"cmd", "alt"}, "2"}, bottom_left = {{"cmd", "alt"}, "3"}, bottom_right = {{"cmd", "alt"}, "4"}, })
-
Reload your Hammerspoon configuration by clicking the Hammerspoon menu icon and selecting "Reload Config".
This project is licensed under the MIT License. See the LICENSE file for details.
Vincenzo De Petris - vincenzodepetris@gmail.com