Browse the docs

Screen unlocks

Runs the macro when you unlock the screen.

The screen unlocks

Keyboard Maestro: Unlock

Details #

Fires once when the screen is unlocked. It takes no parameters. The Group scope still applies, checked against the app that is in front at the time, so an Everywhere Group is the usual choice.

{{triggerValue}} is empty.

Secure input does not affect this trigger.

The macro runs after the unlock, with the desktop available.

Parameters #

This trigger takes no parameters.

Every trigger also takes Limits: a cooldown, the first time each day, every nth time, twice within seconds, a chance, only while you are at the Mac, on one Mac, or in a State. See Limits on any trigger.

Examples #

Unlock notice
When
  1. The screen unlocks
Do
  1. Show a notification “Unlock trigger ran”
Open in Switchboard to try it

Gotchas #

  • Not fired reasons: disabled, groupOff, scope, paused, conditionFalse.

See also #

Mac wakes, Mac sleeps, Screen locks, Screen unlocks, Triggers