Start
The Beginning of Every Automation Process
The Start node is the entry point for every automation workflow. Without this node, the script cannot be executed.
Types of Start Methods:
Manual Start: Manually trigger the process by clicking the Start node (▶️).
Parameters
You can configure parameters for users to input when running the script through a profile by clicking Parameters and then clicking Add parameter.
Parameter Configuration
Name The variable name to be used in the workflow.
Label The display name of the parameter when running through a profile.
Type The input format of the parameter. There are 5 types:
Checkbox: A checkmark box. The value will be boolean.
File Path: Accepts input by specifying the file path. A Browse file button will appear to open the desired file location. The file path will be stored as a String.
Input (JSON): Accepts input in JSON format. The input field will change to a Text area.
Input (Number): Accepts numeric input. Only Number values are allowed. If left blank, the default value will be 0.
Input (String): Accepts String input. All entered values will be treated as text.
Placeholder A hint message for the input field. It will appear as “grey text” in the Default value box.
Default value Sets the initial value for the parameter.
Options You can add a description for the input field and specify whether the parameter is required. If selected, the script cannot be run unless this field is filled.
Special Menus for Use with the GemAutomate Extension
Perform actions through the menu (right-click). When a process runs through the menu, certain variables will be passed into that process:
$ctxElSelector: The selector of the element you right-clicked$ctxTextSelection: The selected text$ctxMediaUrl: The media source URL (image, video, or audio)$ctxLink: The URL if you right-clicked a link
To use this trigger, you must grant GemAutomate permission to access the context menu. This trigger has two options:
Process name in the menu: Appears in the context menu as configured
When the process appears in the menu: If no options are selected, it will always appear when the context menu is shown
When Visiting a Website
Execute the process when you access a website that matches the specified URL or ReGex. If you check the "Use regex" box the value you enter will be treated as a ReGex pattern.
Shortcuts
Run the process using a shortcut key. You can assign a shortcut by clicking the record button (⏺️) and pressing the desired key.
By default, the shortcut will not work when the cursor is inside an input element. To prevent this behavior, you can check the box “Run while typing”
Note:
Shortcuts will only work on websites.
If the website URL starts with chrome:// or chrome-extension:// shortcuts will not function.
Last updated