Using the App

繁體中文：Using-the-App-zh-TW

Using the App

The sidebar switches between three pages: Rules (rule list + engine start/stop), Activity (live event log), and Settings (language, app version, Help).

Creating a rule

Click New Rule to open the 3-step editor:

1. Trigger — "Image (template)" or "Pixel colour". For an image trigger, choose the source: Select Region on Screen (drag a box; the desktop dims except the area you're selecting) or Browse for Image File (pick an existing image from disk). A screen-cropped region can optionally check Scan the whole screen to match the target anywhere rather than just where it was captured; an uploaded file always scans the whole screen. Use Test Match to confirm detection before saving.
2. Action — click, double-click, key press, typed text, or Macro (multi-step) — see Macros.
3. Safety — name, an optional trigger limit, dry-run, and either a cooldown (minimum time between triggers) or Only trigger once until it disappears and reappears — for a rule that should fire the instant its target shows up, with no cooldown or count/order settings to think about.

New rules always start in dry-run — flip the checkbox off in the rule list's toggle once you trust it. Drag rule cards by the handle to reorder them (rules are scanned in list order).

Managing rules

• Edit reopens the same 3-step editor pre-filled with that rule's current settings; save updates it in place instead of creating a duplicate.
• Delete All in the rule list header clears every rule at once (with a confirmation prompt).
• Batch Upload turns a folder of reference images into one rule per image in one go: pick several image files at once and each gets its own rule (template trigger, whole-screen scan, click action, dry-run), named with a plain sequential number ("1", "2", ...) that continues after whatever numbers are already in use so it never collides with existing rules. Rename any of them afterward with Edit — the numbers are just a starting point.

Help panel

The Help button on the Settings page opens the in-app manual, user notice, terms of service, disclaimer, and privacy policy, each available in English and 繁體中文 via the language switcher (also on the Settings page).