Script Window

Run and manage scripts and use specialized development tools for Android automation, FindNode, REST API testing, and structured test execution.

Script Window

Total Control Script Window Total Control Capture Replay Total Control Image Helper Total Control Color Helper Total Control UI-Explorer Total Control Rest Tool Total Control Test Excution Total Control Sigma Listener

The Script Window provides Total Control's scripting, automation, testing, and development tools. It includes tools for running and managing scripts as well as specialized utilities for creating, inspecting, and testing automation.

Tools

  • Capture/Replay — Records device operations such as clicks, swipes and delays into a coordinate-based action list that can be reviewed, edited, saved and replayed. Earlier versions also used recorded actions as a way to generate scripts.
  • Create SCP — Packages one or more scripts into an SCP container. Source code can be shortened/processed, obfuscated and encrypted before packaging, and the protected scripts are decrypted when loaded for execution rather than being written back as normal source files. SCP files can also be loaded through the JavaScript require() mechanism.
  • Image Helper — Captures an image from the main device and creates an extended BMP containing additional information such as coordinates, package name, activity name, screen dimensions and similarity settings for use with seekImage(). This is primarily a legacy coordinate/image-based automation tool and is rarely needed for newer FindNode-based scripts.
  • Color Helper — Helps identify one or more colors and their screen locations to build parameters for color-based automation such as seekColor(). It is mainly useful for older coordinate/color-based scripts and is rarely required for modern FindNode automation.
  • UI Explorer — Inspects the Android Accessibility UI structure and helps users identify UI elements and construct FindNode queries. UI Explorer is one of the primary development tools for FindNode-based automation and is actively maintained.
  • REST Tool — Provides an interactive environment for exploring and testing the Total Control REST API. It assists with authentication, device selection, API functions and parameters, sends REST requests, and displays the returned results.
  • Test Execution — Runs XML-based test harnesses and test suites using configurable devices, test selections, iterations and report output. It is intended for structured automated testing rather than normal script execution.
  • Global Listener — Provides a centralized interface for creating and managing event listeners and their callback code, making listeners easier to review and maintain than defining them individually throughout scripts.

Script Files / Quick Run

The main Tools page displays the configured script directory and provides quick access to JavaScript source files.

  • Default Editor — Configures the editor used to open script files.
  • Script Path — Defines the primary script directory used by Total Control. Quick Run and multiple scripting APIs use this path to locate script files and related resources, including files such as Userlib.js.
  • Quick Run — Lists scripts and folders in the current Script Path for convenient access and execution.
  • Run — Immediately executes the selected script.
  • Edit — Opens the selected script using the configured editor.
  • Delete — Removes the selected script.
TCHelp