%%%%
**⚠️ v4.0 UI Transition Notice - In Process:**
//The release of Total Launcher v4.0 has introduced significant user interface changes. Please note that this
page does not yet reflect these updates. The new layout paths, folds, and visual maps are currently being
compiled and will be deployed shortly.//
%%%%
----
====== 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).
Toby Lancer says {{:ui:ui-icon_megaphone-32-v4.webp?direct|Megaphone}} Power Tips: Design Guidelines
• **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.
===== 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:
* [[section:section-actions|Understanding Actions and Triggers]]