Namespace power

Monitor and control system power: prevent sleep, read battery state, respond to power events, and lock or sleep the machine.

Preventing sleep

// Prevent the display from sleeping while a task runs
hs.power.preventSleep("display")
// ... do work ...
hs.power.allowSleep("display")
Copy

Watching for system events

hs.power.addEventWatcher(event => {
   if (event === "screensDidLock") console.log("Screen locked!")
})
Copy

Reading battery state

const info = hs.power.batteryInfo()
if (info) {
   console.log(`Battery: ${info.percentage}%, ${info.timeRemaining} minutes remaining`)
}
Copy