docs » Spacer

Autosave name used with macOS to save menu bar item position.

Key used for persisting space names between Hammerspoon launches via hs.settings.

Default hotkey to use for the space chooser and fullscreen

hs.timer used in fullscreenWindowToLeft to perform a delayed left click.

Keystroke representing shortcut to exit a full screen application. Defaults to

int with the ID of the currently focused space.

Logger object used within the Spoon. Can be accessed to set the default log

Spacer specific log level override, see hs.logger.setLogLevel for options.

hs.menubar representing the menu bar for Spacer.

Table with an ordered list of the space names, which is used when loading

Table holding an ordered list of space IDs, which is then used to resolve

hs.chooser object representing the Space chooser.

Table with key-value mapping of Space ID to it's user set name.

hs.spaces.watcher instance used for monitoring for space changes.

Menu item for tiling window to the left. Set this according to your language.

Menu "section" which has tiling options. Set this according to your language.

Exit fullscreen on window.

• None

• None

• This presses the keystroke cmd+ctrl+f by default, which should work globally
  • Configurable via exitFullscreenKeystroke

Fullscreen app's focused window to the left of current space.

• app - hs.application to fullscreen

• None

• Attempts to select Window -> Tile Window to Left of Screen in app menu
  • Manually configurable via tilingMenuSection and tilingMenuItem
• If this doesn't work, it will manually macro the OS flow for this
  • Show the menu for the green resize button in the top left
  • Press Down, Down, and Return to select Tile Window to Left of Screen
• Clicks around the top-left of the current screen to exit tiling and fullscreen
• Returns mouse to original position
• All credit for this goes to clay_golem on Apple StackExchange
  • https://apple.stackexchange.com/posts/462160/revisions

Spoon initializer method for Spacer.

• None

• None

Spoon start method for Spacer. Creates/starts menu bar item and space watcher.

• None

• None

Spoon stop method for Spacer. Deletes menu bar item and stops space watcher.

• None

• None

Toggle the fullscreen state of current window to left of space.

• args - Args provided to hs CLI after "--" via _cli.args.

• None

• This is bound by default to Cmd+Shift+F and will call fullscreenWindowToLeft or exitFullscreen based on the current fullscreen state of the application.