docs » AppWindowSwitcher

macOS application aware, keyboard driven window switcher. Spoon on top of Hammerspoon.

Download: https://github.com/Hammerspoon/Spoons/raw/master/Spoons/AppWindowSwitcher.spoon.zip

Switches windows by focusing and raising them. All windows matching a bundelID, a list of bundleID's, an application name matchtext, or a list of application name matchtexts are switched by cycling them. Cycling applies to visible windows of currently focused space only. The spoon does not launch applications, it operates on open windows of running applications.

Example ~/.hammerspoon/init.lua configuration:

hs.loadSpoon("AppWindowSwitcher")
    -- :setLogLevel("debug") -- uncomment for console debug log
    :bindHotkeys({
        ["com.apple.Terminal"]        = {hyper, "t"},
        [{"com.apple.Safari",
          "com.google.Chrome",
          "com.kagi.kagimacOS",
          "com.microsoft.edgemac", 
          "org.mozilla.firefox"}]     = {hyper, "q"},
        ["Hammerspoon"]               = {hyper, "h"},
        [{"O", "o"}]                  = {hyper, "o"},
    })

In this example,

• hyper-t cycles all terminal windows (matching a single bundleID),
• hyper-q cycles all windows of the five browsers (matching either of the bundleIDs)
• hyper-h brings the Hammerspoon console forward (matching the application title),
• hyper-o cycles all windows whose application title starts with "O" or "o".

The cycling logic works as follows:

• If the focused window is part of the application matching a hotkey, then the last window (in terms of macOS windows stacking) of the matching application(s) will be brought forward and focused.
• If the focused window is not part of the application matching a hotkey, then the first window (in terms of macOS windows stacking) i of the matching applications will be brought forward and focused.