Hotkey Pressed
Runs when a keyboard shortcut is pressed.
Shortcut
—
Mac Automation Variables
Explore the app, window, date, network, audio, battery, system, Trigger, and Action values available to Rulr When–If–Do Rules.
Triggers
Events that start a Rule from shortcuts, schedules, apps, windows, files, devices, networks, power, or scripts.
Input
Text TypedPRO
Runs when specific text is typed.
TextCase Mode
—
Clipboard ChangedPRO
Runs when the clipboard contents change.
—
Content TypeTextImage PathFile Paths
Folder Contents ChangedPRO
Runs when a direct item in a folder is added, removed, or renamed.
FolderChange Type
Watched FolderItem CountChange TypeItem NamePrevious Item NameItem PathPrevious Item PathItem Kind
Volume Mounted
Runs when a disk or volume mounts.
—
Mounted Volume NameMounted Volume Path
Volume Unmounted
Runs when a disk or volume unmounts.
—
Unmounted Volume NameUnmounted Volume Path
USB Device Connected
Runs when a USB device connects.
—
Device NameVendor IDProduct IDSerial Number
USB Device Disconnected
Runs when a USB device disconnects.
—
Device NameVendor IDProduct IDSerial Number
Application & Window
Application Became Frontmost
Runs when an application becomes frontmost.
Application
ApplicationApp NameBundle IDProcess ID
Application Launched
Runs when an application launches.
Application
ApplicationApp NameBundle IDProcess ID
Application Quit
Runs when an application quits.
Application
ApplicationApp NameBundle IDProcess ID
Application Stopped Being Frontmost
Runs when an application is no longer frontmost.
Application
ApplicationApp NameBundle IDProcess ID
Frontmost Application Changed
Runs when the frontmost application changes.
—
ApplicationApp NamePrevious ApplicationPrevious App Name
Focused Window ChangedPRO
Runs when a different window becomes focused.
—
ApplicationApp NameBundle IDProcess IDWindowWindow TitleWindow XWindow YWindow WidthWindow Height
Window CreatedPRO
Runs when an application creates a new window.
Application
ApplicationApp NameBundle IDProcess IDWindowWindow TitleWindow XWindow YWindow WidthWindow HeightWindow IDEvent KindWindow Count
Window ClosedPRO
Runs when an application closes a window.
Application
ApplicationApp NameBundle IDProcess IDWindowWindow TitleWindow XWindow YWindow WidthWindow HeightWindow IDEvent KindWindow Count
Focused Window Title ChangedPRO
Runs when the focused window's title changes.
—
ApplicationApp NameBundle IDProcess IDWindowWindow TitlePrevious Window Title
Window MinimizedPRO
Runs when an application minimizes a window.
Application
ApplicationApp NameBundle IDProcess IDWindowWindow TitleWindow XWindow YWindow WidthWindow HeightWindow IDEvent Kind
Focused Window Moved or ResizedPRO
Runs when the focused window moves or resizes.
—
ApplicationApp NameBundle IDProcess IDWindowWindow TitleWindow XPrevious Window XWindow YPrevious Window YWindow WidthPrevious Window WidthWindow HeightPrevious Window Height
Schedule
Scheduled Date & Time
Runs when a configured calendar date or time is reached.
Schedule FrequencyDate & TimeTimeWeekdaysTimeDaysTimeDatesTime
Scheduled Date and TimeSchedule Frequency
Timed Repeat
Runs when the configured interval elapses within the selected time range.
ValueUnitStart TimeStart DateEnd TimeEnd Date
Execution Count
System
Wake
Runs when the Mac wakes from sleep.
—
—
Sleep
Runs when the Mac is about to sleep.
—
—
Lock
Runs when the Mac session locks or becomes inactive.
—
Username
Unlock
Runs when the Mac session unlocks or becomes active.
—
Username
Rulr Launched at Login
Runs when macOS launches Rulr while you sign in to your account. Opening or reopening Rulr later does not run it.
—
Username
Network Connected
Runs when the Mac connects to a network or switches networks.
—
Connection StatusInterface TypeInterfaceService NameSSIDBSSID
Network Disconnected
Runs when the Mac loses network connectivity. Switching networks does not run it.
—
Connection StatusInterface TypeInterfaceService NameSSIDBSSID
Power Source Changed
Runs when the Mac switches between battery power and a power adapter.
Power Source
Power SourceBattery LevelIs ChargingIs ChargedIs Low Power Mode
Charging State Changed
Runs when the Mac starts charging, stops charging, or becomes fully charged.
Charging State
Power SourceBattery LevelIs ChargingIs ChargedIs Low Power Mode
Battery Level Changed
Runs when the Mac's battery level changes.
Battery Level
Power SourceBattery LevelIs ChargingIs ChargedIs Low Power Mode
Audio Output Device Changed
Runs when macOS selects a different audio output device.
—
Device NameDevice IDPrevious Device NamePrevious Device ID
Audio Input Device Changed
Runs when the default audio input device changes, connects, or disconnects.
—
Device NameDevice IDPrevious Device NamePrevious Device ID
Idle
Runs when the Mac has been idle for a specified duration.
DurationUnit
Idle Duration
Appearance Changed
Runs when macOS switches between Light and Dark appearance.
—
Appearance
Display Layout ChangedPRO
Runs when the display layout changes.
—
Display CountPrimary Display ID
Bluetooth Device Connected
Runs when a Bluetooth device connects to the Mac.
—
Connection StatusDevice NameDevice AddressIs ConnectedIs Paired
Bluetooth Device Disconnected
Runs when a Bluetooth device disconnects from the Mac.
—
Connection StatusDevice NameDevice AddressIs ConnectedIs Paired
Low Power Mode Changed
Runs when Low Power Mode turns on or off.
Low Power Mode
Power SourceBattery LevelIs ChargingIs ChargedIs Low Power Mode
Script
AppleScript
Runs when an AppleScript calls this Rule.
—
—
Python ScriptPRO
Runs when a Python script calls this Rule.
—
—
Shell ScriptPRO
Runs when a shell script calls this Rule.
—
—
Variables
Mac values used in If conditions, including app, window, date, network, audio, battery, and Trigger data.
Input
Current Clipboard Text
The text currently on your clipboard.
Text
Date & Time
Current Date and Time
The current date and time.
Date
Current Date
The current date.
Date
Current Time
The current time.
Time
Current Day of the Week
The current day of the week.
Text
Weekend or Weekday
Whether today falls on a weekend.
Boolean
Current Month
The current month.
Text
Current Year
The current four-digit year.
Number
Current Week Number
The current ISO week number.
Number
Current Time Zone
The identifier for the Mac's current time zone.
Text
Application & Window
Frontmost Application
The application you’re currently using.
Application
Application Is Running
Indicates whether a selected application is currently running.
Application
Frontmost App Name
The name of the frontmost application.
Text
Frontmost App Bundle ID
The unique identifier of the frontmost application, such as com.apple.Safari.
Text
Focused Window Title
The title of the focused window.
Text
Focused Window Horizontal Position
The horizontal position of the focused window, measured in points.
Number
Focused Window Vertical Position
The vertical position of the focused window, measured in points.
Number
Focused Window Width
The width of the focused window, measured in points.
Number
Focused Window Height
The height of the focused window, measured in points.
Number
Previously Focused Window Title
The title of the previously focused window.
Text
Previously Focused Window Horizontal Position
The horizontal position of the previously focused window, measured in points.
Number
Previously Focused Window Vertical Position
The vertical position of the previously focused window, measured in points.
Number
Previously Focused Window Width
The width of the previously focused window, measured in points.
Number
Previously Focused Window Height
The height of the previously focused window, measured in points.
Number
System
Battery Level
The Mac’s current battery level, from 0% to 100%, when available.
Number
Power Source
The Mac’s current power source, such as battery power or a power adapter.
Enum String
Battery Is Charging
Whether the Mac’s battery is currently charging.
Boolean
Connected Display Count
The number of displays currently connected to the Mac.
Number
Low Power Mode
Whether Low Power Mode is currently on.
Boolean
Network
Network Is Connected
Whether the Mac currently has a network connection.
Boolean
Wi-Fi Network Name
The name of the Wi-Fi network the Mac is currently connected to, when available.
Text
VPN Is Active
Whether a VPN connection is currently active.
Boolean
Audio
Audio Output Device Name
The name of the Mac’s current audio output device.
Text
Audio Input Device Name
The name of the Mac’s current audio input device.
Text
Output Volume
The Mac’s current audio output volume, from 0% to 100%.
Number
Input Volume
The Mac’s current audio input volume, from 0% to 100%.
Number
Rule
Trigger Name
The name of the Trigger that started this Rule run.
Text
Actions
Tasks a Rule performs across windows, text, files, browsers, OCR, scripts, and system controls.
Applications
Make Application Frontmost
Make an application frontmost and bring all of its open windows forward.
Application
—
Launch Application
Start an application if it is not already running.
Application
—
Quit Application
Quit an application normally.
Application
—
Show Application
Show an application's hidden windows.
Application
—
Hide Application
Hide all windows belonging to an application.
Application
—
Toggle Application VisibilityPRO
Hide the application when it is visible, or show it when the application is hidden.
Application
—
Windows
Show Window Switcher
Show an interactive switcher for choosing and focusing an open application window.
LayoutExclude Apps
—
Focus Window
Focus a window and bring it to the front.
Window
—
Move Window to ScreenPRO
Move the selected window to a screen.
WindowScreen
—
Toggle Minimize
Minimize the selected window.
Window
—
Toggle Full Screen
Enter or exit full screen for the selected window.
Window
—
Close Window
Close the selected window.
Window
—
Clipboard
Set Clipboard to Text
Put custom text and values from Variables on the clipboard. If the same text is already there, leave the clipboard unchanged.
Text
—
Set Clipboard to ImagePRO
Put an image file, the first matching image in a folder, or an Image Variable on the clipboard.
Source Image
—
Paste Clipboard
Paste the current clipboard contents into the frontmost application.
—
—
Text
Insert Text
Insert custom text and values from Variables into the frontmost application.
Text
—
Get Selected Text
Read selected text from the frontmost application. Some applications may briefly use the clipboard.
—
Selected Text
Transform TextPRO
Apply a selected transformation to custom text or a Variable and make the result available to later steps.
TextTransform
Text Result
Translate Text
Translate text into a selected language using macOS System Translate.
TextTarget Language
Translated Text
Files
Open File or Folder
Open a file or folder with the default application, a selected application, or an Application Variable.
File or FolderOpen With
—
Reveal File or Folder in Finder
Reveal a file or folder in its containing Finder folder without opening the item.
File or Folder
—
Read Text FilePRO
Read UTF-8 or BOM-marked UTF-16 text from an existing file. File extensions are not restricted. Binary files and unsupported encodings fail. Files larger than 1 MB also fail.
File
File Contents
Create Folder
Create a named folder inside a selected folder or Folder Variable.
Parent FolderNameIf the Name Already Exists
Created Folder
Create File
Create an empty named file inside a selected folder or Folder Variable.
Parent FolderNameIf the Name Already Exists
Created File
Write to FilePRO
Write custom text or a Text Variable to an existing file by replacing its contents or appending to the end.
FileTextWriting
Written File
Copy File
Copy one file into a selected destination folder without replacing an existing file.
FileDestination FolderIf the Name Already Exists
Copied File
Move File or FolderPRO
Move a file or folder into a selected destination folder.
File or FolderDestination FolderIf the Name Already Exists
Moved File or Folder
Rename File or FolderPRO
Rename a file or folder without changing its parent folder.
File or FolderNew NameIf the Name Already Exists
Renamed File or Folder
Trash File or FolderPRO
Move a selected file or folder to the system Trash.
File or Folder
—
Web and Network
Open URL
Open a URL, deep link, or custom URL scheme with the default or selected application.
URLOpen With
—
Download from URLPRO
Download a file from a URL to the selected folder, with optional progress and result notifications.
URLDestination FolderDownload StatusTimeoutStop this flow if unsuccessful
Download SucceededDownloaded File Path
Feedback
Show Notification
Show a macOS system notification when Rulr is not the frontmost application.
TitleMessagePlay Sound
—
Show Text or Image
Show text or an image in a Rulr panel without pausing the Rule.
Text or ImageKeep window on top
—
Ask for Input
Pause the Rule and ask the user for text or a number. The entered value is available to later Conditions and Actions.
TitleMessageStop this flow when cancelled
User InputUser InputContinued
Show ConfirmationPRO
Pause the Rule and ask the user to cancel or continue. The response is available to later Conditions and Actions.
TitleMessageStop this flow when cancelled
Continued
Speak TextPRO
Read text aloud using the installed macOS voice for the detected language.
Text
—
System Control
Set Volume
Set the system volume from 0 to 100 percent.
Volume
—
Mute or Unmute Audio
Mute or unmute system audio without changing the volume level.
—
—
Switch Audio Output Device
Switch macOS audio and system sounds to an available output device.
Audio Output Device
—
Set System Appearance
Set macOS appearance to Light or Dark.
Appearance
—
Lock Screen
Lock the current user session.
—
—
Start Screen Saver
Start the screen saver without locking the current user session.
—
—
Switch Input Method
Switch the active keyboard input method.
Input Source
—
Type Text or Press KeysPRO
Type text or press configured keys and keyboard shortcuts in order.
Input
—
Move MousePRO
Move the pointer to a position on a screen or in a window.
Position
—
Click MousePRO
Click the current pointer location without moving the pointer.
Mouse ButtonClickHeld Keys
—
Scroll ContentPRO
Scroll content at the current pointer location.
DirectionDistance
—
Put Mac to Sleep
Put the Mac to sleep.
—
—
Restart Mac
Restart the Mac.
—
—
Shut Down Mac
Shut down the Mac.
—
—
Desktops
Switch to Desktop
Switch to a numbered Desktop (Space) on the active display. Mission Control appears briefly.
Desktop Number
—
Show or Hide Mission Control
Show Mission Control, or hide it when it is already visible.
—
—
Show or Hide Desktop
Show the desktop, or restore the previous window layout when the desktop is already visible.
—
—
Create DesktopPRO
Create a Desktop (Space) at the end of the active display without switching to it. Mission Control appears briefly.
—
—
Remove DesktopPRO
Remove a numbered Desktop (Space) from the active display. macOS moves its windows to another Desktop (Space).
Desktop Number
—
Images and Screen Capture
Capture Screen or Window
Capture a selected screen, area, or window.
Capture Target
Cached Screenshot File Path
Recognize Text on Screen
Use OCR to capture and recognize text on a selected screen, area, or window.
Capture Target
OCR Text
Recognize Text in ImagePRO
Use OCR to recognize text in an image file, the first matching image in a folder, or an Image Variable.
Source Image
OCR Text
Resize ImagePRO
Resize an image from a file, a folder's first matching image, or an Image Variable while preserving its aspect ratio and format.
Source ImageResize
Resized Image File Path
Crop ImagePRO
Crop a pixel region from an image file, a folder's first matching image, or an Image Variable.
Source ImagePositionSize
Cropped Image File Path
Convert ImagePRO
Convert an image from a file, a folder's first matching image, or an Image Variable to PNG, JPEG, HEIC, or TIFF without changing its dimensions.
Source ImageFormat
Converted Image File Path
Get Color Under Pointer
Read the color under the pointer as HEX or RGB text.
Format
Color
App Integrations
Google Chrome
Show Window and Tab Manager
Show a searchable manager to create, switch, reload, or close Google Chrome windows and tabs.
—
Google Chrome Active Tab TitleGoogle Chrome Active Tab URL
Open New Tab
Open a new Google Chrome tab, optionally with a URL.
URL
—
Navigate Current TabPRO
Open a URL in the active Google Chrome tab.
URL
—
Reload Current Tab
Reload the active tab in the current Google Chrome window.
—
—
Close Current Tab
Close the active tab in the current Google Chrome window.
—
—
Get Current TabPRO
Get the title and URL of the active Google Chrome tab without changing the selection.
—
Google Chrome Active Tab TitleGoogle Chrome Active Tab URL
Select Next Tab
Select the tab to the right in the current Google Chrome window, with wraparound.
—
Google Chrome Active Tab TitleGoogle Chrome Active Tab URL
Select Previous Tab
Select the tab to the left in the current Google Chrome window, with wraparound.
—
Google Chrome Active Tab TitleGoogle Chrome Active Tab URL
Open New Window
Open a Normal or Incognito Google Chrome window, optionally with a URL.
Window ModeURL
Google Chrome Window
Get Current WindowPRO
Get the front Google Chrome window without bringing Chrome forward.
—
Google Chrome WindowGoogle Chrome Window XGoogle Chrome Window YGoogle Chrome Window WidthGoogle Chrome Window HeightGoogle Chrome Active Tab TitleGoogle Chrome Active Tab URL
Switch to Next WindowPRO
Switch to the next Google Chrome window, wrapping to the first window.
—
Google Chrome WindowGoogle Chrome Active Tab TitleGoogle Chrome Active Tab URL
Switch to Previous WindowPRO
Switch to the previous Google Chrome window, wrapping to the last window.
—
Google Chrome WindowGoogle Chrome Active Tab TitleGoogle Chrome Active Tab URL
Close Current Window
Close the current Google Chrome window without activating Chrome.
—
—
Run JavaScript in TabPRO
Run JavaScript in the active Google Chrome tab and make its result available to later steps.
JavaScriptTimeout
Script Result
Safari
Show Window and Tab Manager
Show a searchable manager to create, switch, reload, or close Safari windows and tabs.
—
Safari Active Tab TitleSafari Active Tab URL
Open New Tab
Open a new Safari tab, optionally with a URL.
URL
—
Navigate Current TabPRO
Open a URL in the active Safari tab.
URL
—
Reload Current Tab
Reload the active tab in the current Safari window.
—
—
Close Current Tab
Close the active tab in the current Safari window.
—
—
Get Current TabPRO
Get the title and URL of the active Safari tab without changing the selection.
—
Safari Active Tab TitleSafari Active Tab URL
Select Next Tab
Select the tab to the right in the current Safari window, with wraparound.
—
Safari Active Tab TitleSafari Active Tab URL
Select Previous Tab
Select the tab to the left in the current Safari window, with wraparound.
—
Safari Active Tab TitleSafari Active Tab URL
Open New Window
Open a new Safari window, optionally with a URL.
URL
Safari Window
Get Current WindowPRO
Get the front Safari window without bringing Safari forward.
—
Safari WindowSafari Window XSafari Window YSafari Window WidthSafari Window HeightSafari Active Tab TitleSafari Active Tab URL
Switch to Next WindowPRO
Switch to the next Safari window, wrapping to the first window.
—
Safari WindowSafari Active Tab TitleSafari Active Tab URL
Switch to Previous WindowPRO
Switch to the previous Safari window, wrapping to the last window.
—
Safari WindowSafari Active Tab TitleSafari Active Tab URL
Close Current Window
Close the current Safari window without activating Safari.
—
—
Run JavaScript in TabPRO
Run JavaScript in the active Safari tab and make its result available to later steps.
JavaScriptTimeout
Script Result
Variables
Set Custom Variable
Save a named Text, Number, Boolean, Date, Time, Application, or Image value for later steps in the current Rule branch.
NameTypeValue to Store
—
Flow Control
Delay
Pause the current Rule execution before continuing.
DurationUnit
—
Wait Until
Pause the current Rule until the selected Common Variable matches a condition or the timeout expires.
What to watchWhen to continueTimeout
—
Stop RulePRO
Stop all active executions of the current or selected Rule without disabling it.
Rule
—
Enable RulePRO
Enable the selected Rule so its Triggers can start future executions.
Rule
—
Disable RulePRO
Disable the selected Rule so its Triggers cannot start future executions.
Rule
—
Scripting
Run Shortcut
Run an Apple Shortcut and make its text result available to later steps.
ShortcutTimeout
Shortcut Result
Edit Shortcut
Open an Apple Shortcut in the Shortcuts editor.
Shortcut
—
Run AppleScript
Run an AppleScript, optionally stopping this flow if unsuccessful.
ScriptArgumentTimeoutStop this flow if unsuccessful
SucceededScript Result
Run Shell ScriptPRO
Run a shell script, optionally stopping this flow if unsuccessful.
ScriptArgumentTimeoutStop this flow if unsuccessful
SucceededScript Result