Skip to content

Instantly share code, notes, and snippets.

@dainank

dainank/init.lua

Last active December 11, 2025 23:50
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save dainank/fd236aa71a8b3fcf637b9d8428ce98db to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save dainank/fd236aa71a8b3fcf637b9d8428ce98db to your computer and use it in GitHub Desktop.
Download ZIP
Hammerspoon Click-Through Support
Raw
init.lua
-- Helper: Find window under mouse
local function windowUnderMouse()
local mousePos = hs.mouse.absolutePosition()
for _, win in ipairs(hs.window.orderedWindows()) do
if win:isVisible() then
local frame = win:frame()
if mousePos.x >= frame.x and mousePos.x <= frame.x + frame.w and
mousePos.y >= frame.y and mousePos.y <= frame.y + frame.h then
return win
end
end
end
return nil
end
-- Log file setup
local logfilePath = os.getenv("HOME") .. "/hammerspoon_clickthrough.log"
local logfile = assert(io.open(logfilePath, "a"))
local function log(message, level)
level = level or "INFO"
local timestamp = os.date("%Y-%m-%d %H:%M:%S")
logfile:write(string.format("%s [%s] %s\n", timestamp, level, message))
logfile:flush()
end
-- Eventtap: Focus window under mouse and log click
clickLogger = hs.eventtap.new({hs.eventtap.event.types.leftMouseDown}, function(event)
local win = windowUnderMouse()
local frontmost = hs.window.frontmostWindow()
if win then
if win:id() ~= (frontmost and frontmost:id()) then
win:focus()
log("Focused window: " .. (win:title() or "Untitled"))
else
log("Clicked already-focused window: " .. (win:title() or "Untitled"))
end
else
log("No window under mouse")
end
return false -- allow original click
end)
clickLogger:start()
-- Graceful shutdown
hs.shutdownCallback = function()
log("Hammerspoon shutting down", "INFO")
logfile:close()
end
@autoclave73
Copy link

autoclave73 commented Dec 11, 2025

this will sometimes make you click through and ignore right-click context menus when they display over an unfocused window

This modified Eventtap will detect if there's a context menu under the mouse and allow clicking entries

-- Eventtap: Focus window under mouse and log click
clickLogger = hs.eventtap.new({hs.eventtap.event.types.leftMouseDown}, function(event)
    local win = windowUnderMouse()
    local frontmost = hs.window.frontmostWindow()
    local ax = require("hs.axuielement")
    local mousePos = hs.mouse.getAbsolutePosition()
    local element = ax.systemElementAtPosition(mousePos)
    if element then
        local role = element:attributeValue("AXRole")
        if role == "AXMenu" or role == "AXMenuItem" then
        return false
    else
        if win then
            if win:id() ~= (frontmost and frontmost:id()) then
                win:focus()
                log("Focused window: " .. (win:title() or "Untitled"))
            else
                log("Clicked already-focused window: " .. (win:title() or "Untitled"))
            end
        end
    end
    else
        log("No window under mouse")
    end
    return false -- allow original click
end)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment