WindowKeeper

macOS utility remembering position of windows when reconnecting to external monitors

MIT License

Stars
3
Committers
1

WindowKeeper

This software automates window repositioning when reconnecting to external monitors on macOS.

For instance, imagine that you are using your MacBook at home, with two external monitors. As a university student, you take the laptop with you in the morning. Then at school and during class breaks, you are working on your homework using your laptop. In the evening, when you come home and hook the laptop back to the two external monitors, your program windows get automatically repositioned the way you left them.

Features

  • Automatic and manual mode
  • Windows accross Spaces are supported
  • Multi-monitor set-up supported

Usage

  • Use CMD+ALT+CTRL+S to store current window configuration
  • Use CMD+ALT+CTRL+R to restore last saved window configuration
  • If you do not want to use automatic mode, please modify the automaticStoreRestore constant in Spoons/WindowKeeper.spoon/init.lua

Installation notes

  • Install Hammerspoon by following its installation notes
  • Install a Spaces API plugin, following its installation notes
  • Download this repository, and install the Spoon, as described here
  • Add the content of init.lua file, found at the root of this repository, to your ~/.hammerspoon/.init.lua file. If it does not exist, create it.

Dependencies

Requirements

  • macOS

License

MIT