ScriptTap
Delay Until

Command video guide

Delay Until

Wait until a clock time or a condition is reached before running the next command. This guide explains Time, Image, UI Element, Pixel, Variable, and Active App, then demonstrates Active App with Google Play.

For Image, UI Element and Pixel setups, refer to the ImgFind(), UIFind() and PixelFind() command guides.

The demo waits for Google Play, uses Delay 2000 ms for opening, then taps Search, focuses the search bar and types ScriptTap. Two additional one-second Delays let the Search tab and text field settle on this device. Match coordinates and timing to your own device.

Watch the walkthrough

Step-by-step guide

  1. Step 01

    Delay Until pauses your script until a chosen time or condition is reached. Use it when the next action depends on something being ready, rather than a fixed amount of time passing.

    Delay Until step 1: Delay Until pauses your script until a chosen time or condition is reached. Use it when the next action depends on something being ready, rather than a fixed amount of time passing.
  2. Step 02

    Open Scripts. Tap New Script, then choose Blank Script.

    Delay Until step 2: Open Scripts. Tap New Script, then choose Blank Script.
  3. Step 03

    Open its three-dot menu and choose Rename. Pick a name, then tap OK.

    Delay Until step 3: Open its three-dot menu and choose Rename. Pick a name, then tap OK.
  4. Step 04

    Select your new script and open the Script Editor. Collapse the extra overlay controls.

    Delay Until step 4: Select your new script and open the Script Editor. Collapse the extra overlay controls.
  5. Step 05

    Expand Timing and drag Delay Until into the script. Double-tap its frame to open the settings.

    Delay Until step 5: Expand Timing and drag Delay Until into the script. Double-tap its frame to open the settings.
  6. Step 06

    Time waits for a clock time on your device. Enter the hour, minute, and second. Use AM or PM, or turn on twenty-four-hour time. Without a date, a time that has already passed waits until tomorrow.

    Delay Until step 6: Time waits for a clock time on your device. Enter the hour, minute, and second. Use AM or PM, or turn on twenty-four-hour time. Without a date, a time that has already passed waits until tomorrow.
  7. Step 07

    Turn on Date to choose a specific month, day, and year as well. Use a valid calendar date. If that dated time has already passed, the command continues immediately.

    Delay Until step 7: Turn on Date to choose a specific month, day, and year as well. Use a valid calendar date. If that dated time has already passed, the command continues immediately.
  8. Step 08

    Image waits until a saved image appears inside the selected screen area. Choose at least one image asset, the search area, and the match confidence. It waits for a match; it does not tap the image.

    Delay Until step 8: Image waits until a saved image appears inside the selected screen area. Choose at least one image asset, the search area, and the match confidence. It waits for a match; it does not tap the image.
  9. Step 09

    UI Element waits until an app exposes a matching accessibility element. You can match text or another element property, choose Exact, Contains, or Regex, and narrow the result with an occurrence number, package, and element filters. This is not OCR.

    Delay Until step 9: UI Element waits until an app exposes a matching accessibility element. You can match text or another element property, choose Exact, Contains, or Regex, and narrow the result with an occurrence number, package, and element filters. This is not OCR.
  10. Step 10

    Pixel waits until the color at one screen coordinate matches your target. Set the X and Y position, a Hex color or an earlier Hex variable, and the confidence.

    Delay Until step 10: Pixel waits until the color at one screen coordinate matches your target. Set the X and Y position, a Hex color or an earlier Hex variable, and the confidence.
  11. Step 11

    For image, pixel, and UI element setup details, refer to the Image Find, Pixel Find, and UI Find command guides.

    Delay Until step 11: For image, pixel, and UI element setup details, refer to the Image Find, Pixel Find, and UI Find command guides.
  12. Step 12

    Variable waits for a condition on a variable defined earlier in the script. Choose its name, value type, and the comparison target. The supported types are Boolean, Integer, Decimal, String, Hex, and Time.

    Delay Until step 12: Variable waits for a condition on a variable defined earlier in the script. Choose its name, value type, and the comparison target. The supported types are Boolean, Integer, Decimal, String, Hex, and Time.
  13. Step 13

    Boolean and Hex use equality. Integer, Decimal, and Time also support not equal, greater than, less than, and their inclusive comparisons. Choose the comparison that must become true.

    Delay Until step 13: Boolean and Hex use equality. Integer, Decimal, and Time also support not equal, greater than, less than, and their inclusive comparisons. Choose the comparison that must become true.
  14. Step 14

    For String values, Exact matches the whole text, Contains looks for part of it, and Regex uses a pattern. Delay Until only checks the condition. It does not change the variable or execute the commands that follow while it is waiting.

    Delay Until step 14: For String values, Exact matches the whole text, Contains looks for part of it, and Regex uses a pattern. Delay Until only checks the condition. It does not change the variable or execute the commands that follow while it is waiting.
  15. Step 15

    Every mode except Time has Check Every, in milliseconds. This controls the pause between checks, not a maximum waiting time. Use a whole number from zero to sixty thousand. Zero adds no pause. Make sure the condition can become true, or use Stop to end the wait.

    Delay Until step 15: Every mode except Time has Check Every, in milliseconds. This controls the pause between checks, not a maximum waiting time. Use a whole number from zero to sixty thousand. Zero adds no pause. Make sure the condition can become true, or use Stop to end the wait.
  16. Step 16

    In this demo, we will be using Active App. This mode waits until a specific app becomes active before continuing to the next command. It does not open the app for you. Switching modes clears the settings for the mode you leave.

    Delay Until step 16: In this demo, we will be using Active App. This mode waits until a specific app becomes active before continuing to the next command. It does not open the app for you. Switching modes clears the settings for the mode you leave.
  17. Step 17

    Tap Select app and choose Google Play. The picker fills its package and label. The package identifies the app; the label is its readable name.

    Delay Until step 17: Tap Select app and choose Google Play. The picker fills its package and label. The package identifies the app; the label is its readable name.
  18. Step 18

    Set Check Every to two hundred milliseconds, then tap OK to save.

    Delay Until step 18: Set Check Every to two hundred milliseconds, then tap OK to save.
  19. Step 19

    Drag Delay below Delay Until. Double-tap it and enter two thousand milliseconds. This gives Google Play two seconds to finish opening after it becomes active.

    Delay Until step 19: Drag Delay below Delay Until. Double-tap it and enter two thousand milliseconds. This gives Google Play two seconds to finish opening after it becomes active.
  20. Step 20

    Expand Actions and drag a Tap below Delay. Double-tap its frame and enter the coordinates of Google Play's Search icon at the bottom. Tap OK to save.

    Delay Until step 20: Expand Actions and drag a Tap below Delay. Double-tap its frame and enter the coordinates of Google Play's Search icon at the bottom. Tap OK to save.
  21. Step 21

    Drag another Tap below it. Set this one to the search bar at the top, then tap OK. Use coordinates that match your own device layout.

    Delay Until step 21: Drag another Tap below it. Set this one to the search bar at the top, then tap OK. Use coordinates that match your own device layout.
  22. Step 22

    Drag a Delay between the two taps and set it to one thousand milliseconds. This gives the Search tab time to appear before the next tap.

    Delay Until step 22: Drag a Delay between the two taps and set it to one thousand milliseconds. This gives the Search tab time to appear before the next tap.
  23. Step 23

    Add one more Delay after the second tap, also set to one thousand milliseconds. This lets the search field gain focus before Text Type runs.

    Delay Until step 23: Add one more Delay after the second tap, also set to one thousand milliseconds. This lets the search field gain focus before Text Type runs.
  24. Step 24

    Drag Text Type below the final delay. Enter ScriptTap for this example and leave Use Variable off. Tap OK to save. This types the search text into the focused field.

    Delay Until step 24: Drag Text Type below the final delay. Enter ScriptTap for this example and leave Use Variable off. Tap OK to save. This types the search text into the focused field.
  25. Step 25

    The sequence waits for Google Play, gives it two seconds to open, then uses two taps and short pauses to reach the search field and type ScriptTap. Delay Until keeps the later commands from running before the right app is active.

    Delay Until step 25: The sequence waits for Google Play, gives it two seconds to open, then uses two taps and short pauses to reach the search field and type ScriptTap. Delay Until keeps the later commands from running before the right app is active.
  26. Step 26

    Close the editor. When the script is complete, simply use the Play button in the main overlay.

    Delay Until step 26: Close the editor. When the script is complete, simply use the Play button in the main overlay.
  27. Step 27

    Google Play is not active yet, so the script waits here. Now open Google Play. Once it becomes active, the script continues.

    Delay Until step 27: Google Play is not active yet, so the script waits here. Now open Google Play. Once it becomes active, the script continues.
  28. Step 28

    After the wait, the script opens Search, focuses its search bar, and types ScriptTap. The completed search text is the visible result. The script stops automatically.

    Delay Until step 28: After the wait, the script opens Search, focuses its search bar, and types ScriptTap. The completed search text is the visible result. The script stops automatically.

Back to Commands