Hammerspoon 切换程序和窗口大小管理

Hammerspoon is a tool for powerful automation of macOS. At its core, Hammerspoon is just a bridge between the operating system and a Lua scripting engine. What gives Hammerspoon its power is a set of extensions that expose specific pieces of system functionality, to the user.

下面的脚本实现了:

• 切换程序: 按下快捷键 Alt+键 就会切换到键对应的程序 (如果程序没有打开则打开，如果不是当前程序则激活为当前程序):
  • 按下 Alt+F 切换到 Finder
  • 按下 Alt+S 切换到 Safari
  • …
• 窗口管理:
  • 窗口最大化: Alt+Ctrl+Return
  • 窗口左半屏: Alt+Ctrl+Cmd+Left
  • 窗口右半屏: Alt+Ctrl+Cmd+Right
  • 窗口居中: Alt+Ctrl+C
  • 窗口靠左: Alt+Ctrl+Left
  • 窗口靠右: Alt+Ctrl+Right
• 多屏管理:
  • 在屏幕间移动光标: Ctrl+Z
  • 在屏幕间移动程序: Ctrl+X
• 蓝牙管理:
  • 打开蓝牙: Alt+T
  • 关闭蓝牙: Alt+T
  • 下午 6 点后系统休眠时自动关闭蓝牙
• 其他
  • 按下 Ctrl+H 隐藏或者显示桌面文件
  • 按下 Ctrl+D: 切换 Light 和 Dark 模式
  • 按下 Alt+Z: 前一个标签页
  • 按下 Alt+X: 后一个标签页
  • 按下 CMD+H: 方向左
  • 按下 CMD+L: 方向右
  • 按下 CMD+J: 方向下
  • 按下 CMD+K: 方向上
  • 按下 CMD+I: 删除键

实现了 Thor 和 Rectangle 的功能，并且解决了 Thor 激活 Finder 的 Bug。

-- 显示 Finder
function activateFinder()
    -- 如果没有 Finder 窗口打开，则返回 nil
    local focusedFinder = hs.application.get("com.apple.finder"):focusedWindow()

    if (focusedFinder == nil) then
        -- 创建 Finder 窗口并让其获得焦点
        hs.application.launchOrFocus("finder")
    else
        -- 打开的 Finder 窗口获得焦点
        hs.application.get("com.apple.finder"):setFrontmost(true)
    end
end

