Skip to content
orenatobr.com

SECTION 06

Miscellaneous

Everything else.

.hammerspoon

v1.1.1-rf.2 · Nov 20, 2026

A fork of Hammerspoon, the macOS automation tool, that ships a ready-to-use Hammerspoon.app together with my personal Lua config: window and app automation, hotkeys, auto brightness and more. All credit for Hammerspoon goes to its original authors.

Latest changes

  • Hammerspoon fork build with personal config. Install: curl -fsSL https://raw.githubusercontent.com/orenatobr/.hammerspoon/main/scripts/fork/install.sh | bash

Download

How to install

What you need

  • A Mac running macOS.
  • A published release of the fork: the installer downloads the app from it.

Heads up. The app is ad-hoc signed, not notarized. The installer clears the quarantine flag for you.

  1. Run the installer

    It installs Hammerspoon.app into /Applications and the config into ~/.hammerspoon. An existing config is backed up first.

    curl -fsSL https://raw.githubusercontent.com/orenatobr/.hammerspoon/main/scripts/fork/install.sh | bash
  2. Open Hammerspoon

    Launch it from /Applications.

  3. Allow Accessibility

    Open System Settings > Privacy & Security > Accessibility and enable Hammerspoon.

  4. Reload the config

    Choose Reload Config in the Hammerspoon menu if the automations are not active yet.