macaroni

restore

Description:
The restore executor is used to restore a specified window or application.

Parent: execute, then, else

Value (simple form): string specifying process name and/or window title (checks if either match)
Value (key/value form):

• restore: string, required, specifying process name and/or window title (checks if either match)
• title: string, optional, specifying window title (checks if specified title is contained in actual title)
• process: string, optional, specifying process file name, path and extension optional (checks file name and full name)
• exclude: string, optional, specifying process or window title exclusions (if process or title contains an exclusion, it will not be restored)
• all: bool, optional, specifying if multiple windows matching the title/process/exclusions specified, they will all be restored if true, only the first if false (default is false)

# simple form
- restore: (string)

# simple example
- restore: notepad.exe

# key/value form
- restore: (string, required)
  process: (string, optional)
  title: (string, optional)
  exclude: (string, optional)
  all: (boolean, optional)

# key/value example
- restore: notepad.exe
  title: favorites.txt

EXAMPLE

# restores an application with a matching caption
commands:
- examples:
  - Restore Visual Studio Code
  - Restore Chrome
  triggers:
  - phrase: restore {application}
  execute:
  - restore: '{application}'

Status: ✅ IMPLEMENTED