Hammerspoon

Hammerspoon 是一个强大的自动化工具，可以让你通过 Lua 脚本来自动化你的 macOS 系统。

安装

[[macOS]] 可以直接通过 [[brew]] 安装：

1
brew install hammerspoon

配置

Hammerspoon 的配置文件位于 ~/.hammerspoon/init.lua。

Core API

execute

1
-- 运行 Shell 命令
2
hs.execute(command[, with_user_env])

API

• 文档：Hammerspoon Docs

hs.screen

屏幕控制

函数：

1
-- 获取主屏幕
2
hs.screen.mainScreen()
3
-- 获取当前焦点屏幕
4
hs.screen.mainScreen()

方法：

1
-- 获取当前屏幕旋转角度（默认 0）
2
hs.screen:rotate()

获取所有屏幕列表：

1
hs.inspect(hs.screen.allScreens())

hs.timer

根据时间规则执行

• .hours(hour) ：将小时转换为秒 #Function
• .doAfter(doAfter(sec, fn))：延迟调用函数 #Constructor
  • hs.timer.doAfter(2, function() fn end)
• .doEvery(second, fn)：间隔 N 秒执行指定函数 #Constructor
• .timer:fire() ：立即执行 #Methods

hs.notify

hs.notify

• .new ([fn,][attributes])：系统通知 #Constructor
• .show(title, subTitle, information[, tag]) ：系统通知 send 简写 #Constructor

hs.inspect

1
-- 查看返回的表
2
hs.inspect()

hs.caffeinate

watcher

• 0 - systemDidWake：系统已唤醒
• 1 - systemWillSleep：系统将休眠
• 2 - systemWillPowerOff：系统关闭电源
• 3 - screensDidSleep：显示器已经进入休眠状态
• 4 - screensDidWake：显示器已从睡眠状态唤醒
• 7 - screensaverDidStart：屏保已启动
• 8 - screensaverWillStop：屏保将停止
• 9 - screensaverDidStop：屏保已经停止
• 10 - screensDidLock：屏幕已经锁定
• 11 - screensDidUnlock：屏幕已经解锁