====== Resource: Sequence ======

Sequence is a powerful automation feature that allows users to string together multiple actions and execute them simultaneously or in a specific chain with a single trigger. Rather than being restricted to mapping a single action, such as launching an app or opening a drawer to a gesture or a button tap, sequences act as a macro builder. Through the launcher's settings, bundle diverse operations like:
  * Opening multiple layout windows at once.
  * Triggering device setting adjustments (like lowering brightness or changing volume levels).
  * Launching a specific application.

... all under one unified command. It serves as a lightweight, built-in alternative to complex external automation tools, bridging the gap between static interface design and dynamic user interaction.

Integrating sequences into a setup design unlocks a new layer of efficiency and minimalism. For example, a dedicated "Bedtime" graphic button or swipe gesture can instantly lock the screen, set the media volume to zero, and open a blue-light-filtered e-reading app. Alternatively, power users often integrate sequences to fix or bypass complex layout behaviors, such as tying custom window-management actions together or seamlessly launching a specific app search-drawer layout. The primary benefits received are a cleaner, less cluttered interface and reduced friction in daily workflow. By automating repetitive multi-tap tasks into a single gesture or icon tap, sequences transform a Total Launcher setup from a merely aesthetic layout into a highly responsive, personalized dashboard that anticipates and adapts to immediate needs.

===== Sequence Management =====
Manage sequences through the Launcher behavior options or when assigning a new action to an object.
  * **Add Sequence:** - Create a new macro string by selecting the plus (+) icon.
  * **Add Action:** - Select the specific Launcher command or task to include in the macro.
  * **Add Delay:** - Insert a timing pause between actions.
  * **Rename:** - Assign a unique identifier to the sequence to ensure clarity when assigning actions.
  * **Delete:** - Remove a sequence by long-pressing the sequence name or selecting the delete icon.

===== Steps and Timing Logic =====
Each sequence is comprised of individual action steps and timing delays. Calculate each delay duration in milliseconds (ms). Note: ''1000'' ms is equal to ''1'' second.

[Visual Placeholder: Screenshot of the Sequence Editor showing Action and Delay fields]

  * **Timing Reference Table:**
    - ''100'' ms: Immediate (Fastest feedback).
    - ''200'' ms - ''300'' ms: Standard (Recommended for most UI actions).
    - ''500'' ms: Focused (Visible pause).
    - ''1000'' ms: Slow (Used for long delays).
  * **Simultaneous Execution (Parallel):** - List multiple actions consecutively without adding a delay step to trigger them at the same time.
  * **Chaining Steps (One after another):** - Insert a delay step between actions to stagger execution.
    - Action: ''Launch App''.
    - Delay: ''500'' ms.
    - Action: ''Close Window''.

===== Execution and Triggers =====
Sequences remain inactive until called by an action trigger.
  * **Manual Triggers:** - Assign the ''Sequence'' action to a ''Tap'', ''Long Press'', or ''Swipe'' event in the object's action menu.
  * **Variable Triggers:** - Sequences can be programmed to begin when a specific variable state is reached (e.g., via a Tasker command or shortcut integration).

<WRAP toby round 80%>
<WRAP centeralign>Toby Lancer says {{:ui:ui-icon_megaphone-32-v4.webp?direct|Megaphone}}  Power Tips: Design Guidelines</WRAP>

• **The 300ms Rule:** - For a responsive feel, keep most action delays between ''200'' ms and ''300'' ms.

• **Window Management:** - Use a sequence to automatically close background windows when launching an app, ensuring a clean home screen upon return.

• **System Toggles:** - Combine device settings like Wi-Fi, screen rotation, and brightness adjustments into a single sequence for contextual scenarios like driving or reading.
</WRAP>
===== Step-by-Step Examples =====
  * **Example: App Launch with Auto-Cleanup**
    - Step 1: Action ''Launch App'' (Select preferred application).
    - Step 2: Delay of ''300'' ms.
    - Step 3: Action ''Close Window'' (Target background folder or window).
    - Result: The application launches, and the originating window automatically closes, maintaining a clean layout upon return.

[Visual Placeholder: GIF of an app launching and window closing simultaneously]

===== Suggested Next Steps =====
To learn how to trigger the sequences created, proceed to the following section:
  * [[:ui:ui-option-action_tap|Object Actions interactive]]