System triggers

Clipboard changed

Runs when the text you copied (Ctrl+C) changes. You must switch on "Watch clipboard" on the Hotkeys page first, or it never runs.

Setting	What to put in
Text contains	Only run when the copied text has this in it, like "https://". Empty means any copied text.

Variables you get

Variable	What it holds
%clipboardText%	The text that was just copied

Type id: desktop.clipboardChanged

File changed

Runs when a file in a folder you watch is changed. You set up what to watch on the Watchers page. Good for reacting to a text file another program writes.

Setting	What to put in
Watcher	The name of a folder watcher from the Watchers page. Empty means every watcher.

Variables you get

Variable	What it holds
%fileName%	The file's name, like "score.txt"
%filePath%	The full location of the file on your computer
%folder%	The folder the file is in
%fileSize%	How big the file is, in bytes (small text files only)
%lineCount%	How many lines the file has (small text files only)
%line0%	The first line of the file (line1 is the second, and so on)
%watcherName%	The name of the watcher that noticed

Type id: core.fileChanged

File created

Runs when a new file appears in a folder you watch. You set up what to watch on the Watchers page. Good for reacting to a new screenshot or recording.

Setting	What to put in
Watcher	The name of a folder watcher from the Watchers page. Empty means every watcher.

Variables you get

Variable	What it holds
%fileName%	The new file's name, like "clip.mp4"
%filePath%	The full location of the file on your computer
%folder%	The folder the file is in
%watcherName%	The name of the watcher that noticed

Type id: core.fileCreated

File deleted

Runs when a file is deleted from a folder you watch. You set up what to watch on the Watchers page.

Setting	What to put in
Watcher	The name of a folder watcher from the Watchers page. Empty means every watcher.

Variables you get

Variable	What it holds
%fileName%	The deleted file's name
%filePath%	The full location the file had
%folder%	The folder the file was in
%watcherName%	The name of the watcher that noticed

Type id: core.fileDeleted

File renamed

Runs when a file in a folder you watch gets a new name. You set up what to watch on the Watchers page.

Setting	What to put in
Watcher	The name of a folder watcher from the Watchers page. Empty means every watcher.

Variables you get

Variable	What it holds
%fileName%	The new name of the file
%oldFileName%	The name it had before
%filePath%	The full new location of the file
%oldFilePath%	The full old location of the file
%watcherName%	The name of the watcher that noticed

Type id: core.fileRenamed

File tail line

Runs for each new line that a program adds to the end of a text file you follow, like a game's log. You choose the file on the Watchers page.

Setting	What to put in
Watcher	The name of a file tail from the Watchers page. Empty means every file tail.

Variables you get

Variable	What it holds
%line%	The new line of text
%fileName%	The name of the file
%filePath%	The full location of the file
%watcherName%	The name of the file tail that noticed

Type id: core.fileTailLine

Hotkey pressed

Runs when you press a keyboard shortcut. You make shortcuts on the Hotkeys page, or you can type a combination like Ctrl+Shift+F1 here.

Setting	What to put in
Hotkey	A hotkey name from the Hotkeys page, or keys like "Ctrl+Shift+F1". Empty means any hotkey.

Variables you get

Variable	What it holds
%hotkeyName%	The name of the hotkey from the Hotkeys page
%hotkey%	The keys that were pressed, like Ctrl+Shift+F1
%key%	The main key, without Ctrl/Alt/Shift
%hasCtrl%	True if Ctrl was held
%hasAlt%	True if Alt was held
%hasShift%	True if Shift was held

Type id: hotkeys.pressed

Mouse click

Runs when you click a mouse button anywhere on your computer. It does not work on Wayland (a Linux desktop type), because that blocks other programs from seeing clicks.

Setting	What to put in
Button	Which mouse button counts. Any means all of them. X1 and X2 are the extra side buttons. Options: Any, Left, Right, Middle, X1, X2. Starts as: Left.
Modifier keys	Keys that must be held while clicking, like "Ctrl+Shift". Empty = does not matter. "None" = no key held. Otherwise exactly the keys you list.

Variables you get

Variable	What it holds
%mouseButton%	Which button was clicked, like Left
%mouseX%	How far from the left of the screen the click was, in pixels
%mouseY%	How far from the top of the screen the click was, in pixels
%modifiers%	Which keys were held during the click, like Ctrl+Shift

Type id: input.mouseClick

Process started

Runs when a program you watch starts on your computer, like your game. You choose which programs to watch on the Watchers page.

Setting	What to put in
Watcher	The name of a process watcher from the Watchers page. Empty means every process watcher.

Variables you get

Variable	What it holds
%processName%	The name of the program that started
%processId%	The number the computer gave this running program
%path%	The folder the program lives in (when Cuebot can find it)
%watcherName%	The name of the watcher that noticed

Type id: core.processStarted

Process stopped

Runs when a program you watch closes, like your game. You choose which programs to watch on the Watchers page.

Setting	What to put in
Watcher	The name of a process watcher from the Watchers page. Empty means every process watcher.

Variables you get

Variable	What it holds
%processName%	The name of the program that closed
%processId%	The number the computer had given this program
%watcherName%	The name of the watcher that noticed

Type id: core.processStopped

Toast notification clicked

Runs when you click a pop-up notification that Cuebot showed with "Show desktop notification". Handy for a notification that acts like a button.

Setting	What to put in
Notification id	The notification id you typed in "Show desktop notification", like "raid-alert". Empty means any notification.

Variables you get

Variable	What it holds
%toastId%	The id of the notification you clicked
%toastTitle%	The title shown on the notification
%toastMessage%	The message shown on the notification

Type id: desktop.toastActivated