-- 隐藏/显示桌面文件
function toggleDesktopFiles()
    -- 找到可见文件个数，如果可见文件数为 0 则说明文件都隐藏了或者没有文件执行显示操作，否则隐藏
    script = [[
        n=$(ls -lO ~/Desktop | grep -v hidden | grep -v total | wc -l | xargs);
        [ $n -eq '0' ] && chflags nohidden ~/Desktop/* || chflags hidden ~/Desktop/*
    ]]
    hs.execute(script)
end

-- 切换 Light 和 Dark 模式
function toggleDarkAnLight()
    script = [[
        tell application "System Events"
            tell appearance preferences
                set dark mode to not dark mode
            end tell
        end tell
    ]]
    hs.osascript.applescript(script)
end

--------------------------------------------------------------------------------------
-- 按下 "Alt+键" 会打开或激活对应的应用，如果应用不是绝对路径，则指的是 /Applications 中的应用 --
--------------------------------------------------------------------------------------
function openAppUsingAltAndkey(keyAppPairs)
    for key, app in pairs(keyAppPairs) do
        -- local app = entry[2]
        -- local key = entry[1]

        -- 路径不以 / 开头，则指的是 /Applications 中的应用，把路径补充完整
        if string.sub(app, 0, 1) ~= "/" then
            app = "/Applications/" .. app
        end

        -- hs.alert.show(app)

        hs.hotkey.bind({"alt"}, key .. "", function()
            hs.application.open(app)

            -- 解决某些应用 x 全屏的时候 (如 Safari)，切换到桌面 n，当前应用仍然为应用 x，按下激活应用 x 的快捷键不生效的问题
            hs.application.frontmostApplication():setFrontmost(true)
        end)
    end
end

--------------------------------------------------------------------------------------
--                                        窗口管理                                   --
--------------------------------------------------------------------------------------
-- 设置当前窗口的大小
function sizeFocusedWindow(mode)
    return function()
        local win = hs.window.focusedWindow()
        local f = win:frame()
        local screen = win:screen()
        local max = screen:frame()

        f.x = max.x
        f.y = max.y
        f.w = max.w
        f.h = max.h

        if mode == "Max" then

        end
        if mode == "Half Left" then
            f.w = max.w / 2
        end
        if mode == "Half Right" then
            f.x = max.x + max.w / 2
            f.w = max.w / 2
        end

        win:setFrame(f, 0) -- 0 取消动画
    end
end

-- 移动当前窗口
function moveFocusedWindow(mode)
    return function()
        local win = hs.window.focusedWindow()
        local f = win:frame()
        local screen = win:screen()
        local max = screen:frame()

        if mode == "Edge Left" then
            f.x = max.x
            f.y = 0
        end
        if mode == "Edge Right" then
            f.x = max.x + (max.w - f.w)
            f.y = 0
        end
        if mode == "Center" then
            f.x = max.x + (max.w - f.w) / 2
            f.y = max.y + (max.h - f.h) * (1-0.618)
            f.x = f.x > 0 and f.x or 0
            f.y = f.y > 0 and f.y or 0
        end

        win:setFrame(f, 0) -- 0 取消动画
    end
end

-- 隐藏当前窗口
function hideFocusedWindow()
    hs.application.frontmostApplication():hide()
end

--------------------------------------------------------------------------------------
--                                        多屏管理                                   --
--------------------------------------------------------------------------------------
-- 在屏幕间移动光标
function moveCursorBetweenDesktops()
    local screen = hs.mouse.getCurrentScreen()
    local nextScreen = screen:next()
    local rect = nextScreen:fullFrame()
    local center = hs.geometry.rectMidPoint(rect)

    hs.mouse.setAbsolutePosition(center)
    hs.alert.show('🐶', nextScreen)
    -- hs.alert.show('🐻‍❄️🦮🐶🦅🐘🦁', nextScreen)
end

-- 在屏幕间移动程序
function moveFocusedWindowBetweenDesktops()
    local win = hs.window.focusedWindow()
    local screen = win:screen()
    win:moveToScreen(screen:next(), 0)

    -- 移动到其他屏幕后应用的标题包含 "RDP-Windows" 则全屏
    if string.find(win:title(), "RDP-Windows", 1, true) then
        win:setFullScreen(true)
    end
end

--------------------------------------------------------------------------------------
--                                        蓝牙管理                                   --
--------------------------------------------------------------------------------------
-- 去掉字符串后面的空白字符
function trim(s)
    return (s:gsub("^%s*(.-)%s*$", "%1"))
end

-- 打开与关闭蓝牙，需要安装蓝牙工具 brew install blueutil
function toggleBlueTooth()
    -- 打开或关闭蓝牙
    hs.execute("/opt/homebrew/bin/blueutil -p toggle")

    -- 检查蓝牙状态
    local state = trim(hs.execute("/opt/homebrew/bin/blueutil -p"))

    if state == "1" then
        hs.alert.show("蓝牙已打开")
    else
        hs.alert.show("蓝牙已关闭")
    end
end

-- 系统事件监听回调函数，事件类型可参考 https://www.hammerspoon.org/docs/hs.caffeinate.watcher.html
-- 系统休眠时关闭蓝牙: https://gist.github.com/ysimonson/fea48ee8a68ed2cbac12473e87134f58
function watchCallback(event)
    -- 18 点后休眠时才自动关闭蓝牙
    local hour = os.date("*t").hour
    if event == hs.caffeinate.watcher.systemWillSleep and hour >= 18 then
        hs.execute("/opt/homebrew/bin/blueutil -p 0")
    end
end

watcher = hs.caffeinate.watcher.new(watchCallback)
watcher:start()

--------------------------------------------------------------------------------------
--                                        Send key                                  --
--------------------------------------------------------------------------------------
-- 触发指定的键 a，例如方向键左为 left
function sendKey(a)
    return function()
        hs.eventtap.keyStroke({}, a)
    end
end

-- 下一个标签页
function nextTab()
    hs.eventtap.keyStroke({"cmd", "shift"}, ']')
end
function prevTab()

    -- 上一个标签页
    hs.eventtap.keyStroke({"cmd", "shift"}, '[')
end

--------------------------------------------------------------------------------------
--                                          Misc                                    --
--------------------------------------------------------------------------------------

-- 显示当前时间
function showTime()
    local weekdays = {"周一", "周二", "周三", "周四", "周五", "周六", "周日"}
    local weekday = tonumber(os.date("%w"))
    local t = os.date(weekdays[weekday] .. "  %H 点 %M")
    hs.alert.show(t)
end

--------------------------------------------------------------------------------------
--                                        快捷键绑定                                  --
--------------------------------------------------------------------------------------
-- 键和应用对
-- 按下 Alt+对应的键切换程序，例如按 Alt+S 启动或激活 Safari
-- 提示: 数字作为键，需要使用 [Number] 的格式
local KEY_APP_PAIRS = {
    A = "IntelliJ IDEA CE.app",
    C = "Google Chrome.app",
    D = "Dash.app",
    E = "Visual Studio Code.app",
    Q = "QQ.app",
    -- Q = "/Users/biao/Qt/Qt Creator.app",
    S = "Safari.app",
    W = "WeChat.app",
    [1] = "iTerm.app",
    [2] = "Notable.app",
    [3] = "Typora.app",
    [4] = "/System/Applications/Preview.app",
}
openAppUsingAltAndkey(KEY_APP_PAIRS)

hs.hotkey.bind({"alt"},  "F", activateFinder)                   -- 显示 Finder
hs.hotkey.bind({"alt"},  "H", hideFocusedWindow)                -- 隐藏当前窗口
hs.hotkey.bind({"alt"},  "X", nextTab)                          -- 下一个标签页
hs.hotkey.bind({"alt"},  "Z", prevTab)                          -- 上一个标签页
hs.hotkey.bind({"alt"},  "T", toggleBlueTooth)                  -- 打开与关闭蓝牙
hs.hotkey.bind({"cmd"},  "H", sendKey("left"))                  -- 方向键左
hs.hotkey.bind({"cmd"},  "L", sendKey("right"))                 -- 方向键右
hs.hotkey.bind({"cmd"},  "J", sendKey("down"))                  -- 方向键下
hs.hotkey.bind({"cmd"},  "K", sendKey("up"))                    -- 方向键上
hs.hotkey.bind({"cmd"},  "I", sendKey("delete"))                -- 删除
hs.hotkey.bind({"ctrl"}, "H", toggleDesktopFiles)               -- 隐藏/显示桌面文件
hs.hotkey.bind({"ctrl"}, "D", toggleDarkAnLight)                -- 切换 Light 和 Dark 模式
hs.hotkey.bind({"ctrl"}, "Z", moveCursorBetweenDesktops)        -- 在屏幕间移动光标
hs.hotkey.bind({"ctrl"}, "X", moveFocusedWindowBetweenDesktops) -- 在屏幕间移动程序
hs.hotkey.bind({"ctrl"}, "T", showTime)                         -- 显示当前时间
hs.hotkey.bind({"cmd", "alt", "ctrl"}, "R", hs.reload)          -- 重新加载配置

hs.hotkey.bind({"alt", "ctrl", "cmd"}, "Left",   sizeFocusedWindow("Half Left"))  -- 窗口左半屏
hs.hotkey.bind({"alt", "ctrl", "cmd"}, "Right",  sizeFocusedWindow("Half Right")) -- 窗口右半屏
hs.hotkey.bind({"alt", "ctrl"},        "Return", sizeFocusedWindow("Max"))        -- 窗口最大化
hs.hotkey.bind({"alt", "ctrl"},        "Left",   moveFocusedWindow("Edge Left"))  -- 窗口靠左
hs.hotkey.bind({"alt", "ctrl"},        "Right",  moveFocusedWindow("Edge Right")) -- 窗口靠右
hs.hotkey.bind({"alt", "ctrl"},        "C",      moveFocusedWindow("Center"))     -- 窗口居中

-- 双击 ctrl
ctrlDoublePress = require("ctrlDoublePress")
ctrlDoublePress.timeFrame = 2
ctrlDoublePress.action = function()
    moveCursorBetweenDesktops()
end

Hammerspoon 还能实现非常多的其他功能，可以阅读帮助文档查看更多 API 的使用。

• 双击 Ctrl 触发操作