AppleScript Support

Control LookAway with AppleScript commands.

LookAway supports AppleScript so you can control it programmatically or trigger actions using apps like Shortcuts, Alfred, Raycast, or your own scripts.

Use these commands to start breaks, pause/resume work mode, postpone breaks, or open settings.

Available AppleScript Commands

All commands require LookAway 1.11.3 or later.

Start Next Break

Begins the next scheduled break immediately.

tell application "LookAway" to start next break

Start Long Break

Forces the start of a long break, regardless of schedule.

tell application "LookAway" to start long break

Pause Work Mode

Pauses LookAway’s reminders and scheduled breaks.

tell application "LookAway" to pause

Pause Temporarily

Pauses LookAway for a specific number of seconds.

tell application "LookAway" to pause temporarily for 600 -- pauses for 10 minutes

Postpone Break

Postpones the upcoming break by a specified number of seconds.

tell application "LookAway" to postpone break by 300 -- delays by 5 minutes

Resume Work Mode

Resumes LookAway after being paused or postponed.

tell application "LookAway" to resume

Open Settings

Opens the LookAway settings window.

tell application "LookAway" to open settings

Tips

  • You can combine these commands with do shell script, cron, or third-party automation tools.
  • Use in tandem with LookAway’s Automations to create powerful workflows.
  • All commands require that LookAway is running.

Looking for more? Check out Automations to trigger Shortcuts and scripts during breaks.